lindy-common-errors

# Lindy Common Errors

## Overview
Comprehensive guide to troubleshooting common Lindy AI errors and issues.

## Prerequisites
- Lindy SDK installed
- Access to logs and error messages
- Basic debugging skills

## Common Errors

### Authentication Errors

#### LINDY_AUTH_INVALID_KEY
```
Error: Invalid API key provided
Code: LINDY_AUTH_INVALID_KEY
```

**Causes:**
- Expired API key
- Incorrect key format
- Key from wrong environment

**Solutions:**
```bash
# Verify key is set
echo $LINDY_API_KEY

# Regenerate key in dashboard
# https://app.lindy.ai/settings/api-keys

# Test key
curl -H "Authorization: Bearer $LINDY_API_KEY" \
  https://api.lindy.ai/v1/users/me
```

### Rate Limit Errors

#### LINDY_RATE_LIMITED
```
Error: Rate limit exceeded
Code: LINDY_RATE_LIMITED
Retry-After: 60
```

**Causes:**
- Too many API requests
- Concurrent agent runs exceeded
- Burst limit reached

**Solutions:**
```typescript
// Implement exponential backoff
async function withBackoff<T>(fn: () => Promise<T>): Promise<T> {
  for (let i = 0; i < 5; i++) {
    try {
      return await fn();
    } catch (e: any) {
      if (e.code === 'LINDY_RATE_LIMITED') {
        const delay = Math.pow(2, i) * 1000;
        await new Promise(r => setTimeout(r, delay));
        continue;
      }
      throw e;
    }
  }
  throw new Error('Max retries exceeded');
}
```

### Agent Errors

#### LINDY_AGENT_NOT_FOUND
```
Error: Agent not found
Code: LINDY_AGENT_NOT_FOUND
```

**Solutions:**
```typescript
// Verify agent exists
const agents = await lindy.agents.list();
const exists = agents.some(a => a.id === agentId);

// Check environment (dev vs prod)
console.log('Environment:', process.env.LINDY_ENVIRONMENT);
```

#### LINDY_AGENT_TIMEOUT
```
Error: Agent execution timed out
Code: LINDY_AGENT_TIMEOUT
```

**Solutions:**
```typescript
// Increase timeout
const result = await lindy.agents.run(agentId, {
  input,
  timeout: 120000, // 2 minutes
});

// Use streaming for long tasks
const stream = await lindy.a