agentbill-sdk 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2a5d6d3184f1e30d721acd50e8b51ac947d086352bdd4f3f26702adc127b021c
+  data.tar.gz: 57eb001ae9a6ba61c002855ad1abbe17fe14fcc3c8fc269b55903b780da669d2
+SHA512:
+  metadata.gz: 686aef33e7ff8e70994ffe7ad034beddea13b5adf6fc9cd072288898c253f64c49aae92a28c7068f3de4252304b5b6ed5a86698886a87353ce3912afabb870b2
+  data.tar.gz: 2a86b18d8ea9a824fc2de991ae25f7f83473eda13f9ffaa96e6e451d1cca0729fa6cc3d3331e6a292a94e31fb604643b651e23697bbeec96dde6de6cae2d3c1f

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Initialize client with '...'
+2. Call method '...'
+3. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Code Example**
+```ruby
+# Your code that reproduces the issue
+```
+
+**Environment:**
+- Ruby version: [e.g. 3.2.0]
+- Gem version: [e.g. 1.0.0]
+- OS: [e.g. macOS 13.0]
+- AI Provider: [e.g. OpenAI, Anthropic]
+
+**Additional context**
+Add any other context about the problem here.

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Use Case**
+Describe how this feature would be used:
+```ruby
+# Example usage of the proposed feature
+```
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

data/.github/pull_request_template.md

@@ -0,0 +1,38 @@
+# Pull Request
+
+## Description
+<!-- Provide a detailed description of your changes -->
+
+## Type of Change
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring
+- [ ] Performance improvement
+
+## Testing
+<!-- Describe the tests you ran to verify your changes -->
+
+- [ ] All existing tests pass
+- [ ] New tests added for new functionality
+- [ ] Manual testing completed
+
+## Checklist
+<!-- Mark completed items with an "x" -->
+
+- [ ] My code follows the style guidelines of this project (RuboCop passes)
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+
+## Related Issues
+<!-- Link any related issues here using #issue-number -->
+
+Fixes #

data/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Test on Ruby ${{ matrix.ruby-version }}
+    runs-on: ${{ matrix.os }}
+    
+    strategy:
+      matrix:
+        ruby-version: ['3.0', '3.1', '3.2', '3.3']
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      
+      - name: Install dependencies
+        run: bundle install
+      
+      - name: Run RuboCop
+        run: bundle exec rubocop
+      
+      - name: Run tests
+        run: bundle exec rake spec
+      
+      - name: Generate coverage
+        run: bundle exec rake coverage
+      
+      - name: Build gem
+        run: gem build agentbill.gemspec
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: gem-${{ matrix.ruby-version }}-${{ matrix.os }}
+          path: '*.gem'

data/.gitignore

@@ -0,0 +1,14 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+.bundle/
+vendor/bundle
+.env

data/.rspec

@@ -0,0 +1,4 @@
+--require spec_helper
+--format documentation
+--color
+--order random

data/.rubocop.yml

@@ -0,0 +1,58 @@
+# RuboCop configuration for AgentBill Ruby SDK
+
+require:
+  - rubocop-performance
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.6
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'spec/fixtures/**/*'
+    - 'tmp/**/*'
+
+# Layout
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns: ['\A#']
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+# Style
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+# Metrics
+Metrics/MethodLength:
+  Max: 30
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/BlockLength:
+  Max: 30
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/ModuleLength:
+  Max: 150
+
+# Naming
+Naming/FileName:
+  Enabled: true
+
+# Performance
+Performance/StringReplacement:
+  Enabled: true

data/.ruby-version

@@ -0,0 +1 @@
+3.2.0

