agentic-flow 3.0.0-alpha.2 → 3.0.0

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

@@ -1,239 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,260 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"]}