​

Pulse

​

What We Collect

​

What We DON’T Collect

• Your IP address
• Project names or file contents
• Agent or ensemble names
• Prompts, schemas, or configurations
• API keys or any secrets
• Any personally identifiable information

​

How to Opt Out

​

Option 1: Config file

// conductor.config.ts
export default {
  cloud: {
    pulse: false,
  },
  // ...
}

​

Option 2: Environment variable

# Standard opt-out (respects DO_NOT_TRACK convention)
DO_NOT_TRACK=1

# Or Conductor-specific
CONDUCTOR_PULSE=false

​

How It Works

1. When you run conductor init, a unique project ID (UUID) is generated and stored in your conductor.config.ts
2. On each Worker cold start, Pulse sends a single lightweight request to pulse.ensemble.ai
3. The request is fire-and-forget using ctx.waitUntil() - it never blocks your Worker
4. If the network request fails, it’s silently ignored

​

Upgraded Projects

• Your metrics will still be collected (unless you opt out)
• Each cold start may generate a different ID until you add one to your config
• To get consistent tracking, run conductor init . to add a project ID to your existing project

​

Why We Collect Pulse Metrics

• Prioritize features: See which parts of Conductor are most used
• Track adoption: Understand version migration patterns
• Geographic insights: Optimize edge performance by region
• Project complexity: Guide documentation based on typical project sizes

​

Where Data Goes

​

Technical Details

​

Payload Schema

interface PulsePayload {
  pid: string      // Project ID (UUID)
  e: string        // Event type (e.g., "server.start")
  v: string        // Conductor version
  cc: number       // Component count
  ac: number       // Agent count
  ec: number       // Ensemble count
  ts: number       // Timestamp
}

​

Request Details

• Endpoint: https://pulse.ensemble.ai
• Method: POST
• Timeout: 5 seconds (non-blocking)
• Retry: None (fire-and-forget)

​

Privacy-First Design

1. No IP Logging: We derive country from Cloudflare’s edge location, not your IP
2. Random IDs: Project IDs are UUIDs with no relation to your actual project
3. Minimal Data: We only collect what’s needed for aggregate statistics
4. Easy Opt-Out: Multiple ways to disable, respecting industry standards
5. Transparent: This documentation tells you exactly what we collect

​

Next Steps