data/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-10-21
+
+### Added
+- Initial release of AgentBill Ruby SDK
+- OpenAI client wrapping with automatic usage tracking
+- Anthropic client wrapping with automatic usage tracking
+- OpenTelemetry-based tracing infrastructure
+- Custom signal tracking support
+- Comprehensive test suite with RSpec
+- GitHub Actions CI/CD workflows
+- RuboCop code quality enforcement
+- Professional documentation and examples
+- MIT License
+
+### Features
+- Zero-config instrumentation for AI providers
+- Automatic token and cost tracking
+- Rich metadata capture
+- Latency measurement
+- Error tracking and reporting
+- Customer-specific tracking support
+- Debug logging capabilities
+
+### Supported Providers
+- OpenAI (GPT-4, GPT-3.5, etc.)
+- Anthropic (Claude 3.5 Sonnet, etc.)
+
+### Documentation
+- Complete README with usage examples
+- API documentation
+- Contributing guidelines
+- Security policy
+- Code of conduct
+
+[1.0.0]: https://github.com/Agent-Bill/Ruby/releases/tag/v1.0.0

data/CONTRIBUTING.md

@@ -0,0 +1,135 @@
+# Contributing to AgentBill Ruby SDK
+
+Thank you for your interest in contributing! This document provides guidelines for contributing to the AgentBill Ruby SDK.
+
+## Development Setup
+
+1. **Fork and clone the repository**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/agentbill-ruby.git
+   cd agentbill-ruby
+   ```
+
+2. **Install dependencies**
+   ```bash
+   bundle install
+   ```
+
+3. **Run tests**
+   ```bash
+   bundle exec rake spec
+   ```
+
+4. **Run code quality checks**
+   ```bash
+   bundle exec rubocop
+   ```
+
+## Development Workflow
+
+1. **Create a feature branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Make your changes**
+   - Write clean, readable code
+   - Follow Ruby style guidelines (RuboCop will check this)
+   - Add tests for new functionality
+   - Update documentation as needed
+
+3. **Run quality checks**
+   ```bash
+   bundle exec rake ci  # Runs RuboCop + tests
+   ```
+
+4. **Commit your changes**
+   ```bash
+   git add .
+   git commit -m "feat: Add your feature description"
+   ```
+
+5. **Push and create pull request**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+## Code Standards
+
+### Style Guide
+- Follow the [Ruby Style Guide](https://rubystyle.guide/)
+- Use RuboCop to check code style: `bundle exec rubocop`
+- Fix auto-fixable issues: `bundle exec rubocop -a`
+
+### Testing
+- Write RSpec tests for all new features
+- Maintain minimum 90% code coverage
+- Run tests: `bundle exec rake spec`
+- Run with coverage: `bundle exec rake coverage`
+
+### Documentation
+- Add YARD documentation for public methods
+- Update README.md for user-facing changes
+- Add examples for new features
+
+## Pull Request Process
+
+1. **Ensure all checks pass**
+   - All tests pass
+   - RuboCop has no violations
+   - Code coverage is maintained
+
+2. **Update documentation**
+   - Update README.md if needed
+   - Add CHANGELOG.md entry
+   - Add YARD documentation
+
+3. **Fill out PR template**
+   - Describe your changes
+   - Link related issues
+   - Check all boxes in the template
+
+4. **Wait for review**
+   - Address reviewer feedback
+   - Make requested changes
+   - Re-request review when ready
+
+## Adding New AI Provider Support
+
+To add support for a new AI provider:
+
+1. **Add wrapper method in `lib/agentbill.rb`**
+   ```ruby
+   def wrap_provider_name(client)
+     # Implementation
+   end
+   ```
+
+2. **Add tests in `spec/agentbill_spec.rb`**
+   ```ruby
+   describe '#wrap_provider_name' do
+     # Tests
+   end
+   ```
+
+3. **Add example in `examples/`**
+   ```ruby
+   # examples/provider_name_basic.rb
+   ```
+
+4. **Update README.md** with usage example
+
+## Community Guidelines
+
+- Be respectful and inclusive
+- Help others learn and grow
+- Provide constructive feedback
+- Follow the [Code of Conduct](CODE_OF_CONDUCT.md)
+
+## Getting Help
+
+- Open an issue for bugs or feature requests
+- Join discussions in pull requests
+- Check existing issues and PRs first
+
+Thank you for contributing! 🎉

data/Gemfile

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in agentbill.gemspec
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0'
+  gem 'rspec', '~> 3.9'
+  gem 'rubocop', '~> 1.21'
+  gem 'rubocop-performance', '~> 1.11'
+  gem 'rubocop-rspec', '~> 2.0'
+  gem 'simplecov', '~> 0.21'
+  gem 'webmock', '~> 3.14'
+  gem 'pry', '~> 0.14'
+  gem 'yard', '~> 0.9'
+  gem 'redcarpet', '~> 3.5'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentBill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,149 @@
+# AgentBill Ruby SDK
+
+OpenTelemetry-based SDK for automatically tracking and billing AI agent usage.
+
+## Installation
+
+### From GitHub (Recommended)
+```ruby
+# In your Gemfile
+gem 'agentbill', git: 'https://github.com/Agent-Bill/Ruby.git'
+```
+
+### From RubyGems
+```ruby
+# In your Gemfile
+gem 'agentbill'
+```
+
+Then execute:
+```bash
+bundle install
+```
+
+### From Source
+```bash
+git clone https://github.com/Agent-Bill/Ruby.git
+cd agentbill-ruby
+gem build agentbill.gemspec
+gem install agentbill-1.0.0.gem
+```
+
+## File Structure
+
+```
+agentbill-ruby/
+├── lib/
+│   ├── agentbill.rb
+│   └── agentbill/
+│       ├── tracer.rb
+│       └── version.rb
+├── examples/
+│   ├── openai_basic.rb
+│   └── anthropic_basic.rb
+├── spec/
+├── README.md
+├── agentbill.gemspec
+├── Gemfile
+├── Rakefile
+└── LICENSE
+```
+
+## Quick Start
+
+### OpenAI
+
+```ruby
+require 'agentbill'
+require 'openai'
+
+# Initialize AgentBill
+agentbill = AgentBill::Client.init({
+  api_key: 'your-api-key',
+  customer_id: 'customer-123',
+  debug: true
+})
+
+# Wrap your OpenAI client
+client = agentbill.wrap_openai(OpenAI::Client.new(
+  access_token: 'sk-...'
+))
+
+# Use normally - all calls are automatically tracked!
+response = client.chat({
+  model: 'gpt-4',
+  messages: [{ role: 'user', content: 'Hello!' }]
+})
+```
+
+### Anthropic
+
+```ruby
+require 'agentbill'
+require 'anthropic'
+
+# Initialize AgentBill
+agentbill = AgentBill::Client.init({
+  api_key: 'your-api-key',
+  customer_id: 'customer-123',
+  debug: true
+})
+
+# Wrap your Anthropic client
+client = agentbill.wrap_anthropic(Anthropic::Client.new(
+  access_token: ENV['ANTHROPIC_API_KEY']
+))
+
+# Use normally - all calls are automatically tracked!
+response = client.messages({
+  model: 'claude-3-5-sonnet-20241022',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Hello!' }]
+})
+```
+
+## Features
+
+- ✅ Zero-config instrumentation
+- ✅ Accurate token & cost tracking
+- ✅ Multi-provider support (OpenAI, Anthropic)
+- ✅ Rich metadata capture
+- ✅ OpenTelemetry-based
+
+## Configuration
+
+```ruby
+config = {
+  api_key: 'your-api-key',        # Required
+  base_url: 'https://...',         # Optional
+  customer_id: 'customer-123',     # Optional
+  debug: true                       # Optional
+}
+
+agentbill = AgentBill::Client.init(config)
+```
+
+## Publishing to RubyGems
+
+### Prerequisites
+1. Create a RubyGems account at https://rubygems.org/sign_up
+2. Get your API key: `gem signin`
+
+### Publishing Steps
+```bash
+# Build the gem
+gem build agentbill.gemspec
+
+# Push to RubyGems
+gem push agentbill-1.0.0.gem
+```
+
+## GitHub Repository Setup
+
+1. Create repository: `agentbill-ruby`
+2. Push all files from `lib/` directory
+3. Tag releases: `git tag v1.0.0 && git push origin v1.0.0`
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+desc 'Run all quality checks (RuboCop + tests)'
+task ci: [:rubocop, :spec]
+
+desc 'Generate code coverage report'
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].execute
+end
+
+desc 'Open development console'
+task :console do
+  require 'irb'
+  require 'agentbill'
+  ARGV.clear
+  IRB.start
+end
+
+desc 'Generate YARD documentation'
+task :doc do
+  system('yard doc')
+end
+
+task default: :ci

data/SECURITY.md

@@ -0,0 +1,73 @@
+# Security Policy
+
+## Supported Versions
+
+We release security updates for the following versions:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.x.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+We take security vulnerabilities seriously. If you discover a security issue, please follow responsible disclosure practices:
+
+### How to Report
+
+**DO NOT** create a public GitHub issue for security vulnerabilities.
+
+Instead, please email: security@agentbill.com
+
+Include:
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+- Suggested fix (if any)
+
+### What to Expect
+
+1. **Acknowledgment**: We'll acknowledge your report within 48 hours
+2. **Investigation**: We'll investigate and keep you updated on progress
+3. **Fix**: We'll develop and test a fix
+4. **Release**: We'll release a security patch
+5. **Credit**: We'll credit you in the security advisory (unless you prefer to remain anonymous)
+
+### Security Best Practices
+
+When using the AgentBill Ruby SDK:
+
+1. **API Keys**
+   - Never commit API keys to version control
+   - Use environment variables: `ENV['AGENTBILL_API_KEY']`
+   - Rotate keys regularly
+   - Use different keys for development/production
+
+2. **Dependencies**
+   - Keep the gem updated to the latest version
+   - Run `bundle update agentbill` regularly
+   - Monitor security advisories
+
+3. **Data Privacy**
+   - Review what data is being tracked
+   - Implement proper data retention policies
+   - Follow GDPR/CCPA guidelines if applicable
+
+4. **Network Security**
+   - Use HTTPS endpoints only
+   - Verify SSL certificates
+   - Use secure base URLs
+
+## Security Features
+
+The AgentBill SDK includes:
+
+- ✅ HTTPS-only communication
+- ✅ API key authentication
+- ✅ No sensitive data logged by default
+- ✅ Configurable debug mode for development
+
+## Questions?
+
+For general security questions, email: security@agentbill.com
+
+Thank you for helping keep AgentBill secure! 🔒

data/agentbill.gemspec

@@ -0,0 +1,25 @@
+require_relative 'lib/agentbill/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "agentbill-sdk"
+  spec.version       = AgentBill::VERSION
+  spec.authors       = ["AgentBill"]
+  spec.email         = ["support@agentbill.com"]
+
+  spec.summary       = "OpenTelemetry-based SDK for tracking AI agent usage and billing"
+  spec.description   = "Automatically track and bill AI agent usage with zero-config instrumentation for OpenAI, Anthropic, and more"
+  spec.homepage      = "https://github.com/Agent-Bill/Ruby"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/Agent-Bill/Ruby"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+end

data/examples/anthropic_basic.rb

@@ -0,0 +1,28 @@
+require 'agentbill'
+require 'anthropic'
+
+# Initialize AgentBill with your API key
+agentbill = AgentBill::Client.init({
+  api_key: ENV['AGENTBILL_API_KEY'] || 'your-api-key',
+  base_url: ENV['AGENTBILL_BASE_URL'],
+  customer_id: 'customer-123',
+  debug: true
+})
+
+# Wrap your Anthropic client
+client = agentbill.wrap_anthropic(Anthropic::Client.new(
+  access_token: ENV['ANTHROPIC_API_KEY']
+))
+
+# Use Anthropic normally - tracking is automatic!
+response = client.messages({
+  model: 'claude-3-5-sonnet-20241022',
+  max_tokens: 1024,
+  messages: [
+    { role: 'user', content: 'What is the capital of France?' }
+  ]
+})
+
+puts response.dig('content', 0, 'text')
+
+# All usage (tokens, cost, latency) is automatically tracked to your AgentBill dashboard

data/examples/openai_basic.rb

@@ -0,0 +1,28 @@
+require 'agentbill'
+require 'openai'
+
+# Initialize AgentBill with your API key
+agentbill = AgentBill::Client.init({
+  api_key: ENV['AGENTBILL_API_KEY'] || 'your-api-key',
+  base_url: ENV['AGENTBILL_BASE_URL'],
+  customer_id: 'customer-123',
+  debug: true
+})
+
+# Wrap your OpenAI client
+client = agentbill.wrap_openai(OpenAI::Client.new(
+  access_token: ENV['OPENAI_API_KEY']
+))
+
+# Use OpenAI normally - tracking is automatic!
+response = client.chat({
+  model: 'gpt-4o-mini',
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'What is the capital of France?' }
+  ]
+})
+
+puts response['choices'][0]['message']['content']
+
+# All usage (tokens, cost, latency) is automatically tracked to your AgentBill dashboard

data/lib/agentbill/tracer.rb

@@ -0,0 +1,122 @@
+require 'net/http'
+require 'json'
+require 'securerandom'
+
+module AgentBill
+  class Span
+    attr_accessor :name, :trace_id, :span_id, :attributes, :start_time, :end_time, :status
+
+    def initialize(name, trace_id, span_id, attributes)
+      @name = name
+      @trace_id = trace_id
+      @span_id = span_id
+      @attributes = attributes
+      @start_time = (Time.now.to_f * 1_000_000_000).to_i
+      @end_time = nil
+      @status = { code: 0 }
+    end
+
+    def set_attributes(attrs)
+      @attributes.merge!(attrs)
+    end
+
+    def set_status(code, message = '')
+      @status = { code: code, message: message }
+    end
+
+    def finish
+      @end_time = (Time.now.to_f * 1_000_000_000).to_i
+    end
+  end
+
+  class Tracer
+    def initialize(config)
+      @config = config
+      @base_url = config[:base_url] || 'https://uenhjwdtnxtchlmqarjo.supabase.co'
+      @api_key = config[:api_key]
+      @customer_id = config[:customer_id]
+      @debug = config[:debug] || false
+      @spans = []
+    end
+
+    def start_span(name, attributes)
+      trace_id = SecureRandom.hex(16)
+      span_id = SecureRandom.hex(8)
+
+      attributes['service.name'] = 'agentbill-ruby-sdk'
+      attributes['customer.id'] = @customer_id if @customer_id
+
+      span = Span.new(name, trace_id, span_id, attributes)
+      @spans << span
+      span
+    end
+
+    def flush
+      return if @spans.empty?
+
+      payload = build_otlp_payload
+      uri = URI("#{@base_url}/functions/v1/otel-collector")
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      request = Net::HTTP::Post.new(uri.path)
+      request['Authorization'] = "Bearer #{@api_key}"
+      request['Content-Type'] = 'application/json'
+      request.body = payload.to_json
+
+      response = http.request(request)
+
+      puts "AgentBill flush: #{response.code}" if @debug
+
+      @spans.clear if response.code.to_i == 200
+    rescue => e
+      puts "AgentBill flush error: #{e.message}" if @debug
+    end
+
+    private
+
+    def build_otlp_payload
+      {
+        resourceSpans: [{
+          resource: {
+            attributes: [
+              { key: 'service.name', value: { stringValue: 'agentbill-ruby-sdk' } },
+              { key: 'service.version', value: { stringValue: '1.0.0' } }
+            ]
+          },
+          scopeSpans: [{
+            scope: { name: 'agentbill', version: '1.0.0' },
+            spans: @spans.map { |span| span_to_otlp(span) }
+          }]
+        }]
+      }
+    end
+
+    def span_to_otlp(span)
+      {
+        traceId: span.trace_id,
+        spanId: span.span_id,
+        name: span.name,
+        kind: 1,
+        startTimeUnixNano: span.start_time.to_s,
+        endTimeUnixNano: (span.end_time || (Time.now.to_f * 1_000_000_000).to_i).to_s,
+        attributes: span.attributes.map { |k, v| { key: k, value: value_to_otlp(v) } },
+        status: span.status
+      }
+    end
+
+    def value_to_otlp(value)
+      case value
+      when String
+        { stringValue: value }
+      when Integer, Float
+        { intValue: value.to_i }
+      when TrueClass, FalseClass
+        { boolValue: value }
+      else
+        { stringValue: value.to_s }
+      end
+    end
+  end
+end

data/lib/agentbill/version.rb

@@ -0,0 +1,3 @@
+module AgentBill
+  VERSION = "1.0.1"
+end

data/lib/agentbill.rb

@@ -0,0 +1,125 @@
+require 'net/http'
+require 'json'
+require 'securerandom'
+require_relative 'agentbill/version'
+require_relative 'agentbill/tracer'
+
+module AgentBill
+  class Client
+    attr_reader :config, :tracer
+
+    def initialize(config)
+      @config = config
+      @tracer = Tracer.new(config)
+    end
+
+    def self.init(config)
+      new(config)
+    end
+
+    def wrap_openai(client)
+      original_method = client.method(:chat)
+      
+      client.define_singleton_method(:chat) do |params|
+        start_time = Time.now
+        
+        span = @tracer.start_span('openai.chat.completion', {
+          'model' => params[:model] || 'unknown',
+          'provider' => 'openai'
+        })
+        
+        begin
+          response = original_method.call(params)
+          
+          latency = ((Time.now - start_time) * 1000).round
+          span.set_attributes({
+            'response.prompt_tokens' => response.dig(:usage, :prompt_tokens),
+            'response.completion_tokens' => response.dig(:usage, :completion_tokens),
+            'response.total_tokens' => response.dig(:usage, :total_tokens),
+            'latency_ms' => latency
+          })
+          span.set_status(0)
+          
+          response
+        rescue => e
+          span.set_status(1, e.message)
+          raise
+        ensure
+          span.finish
+        end
+      end
+      
+      client
+    end
+
+    def wrap_anthropic(client)
+      original_method = client.method(:messages)
+      
+      client.define_singleton_method(:messages) do |params|
+        start_time = Time.now
+        
+        span = @tracer.start_span('anthropic.message', {
+          'model' => params[:model] || 'unknown',
+          'provider' => 'anthropic'
+        })
+        
+        begin
+          response = original_method.call(params)
+          
+          latency = ((Time.now - start_time) * 1000).round
+          span.set_attributes({
+            'response.input_tokens' => response.dig(:usage, :input_tokens),
+            'response.output_tokens' => response.dig(:usage, :output_tokens),
+            'latency_ms' => latency
+          })
+          span.set_status(0)
+          
+          response
+        rescue => e
+          span.set_status(1, e.message)
+          raise
+        ensure
+          span.finish
+        end
+      end
+      
+      client
+    end
+
+    def track_signal(event_name:, revenue: 0, data: {})
+      uri = URI("#{@config[:base_url] || 'https://bgwyprqxtdreuutzpbgw.supabase.co'}/functions/v1/record-signals")
+      
+      payload = {
+        event_name: event_name,
+        revenue: revenue,
+        customer_id: @config[:customer_id],
+        timestamp: Time.now.to_i,
+        data: data
+      }
+      
+      begin
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        
+        request = Net::HTTP::Post.new(uri.path)
+        request['Authorization'] = "Bearer #{@config[:api_key]}"
+        request['Content-Type'] = 'application/json'
+        request.body = payload.to_json
+        
+        response = http.request(request)
+        
+        if @config[:debug]
+          puts "[AgentBill] Signal tracked: #{event_name}, revenue: $#{revenue}"
+        end
+      rescue => e
+        if @config[:debug]
+          puts "[AgentBill] Failed to track signal: #{e.message}"
+        end
+      end
+    end
+
+    def flush
+      @tracer.flush
+    end
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: agentbill-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- AgentBill
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Automatically track and bill AI agent usage with zero-config instrumentation
+  for OpenAI, Anthropic, and more
+email:
+- support@agentbill.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/ISSUE_TEMPLATE/bug_report.md"
+- ".github/ISSUE_TEMPLATE/feature_request.md"
+- ".github/pull_request_template.md"
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- SECURITY.md
+- agentbill.gemspec
+- examples/anthropic_basic.rb
+- examples/openai_basic.rb
+- lib/agentbill.rb
+- lib/agentbill/tracer.rb
+- lib/agentbill/version.rb
+homepage: https://github.com/Agent-Bill/Ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Agent-Bill/Ruby
+  source_code_uri: https://github.com/Agent-Bill/Ruby
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: OpenTelemetry-based SDK for tracking AI agent usage and billing
+test_files: []