agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/billing/mcp/tools.js

@@ -0,0 +1,239 @@
+/**
+ * MCP Tools for Billing System
+ * Expose billing operations as MCP tools for Claude integration
+ */
+import { SubscriptionTier, BillingCycle, UsageMetric, CouponType } from '../types.js';
+export class BillingMCPTools {
+    billing;
+    tools = new Map();
+    constructor(billing) {
+        this.billing = billing;
+        this.registerTools();
+    }
+    registerTools() {
+        // Subscription tools
+        this.addTool({
+            name: 'billing_subscription_create',
+            description: 'Create a new subscription for a user',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    userId: { type: 'string', description: 'User ID' },
+                    tier: { type: 'string', enum: Object.values(SubscriptionTier) },
+                    billingCycle: { type: 'string', enum: Object.values(BillingCycle) },
+                    paymentMethodId: { type: 'string' },
+                    couponCode: { type: 'string', optional: true }
+                },
+                required: ['userId', 'tier', 'billingCycle', 'paymentMethodId']
+            },
+            handler: async (params) => {
+                return await this.billing.subscribe(params);
+            }
+        });
+        this.addTool({
+            name: 'billing_subscription_upgrade',
+            description: 'Upgrade a subscription to a higher tier',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' },
+                    newTier: { type: 'string', enum: Object.values(SubscriptionTier) }
+                },
+                required: ['subscriptionId', 'newTier']
+            },
+            handler: async (params) => {
+                return await this.billing.upgrade(params.subscriptionId, params.newTier);
+            }
+        });
+        this.addTool({
+            name: 'billing_subscription_cancel',
+            description: 'Cancel a subscription',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' },
+                    immediate: { type: 'boolean', optional: true, default: false }
+                },
+                required: ['subscriptionId']
+            },
+            handler: async (params) => {
+                return await this.billing.cancel(params.subscriptionId, params.immediate);
+            }
+        });
+        this.addTool({
+            name: 'billing_subscription_get',
+            description: 'Get subscription details',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' }
+                },
+                required: ['subscriptionId']
+            },
+            handler: async (params) => {
+                return await this.billing.subscriptions.getSubscription(params.subscriptionId);
+            }
+        });
+        // Usage tools
+        this.addTool({
+            name: 'billing_usage_record',
+            description: 'Record usage for a subscription',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' },
+                    userId: { type: 'string' },
+                    metric: { type: 'string', enum: Object.values(UsageMetric) },
+                    amount: { type: 'number' },
+                    unit: { type: 'string' }
+                },
+                required: ['subscriptionId', 'userId', 'metric', 'amount', 'unit']
+            },
+            handler: async (params) => {
+                await this.billing.recordUsage(params);
+                return { success: true };
+            }
+        });
+        this.addTool({
+            name: 'billing_usage_summary',
+            description: 'Get usage summary for a subscription',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' }
+                },
+                required: ['subscriptionId']
+            },
+            handler: async (params) => {
+                return await this.billing.getUsageSummary(params.subscriptionId);
+            }
+        });
+        this.addTool({
+            name: 'billing_quota_check',
+            description: 'Check if subscription is within quota',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    subscriptionId: { type: 'string' },
+                    metric: { type: 'string', enum: Object.values(UsageMetric) }
+                },
+                required: ['subscriptionId', 'metric']
+            },
+            handler: async (params) => {
+                const allowed = await this.billing.checkQuota(params.subscriptionId, params.metric);
+                return { allowed, metric: params.metric };
+            }
+        });
+        // Pricing tools
+        this.addTool({
+            name: 'billing_pricing_tiers',
+            description: 'List all pricing tiers',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            },
+            handler: async () => {
+                return this.billing.pricing.getAllTiers();
+            }
+        });
+        this.addTool({
+            name: 'billing_pricing_calculate',
+            description: 'Calculate price for a tier and cycle',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    tier: { type: 'string', enum: Object.values(SubscriptionTier) },
+                    cycle: { type: 'string', enum: ['monthly', 'yearly', 'quarterly'] }
+                },
+                required: ['tier', 'cycle']
+            },
+            handler: async (params) => {
+                const price = this.billing.pricing.calculatePrice(params.tier, params.cycle);
+                return { tier: params.tier, cycle: params.cycle, price };
+            }
+        });
+        // Coupon tools
+        this.addTool({
+            name: 'billing_coupon_create',
+            description: 'Create a new coupon',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string' },
+                    type: { type: 'string', enum: Object.values(CouponType) },
+                    value: { type: 'number' },
+                    description: { type: 'string', optional: true },
+                    maxRedemptions: { type: 'number', optional: true },
+                    validUntil: { type: 'string', optional: true }
+                },
+                required: ['code', 'type', 'value']
+            },
+            handler: async (params) => {
+                return await this.billing.coupons.createCoupon(params);
+            }
+        });
+        this.addTool({
+            name: 'billing_coupon_validate',
+            description: 'Validate a coupon code',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string' },
+                    tier: { type: 'string', enum: Object.values(SubscriptionTier) },
+                    amount: { type: 'number' }
+                },
+                required: ['code', 'tier', 'amount']
+            },
+            handler: async (params) => {
+                return await this.billing.coupons.validateCoupon(params.code, params.tier, params.amount);
+            }
+        });
+    }
+    addTool(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Get all tools for MCP registration
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get tool by name
+     */
+    getTool(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Execute a tool
+     */
+    async executeTool(name, params) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            throw new Error(`Tool not found: ${name}`);
+        }
+        return await tool.handler(params);
+    }
+}
+/**
+ * Create MCP tools for a billing system
+ */
+export function createBillingMCPTools(billing) {
+    return new BillingMCPTools(billing);
+}
+/**
+ * Export tools for fastMCP registration
+ */
+export function registerBillingTools(server, billing) {
+    const mcpTools = new BillingMCPTools(billing);
+    const tools = mcpTools.getAllTools();
+    tools.forEach(tool => {
+        server.addTool({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            handler: tool.handler
+        });
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/agentic-flow/src/billing/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../src/billing/mcp/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP Tools for Billing System\n * Expose billing operations as MCP tools for Claude integration\n */\n\nimport { BillingSystem } from '../index.js';\nimport { SubscriptionTier, BillingCycle, UsageMetric, CouponType } from '../types.js';\n\nexport interface MCPTool {\n  name: string;\n  description: string;\n  inputSchema: any;\n  handler: (params: any) => Promise<any>;\n}\n\nexport class BillingMCPTools {\n  private billing: BillingSystem;\n  private tools: Map<string, MCPTool> = new Map();\n\n  constructor(billing: BillingSystem) {\n    this.billing = billing;\n    this.registerTools();\n  }\n\n  private registerTools(): void {\n    // Subscription tools\n    this.addTool({\n      name: 'billing_subscription_create',\n      description: 'Create a new subscription for a user',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          userId: { type: 'string', description: 'User ID' },\n          tier: { type: 'string', enum: Object.values(SubscriptionTier) },\n          billingCycle: { type: 'string', enum: Object.values(BillingCycle) },\n          paymentMethodId: { type: 'string' },\n          couponCode: { type: 'string', optional: true }\n        },\n        required: ['userId', 'tier', 'billingCycle', 'paymentMethodId']\n      },\n      handler: async (params) => {\n        return await this.billing.subscribe(params);\n      }\n    });\n\n    this.addTool({\n      name: 'billing_subscription_upgrade',\n      description: 'Upgrade a subscription to a higher tier',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' },\n          newTier: { type: 'string', enum: Object.values(SubscriptionTier) }\n        },\n        required: ['subscriptionId', 'newTier']\n      },\n      handler: async (params) => {\n        return await this.billing.upgrade(params.subscriptionId, params.newTier);\n      }\n    });\n\n    this.addTool({\n      name: 'billing_subscription_cancel',\n      description: 'Cancel a subscription',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' },\n          immediate: { type: 'boolean', optional: true, default: false }\n        },\n        required: ['subscriptionId']\n      },\n      handler: async (params) => {\n        return await this.billing.cancel(params.subscriptionId, params.immediate);\n      }\n    });\n\n    this.addTool({\n      name: 'billing_subscription_get',\n      description: 'Get subscription details',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' }\n        },\n        required: ['subscriptionId']\n      },\n      handler: async (params) => {\n        return await this.billing.subscriptions.getSubscription(params.subscriptionId);\n      }\n    });\n\n    // Usage tools\n    this.addTool({\n      name: 'billing_usage_record',\n      description: 'Record usage for a subscription',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' },\n          userId: { type: 'string' },\n          metric: { type: 'string', enum: Object.values(UsageMetric) },\n          amount: { type: 'number' },\n          unit: { type: 'string' }\n        },\n        required: ['subscriptionId', 'userId', 'metric', 'amount', 'unit']\n      },\n      handler: async (params) => {\n        await this.billing.recordUsage(params);\n        return { success: true };\n      }\n    });\n\n    this.addTool({\n      name: 'billing_usage_summary',\n      description: 'Get usage summary for a subscription',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' }\n        },\n        required: ['subscriptionId']\n      },\n      handler: async (params) => {\n        return await this.billing.getUsageSummary(params.subscriptionId);\n      }\n    });\n\n    this.addTool({\n      name: 'billing_quota_check',\n      description: 'Check if subscription is within quota',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          subscriptionId: { type: 'string' },\n          metric: { type: 'string', enum: Object.values(UsageMetric) }\n        },\n        required: ['subscriptionId', 'metric']\n      },\n      handler: async (params) => {\n        const allowed = await this.billing.checkQuota(params.subscriptionId, params.metric);\n        return { allowed, metric: params.metric };\n      }\n    });\n\n    // Pricing tools\n    this.addTool({\n      name: 'billing_pricing_tiers',\n      description: 'List all pricing tiers',\n      inputSchema: {\n        type: 'object',\n        properties: {}\n      },\n      handler: async () => {\n        return this.billing.pricing.getAllTiers();\n      }\n    });\n\n    this.addTool({\n      name: 'billing_pricing_calculate',\n      description: 'Calculate price for a tier and cycle',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          tier: { type: 'string', enum: Object.values(SubscriptionTier) },\n          cycle: { type: 'string', enum: ['monthly', 'yearly', 'quarterly'] }\n        },\n        required: ['tier', 'cycle']\n      },\n      handler: async (params) => {\n        const price = this.billing.pricing.calculatePrice(params.tier, params.cycle);\n        return { tier: params.tier, cycle: params.cycle, price };\n      }\n    });\n\n    // Coupon tools\n    this.addTool({\n      name: 'billing_coupon_create',\n      description: 'Create a new coupon',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          code: { type: 'string' },\n          type: { type: 'string', enum: Object.values(CouponType) },\n          value: { type: 'number' },\n          description: { type: 'string', optional: true },\n          maxRedemptions: { type: 'number', optional: true },\n          validUntil: { type: 'string', optional: true }\n        },\n        required: ['code', 'type', 'value']\n      },\n      handler: async (params) => {\n        return await this.billing.coupons.createCoupon(params);\n      }\n    });\n\n    this.addTool({\n      name: 'billing_coupon_validate',\n      description: 'Validate a coupon code',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          code: { type: 'string' },\n          tier: { type: 'string', enum: Object.values(SubscriptionTier) },\n          amount: { type: 'number' }\n        },\n        required: ['code', 'tier', 'amount']\n      },\n      handler: async (params) => {\n        return await this.billing.coupons.validateCoupon(params.code, params.tier, params.amount);\n      }\n    });\n  }\n\n  private addTool(tool: MCPTool): void {\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Get all tools for MCP registration\n   */\n  getAllTools(): MCPTool[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get tool by name\n   */\n  getTool(name: string): MCPTool | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Execute a tool\n   */\n  async executeTool(name: string, params: any): Promise<any> {\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new Error(`Tool not found: ${name}`);\n    }\n\n    return await tool.handler(params);\n  }\n}\n\n/**\n * Create MCP tools for a billing system\n */\nexport function createBillingMCPTools(billing: BillingSystem): BillingMCPTools {\n  return new BillingMCPTools(billing);\n}\n\n/**\n * Export tools for fastMCP registration\n */\nexport function registerBillingTools(server: any, billing: BillingSystem): void {\n  const mcpTools = new BillingMCPTools(billing);\n  const tools = mcpTools.getAllTools();\n\n  tools.forEach(tool => {\n    server.addTool({\n      name: tool.name,\n      description: tool.description,\n      inputSchema: tool.inputSchema,\n      handler: tool.handler\n    });\n  });\n}\n"]}

package/dist/agentic-flow/src/billing/metering/engine.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Usage Metering Engine
+ * Real-time usage tracking and aggregation
+ */
+import { EventEmitter } from 'events';
+import { UsageRecord, UsageMetric, UsageSummary, UsageLimits, QuotaCheckResult, StorageAdapter } from '../types.js';
+export interface MeteringConfig {
+    enabled: boolean;
+    bufferSize: number;
+    flushInterval: number;
+    softLimitPercent: number;
+    hardLimitPercent: number;
+}
+export declare class MeteringEngine extends EventEmitter {
+    private config;
+    private storage;
+    private buffer;
+    private flushTimer?;
+    private usageCache;
+    constructor(storage: StorageAdapter, config?: Partial<MeteringConfig>);
+    /**
+     * Record a usage event
+     */
+    recordUsage(record: Omit<UsageRecord, 'id' | 'timestamp' | 'billingPeriod'>): Promise<void>;
+    /**
+     * Check if usage is within quota
+     */
+    checkQuota(subscriptionId: string, metric: UsageMetric, limits: UsageLimits): Promise<QuotaCheckResult>;
+    /**
+     * Get usage summary for a subscription
+     */
+    getUsageSummary(subscriptionId: string, limits: UsageLimits): Promise<UsageSummary>;
+    /**
+     * Get current usage for a metric
+     */
+    private getCurrentUsage;
+    /**
+     * Flush buffered records to storage
+     */
+    private flush;
+    /**
+     * Start automatic flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Stop the metering engine
+     */
+    stop(): Promise<void>;
+    /**
+     * Clear cache for a subscription
+     */
+    clearCache(subscriptionId?: string): void;
+    private getLimitForMetric;
+    private calculateOverageCost;
+    private getCurrentBillingPeriod;
+    private generateId;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/agentic-flow/src/billing/metering/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../src/billing/metering/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAEhB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,UAAU,CAAoD;gBAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAiBrE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BjG;;OAEG;IACG,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAiE5B;;OAEG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCzF;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,KAAK;IAgBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,UAAU,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzC,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,UAAU;CAGnB"}

package/dist/agentic-flow/src/billing/metering/engine.js

@@ -0,0 +1,260 @@
+/**
+ * Usage Metering Engine
+ * Real-time usage tracking and aggregation
+ */
+import { EventEmitter } from 'events';
+import { UsageMetric } from '../types.js';
+export class MeteringEngine extends EventEmitter {
+    config;
+    storage;
+    buffer = [];
+    flushTimer;
+    usageCache = new Map();
+    constructor(storage, config) {
+        super();
+        this.storage = storage;
+        this.config = {
+            enabled: true,
+            bufferSize: 100,
+            flushInterval: 5000, // 5 seconds
+            softLimitPercent: 80,
+            hardLimitPercent: 100,
+            ...config
+        };
+        if (this.config.enabled) {
+            this.startFlushTimer();
+        }
+    }
+    /**
+     * Record a usage event
+     */
+    async recordUsage(record) {
+        if (!this.config.enabled)
+            return;
+        const fullRecord = {
+            ...record,
+            id: this.generateId(),
+            timestamp: new Date(),
+            billingPeriod: this.getCurrentBillingPeriod()
+        };
+        // Update cache
+        const userMetrics = this.usageCache.get(record.subscriptionId) || new Map();
+        const current = userMetrics.get(record.metric) || 0;
+        userMetrics.set(record.metric, current + record.amount);
+        this.usageCache.set(record.subscriptionId, userMetrics);
+        // Buffer the record
+        this.buffer.push(fullRecord);
+        // Emit event
+        this.emit('usage.recorded', fullRecord);
+        // Flush if buffer is full
+        if (this.buffer.length >= this.config.bufferSize) {
+            await this.flush();
+        }
+    }
+    /**
+     * Check if usage is within quota
+     */
+    async checkQuota(subscriptionId, metric, limits) {
+        const current = await this.getCurrentUsage(subscriptionId, metric);
+        const limit = this.getLimitForMetric(metric, limits);
+        // Unlimited
+        if (limit === -1) {
+            return {
+                allowed: true,
+                metric,
+                current,
+                limit,
+                percentUsed: 0,
+                remaining: Infinity,
+                overage: 0
+            };
+        }
+        const percentUsed = (current / limit) * 100;
+        const remaining = Math.max(0, limit - current);
+        const overage = Math.max(0, current - limit);
+        // Check soft limit
+        if (percentUsed >= this.config.softLimitPercent && percentUsed < this.config.hardLimitPercent) {
+            this.emit('quota.warning', {
+                subscriptionId,
+                metric,
+                percentUsed,
+                current,
+                limit
+            });
+        }
+        // Check hard limit
+        if (percentUsed >= this.config.hardLimitPercent) {
+            this.emit('quota.exceeded', {
+                subscriptionId,
+                metric,
+                current,
+                limit,
+                overage
+            });
+            return {
+                allowed: false,
+                metric,
+                current,
+                limit,
+                percentUsed,
+                remaining,
+                overage,
+                warning: `Quota exceeded for ${metric}. Current: ${current}, Limit: ${limit}`
+            };
+        }
+        return {
+            allowed: true,
+            metric,
+            current,
+            limit,
+            percentUsed,
+            remaining,
+            overage
+        };
+    }
+    /**
+     * Get usage summary for a subscription
+     */
+    async getUsageSummary(subscriptionId, limits) {
+        const period = this.getCurrentBillingPeriod();
+        const metrics = new Map();
+        const percentUsed = new Map();
+        const overages = new Map();
+        // Get all metrics
+        const allMetrics = Object.values(UsageMetric);
+        for (const metric of allMetrics) {
+            const current = await this.getCurrentUsage(subscriptionId, metric);
+            const limit = this.getLimitForMetric(metric, limits);
+            metrics.set(metric, current);
+            if (limit !== -1) {
+                const percent = (current / limit) * 100;
+                percentUsed.set(metric, percent);
+                if (current > limit) {
+                    overages.set(metric, current - limit);
+                }
+            }
+        }
+        // Calculate estimated cost based on overages
+        const estimatedCost = this.calculateOverageCost(overages);
+        return {
+            subscriptionId,
+            userId: '', // Will be set by caller
+            period,
+            metrics,
+            limits,
+            percentUsed,
+            overages,
+            estimatedCost
+        };
+    }
+    /**
+     * Get current usage for a metric
+     */
+    async getCurrentUsage(subscriptionId, metric) {
+        // Check cache first
+        const cached = this.usageCache.get(subscriptionId)?.get(metric);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Query storage
+        const period = this.getCurrentBillingPeriod();
+        const records = await this.storage.getUsageRecords(subscriptionId, period);
+        const total = records
+            .filter(r => r.metric === metric)
+            .reduce((sum, r) => sum + r.amount, 0);
+        // Update cache
+        const userMetrics = this.usageCache.get(subscriptionId) || new Map();
+        userMetrics.set(metric, total);
+        this.usageCache.set(subscriptionId, userMetrics);
+        return total;
+    }
+    /**
+     * Flush buffered records to storage
+     */
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const records = [...this.buffer];
+        this.buffer = [];
+        try {
+            await Promise.all(records.map(r => this.storage.saveUsageRecord(r)));
+            this.emit('flush.success', { count: records.length });
+        }
+        catch (error) {
+            this.emit('flush.error', error);
+            // Re-add to buffer on error
+            this.buffer.unshift(...records);
+        }
+    }
+    /**
+     * Start automatic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush();
+        }, this.config.flushInterval);
+    }
+    /**
+     * Stop the metering engine
+     */
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        await this.flush();
+    }
+    /**
+     * Clear cache for a subscription
+     */
+    clearCache(subscriptionId) {
+        if (subscriptionId) {
+            this.usageCache.delete(subscriptionId);
+        }
+        else {
+            this.usageCache.clear();
+        }
+    }
+    getLimitForMetric(metric, limits) {
+        const metricToLimitMap = {
+            [UsageMetric.AgentHours]: 'maxAgentHours',
+            [UsageMetric.Deployments]: 'maxDeployments',
+            [UsageMetric.APIRequests]: 'maxAPIRequests',
+            [UsageMetric.StorageGB]: 'maxStorageGB',
+            [UsageMetric.SwarmSize]: 'maxSwarmSize',
+            [UsageMetric.GPUHours]: 'maxGPUHours',
+            [UsageMetric.BandwidthGB]: 'maxBandwidthGB',
+            [UsageMetric.ConcurrentJobs]: 'maxConcurrentJobs',
+            [UsageMetric.TeamMembers]: 'maxTeamMembers',
+            [UsageMetric.CustomDomains]: 'maxCustomDomains'
+        };
+        return limits[metricToLimitMap[metric]];
+    }
+    calculateOverageCost(overages) {
+        // Example overage rates (per unit)
+        const rates = {
+            [UsageMetric.AgentHours]: 0.50,
+            [UsageMetric.Deployments]: 5.00,
+            [UsageMetric.APIRequests]: 0.0001,
+            [UsageMetric.StorageGB]: 0.10,
+            [UsageMetric.SwarmSize]: 10.00,
+            [UsageMetric.GPUHours]: 2.00,
+            [UsageMetric.BandwidthGB]: 0.05,
+            [UsageMetric.ConcurrentJobs]: 5.00,
+            [UsageMetric.TeamMembers]: 15.00,
+            [UsageMetric.CustomDomains]: 10.00
+        };
+        let total = 0;
+        overages.forEach((amount, metric) => {
+            total += amount * (rates[metric] || 0);
+        });
+        return total;
+    }
+    getCurrentBillingPeriod() {
+        const now = new Date();
+        return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+    }
+    generateId() {
+        return `usage_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/agentic-flow/src/billing/metering/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../../src/billing/metering/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Usage Metering Engine\n * Real-time usage tracking and aggregation\n */\n\nimport { EventEmitter } from 'events';\nimport {\n  UsageRecord,\n  UsageMetric,\n  UsageSummary,\n  UsageLimits,\n  QuotaCheckResult,\n  BillingConfig,\n  StorageAdapter\n} from '../types.js';\n\nexport interface MeteringConfig {\n  enabled: boolean;\n  bufferSize: number;\n  flushInterval: number;\n  softLimitPercent: number;\n  hardLimitPercent: number;\n}\n\nexport class MeteringEngine extends EventEmitter {\n  private config: MeteringConfig;\n  private storage: StorageAdapter;\n  private buffer: UsageRecord[] = [];\n  private flushTimer?: NodeJS.Timeout;\n  private usageCache: Map<string, Map<UsageMetric, number>> = new Map();\n\n  constructor(storage: StorageAdapter, config?: Partial<MeteringConfig>) {\n    super();\n    this.storage = storage;\n    this.config = {\n      enabled: true,\n      bufferSize: 100,\n      flushInterval: 5000, // 5 seconds\n      softLimitPercent: 80,\n      hardLimitPercent: 100,\n      ...config\n    };\n\n    if (this.config.enabled) {\n      this.startFlushTimer();\n    }\n  }\n\n  /**\n   * Record a usage event\n   */\n  async recordUsage(record: Omit<UsageRecord, 'id' | 'timestamp' | 'billingPeriod'>): Promise<void> {\n    if (!this.config.enabled) return;\n\n    const fullRecord: UsageRecord = {\n      ...record,\n      id: this.generateId(),\n      timestamp: new Date(),\n      billingPeriod: this.getCurrentBillingPeriod()\n    };\n\n    // Update cache\n    const userMetrics = this.usageCache.get(record.subscriptionId) || new Map();\n    const current = userMetrics.get(record.metric) || 0;\n    userMetrics.set(record.metric, current + record.amount);\n    this.usageCache.set(record.subscriptionId, userMetrics);\n\n    // Buffer the record\n    this.buffer.push(fullRecord);\n\n    // Emit event\n    this.emit('usage.recorded', fullRecord);\n\n    // Flush if buffer is full\n    if (this.buffer.length >= this.config.bufferSize) {\n      await this.flush();\n    }\n  }\n\n  /**\n   * Check if usage is within quota\n   */\n  async checkQuota(\n    subscriptionId: string,\n    metric: UsageMetric,\n    limits: UsageLimits\n  ): Promise<QuotaCheckResult> {\n    const current = await this.getCurrentUsage(subscriptionId, metric);\n    const limit = this.getLimitForMetric(metric, limits);\n\n    // Unlimited\n    if (limit === -1) {\n      return {\n        allowed: true,\n        metric,\n        current,\n        limit,\n        percentUsed: 0,\n        remaining: Infinity,\n        overage: 0\n      };\n    }\n\n    const percentUsed = (current / limit) * 100;\n    const remaining = Math.max(0, limit - current);\n    const overage = Math.max(0, current - limit);\n\n    // Check soft limit\n    if (percentUsed >= this.config.softLimitPercent && percentUsed < this.config.hardLimitPercent) {\n      this.emit('quota.warning', {\n        subscriptionId,\n        metric,\n        percentUsed,\n        current,\n        limit\n      });\n    }\n\n    // Check hard limit\n    if (percentUsed >= this.config.hardLimitPercent) {\n      this.emit('quota.exceeded', {\n        subscriptionId,\n        metric,\n        current,\n        limit,\n        overage\n      });\n\n      return {\n        allowed: false,\n        metric,\n        current,\n        limit,\n        percentUsed,\n        remaining,\n        overage,\n        warning: `Quota exceeded for ${metric}. Current: ${current}, Limit: ${limit}`\n      };\n    }\n\n    return {\n      allowed: true,\n      metric,\n      current,\n      limit,\n      percentUsed,\n      remaining,\n      overage\n    };\n  }\n\n  /**\n   * Get usage summary for a subscription\n   */\n  async getUsageSummary(subscriptionId: string, limits: UsageLimits): Promise<UsageSummary> {\n    const period = this.getCurrentBillingPeriod();\n    const metrics = new Map<UsageMetric, number>();\n    const percentUsed = new Map<UsageMetric, number>();\n    const overages = new Map<UsageMetric, number>();\n\n    // Get all metrics\n    const allMetrics = Object.values(UsageMetric);\n\n    for (const metric of allMetrics) {\n      const current = await this.getCurrentUsage(subscriptionId, metric);\n      const limit = this.getLimitForMetric(metric, limits);\n\n      metrics.set(metric, current);\n\n      if (limit !== -1) {\n        const percent = (current / limit) * 100;\n        percentUsed.set(metric, percent);\n\n        if (current > limit) {\n          overages.set(metric, current - limit);\n        }\n      }\n    }\n\n    // Calculate estimated cost based on overages\n    const estimatedCost = this.calculateOverageCost(overages);\n\n    return {\n      subscriptionId,\n      userId: '', // Will be set by caller\n      period,\n      metrics,\n      limits,\n      percentUsed,\n      overages,\n      estimatedCost\n    };\n  }\n\n  /**\n   * Get current usage for a metric\n   */\n  private async getCurrentUsage(subscriptionId: string, metric: UsageMetric): Promise<number> {\n    // Check cache first\n    const cached = this.usageCache.get(subscriptionId)?.get(metric);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    // Query storage\n    const period = this.getCurrentBillingPeriod();\n    const records = await this.storage.getUsageRecords(subscriptionId, period);\n\n    const total = records\n      .filter(r => r.metric === metric)\n      .reduce((sum, r) => sum + r.amount, 0);\n\n    // Update cache\n    const userMetrics = this.usageCache.get(subscriptionId) || new Map();\n    userMetrics.set(metric, total);\n    this.usageCache.set(subscriptionId, userMetrics);\n\n    return total;\n  }\n\n  /**\n   * Flush buffered records to storage\n   */\n  private async flush(): Promise<void> {\n    if (this.buffer.length === 0) return;\n\n    const records = [...this.buffer];\n    this.buffer = [];\n\n    try {\n      await Promise.all(records.map(r => this.storage.saveUsageRecord(r)));\n      this.emit('flush.success', { count: records.length });\n    } catch (error) {\n      this.emit('flush.error', error);\n      // Re-add to buffer on error\n      this.buffer.unshift(...records);\n    }\n  }\n\n  /**\n   * Start automatic flush timer\n   */\n  private startFlushTimer(): void {\n    this.flushTimer = setInterval(() => {\n      this.flush();\n    }, this.config.flushInterval);\n  }\n\n  /**\n   * Stop the metering engine\n   */\n  async stop(): Promise<void> {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n    }\n    await this.flush();\n  }\n\n  /**\n   * Clear cache for a subscription\n   */\n  clearCache(subscriptionId?: string): void {\n    if (subscriptionId) {\n      this.usageCache.delete(subscriptionId);\n    } else {\n      this.usageCache.clear();\n    }\n  }\n\n  private getLimitForMetric(metric: UsageMetric, limits: UsageLimits): number {\n    const metricToLimitMap: Record<UsageMetric, keyof UsageLimits> = {\n      [UsageMetric.AgentHours]: 'maxAgentHours',\n      [UsageMetric.Deployments]: 'maxDeployments',\n      [UsageMetric.APIRequests]: 'maxAPIRequests',\n      [UsageMetric.StorageGB]: 'maxStorageGB',\n      [UsageMetric.SwarmSize]: 'maxSwarmSize',\n      [UsageMetric.GPUHours]: 'maxGPUHours',\n      [UsageMetric.BandwidthGB]: 'maxBandwidthGB',\n      [UsageMetric.ConcurrentJobs]: 'maxConcurrentJobs',\n      [UsageMetric.TeamMembers]: 'maxTeamMembers',\n      [UsageMetric.CustomDomains]: 'maxCustomDomains'\n    };\n\n    return limits[metricToLimitMap[metric]];\n  }\n\n  private calculateOverageCost(overages: Map<UsageMetric, number>): number {\n    // Example overage rates (per unit)\n    const rates: Record<UsageMetric, number> = {\n      [UsageMetric.AgentHours]: 0.50,\n      [UsageMetric.Deployments]: 5.00,\n      [UsageMetric.APIRequests]: 0.0001,\n      [UsageMetric.StorageGB]: 0.10,\n      [UsageMetric.SwarmSize]: 10.00,\n      [UsageMetric.GPUHours]: 2.00,\n      [UsageMetric.BandwidthGB]: 0.05,\n      [UsageMetric.ConcurrentJobs]: 5.00,\n      [UsageMetric.TeamMembers]: 15.00,\n      [UsageMetric.CustomDomains]: 10.00\n    };\n\n    let total = 0;\n    overages.forEach((amount, metric) => {\n      total += amount * (rates[metric] || 0);\n    });\n\n    return total;\n  }\n\n  private getCurrentBillingPeriod(): string {\n    const now = new Date();\n    return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;\n  }\n\n  private generateId(): string {\n    return `usage_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n  }\n}\n"]}