Sessile - Billing Management Agent

Overview

Sessile is the Billing Management agent in the TKM AI Agency Platform, responsible for handling token purchases, usage tracking, and payment processing. It manages the platform's billing operations, including package management, usage monitoring, and payment integration with Stripe.

Directory Structure

Backend/Backoffice/Sessile/
├── data/                # Billing and usage data
├── sessile.py          # Main agent implementation
├── api_sessile.py      # FastAPI endpoints
├── tools.py            # Billing utilities
├── tools_schema.py     # Data models and schemas
└── test_sessile.py     # Unit tests

Main Components

SessileAgent Class

The core component that handles billing operations:

• Token package management
• Usage tracking
• Payment processing
• Subscription handling

Processing Pipeline

1. Token Management

   • Package creation
   • Token allocation
   • Usage tracking
   • Expiration handling

2. Payment Processing

   • Stripe integration
   • Payment validation
   • Transaction logging
   • Receipt generation

3. Usage Monitoring

   • Token consumption
   • Usage analytics
   • Quota management
   • Alert generation

Key Features

Token Management

• Package configuration
• Token allocation
• Usage tracking
• Expiration handling

Payment Processing

• Stripe integration
• Payment validation
• Transaction logging
• Receipt generation

Usage Monitoring

• Token consumption
• Usage analytics
• Quota management
• Alert generation

Subscription Management

• Plan configuration
• Subscription tracking
• Renewal processing
• Status updates

Integration

Database Connection

• SingleStore integration
• Transaction management
• History tracking
• Data archival

Payment Gateway

• Stripe integration
• Webhook handling
• Payment processing
• Error handling

Event System

• Purchase events
• Usage updates
• Payment notifications
• Alert triggers

Error Handling

Payment Errors

• Transaction failures
• Webhook validation
• Payment processing
• Refund handling

Recovery Mechanisms

• Transaction rollback
• Payment retry
• Error notification
• Status recovery

Integration with Other Agents

Core Dependencies

• Niger: Data persistence
• Barbatus: Authentication
• Lyra: Notifications
• Gulosa: Resource tracking

Optional Integration

• Alfari: Configuration
• Gigantea: Feedback processing
• Messor: Usage analytics