rowboat/GITHUB_COPILOT_INTEGRATION.md

GitHub Copilot Integration for Rowboat

Esta implementación agrega soporte completo para GitHub Copilot en Rowboat usando Device Flow OAuth (RFC 8628).

¿Qué se implementó?

1. Schema de Proveedores (apps/x/packages/shared/src/models.ts)

• Agregado "github-copilot" como flavor de proveedor LLM

2. Provider LLM (apps/x/packages/core/src/models/models.ts)

• Implementado case para github-copilot que usa la API compatible con OpenAI de GitHub Models
• Base URL: https://models.github.com/api/openai/

3. Configuración OAuth (apps/x/packages/core/src/auth/providers.ts)

• Agregado proveedor github-copilot con:
  • Authorization endpoint: https://github.com/login/oauth/authorize
  • Token endpoint: https://github.com/login/oauth/access_token
  • Client ID: Iv1.b507a08c87ecfe98 (GitHub Copilot CLI Client ID oficial)
  • Scopes: read:user, user:email, gist

4. Device Flow Implementation (apps/x/packages/core/src/auth/github-copilot-device-flow.ts)

Nuevo archivo que implementa RFC 8628:

• requestDeviceCode() - Solicita un device code a GitHub
• pollForToken() - Sondea GitHub para obtener el token
• startGitHubCopilotAuth() - Flujo completo de autenticación

Cómo usar

1. Instalación

cd apps/x
pnpm install
npm run deps

2. Configuración Manual (archivo JSON)

Edita ~/.rowboat/config/models.json:

{
  "provider": {
    "flavor": "github-copilot",
    "apiKey": null
  },
  "model": "gpt-4o"
}

3. Autenticación con Device Flow

Cuando Rowboat se inicia con GitHub Copilot configurado:

1. Se solicita un device code a GitHub
2. Se muestra un código de usuario (ej: ABCD-1234)
3. Se abre https://github.com/login/device
4. Usuario ingresa el código
5. Rowboat automáticamente sondea y obtiene el token

┌ GitHub Copilot Authentication
│
│ Visit: https://github.com/login/device
│ Enter code: ABCD-1234
│
│ Waiting for authorization...
└

4. Modelos disponibles

GitHub Copilot soporta estos modelos:

• gpt-4o - GPT-4 Omni (más capaz, más caro)
• gpt-4-turbo - GPT-4 Turbo
• gpt-3.5-turbo - GPT-3.5 Turbo (rápido, económico)
• claude-opus - Claude Opus (si está disponible)

Flujo técnico

┌─────────────────────────────────────────────────────────┐
│  Rowboat Application                                     │
└─────────┬───────────────────────────────────────────────┘
          │
          ├─► requestDeviceCode()
          │   └─► POST /login/device/code
          │       └─ client_id, scope
          │
          ├─► Display: Visit https://github.com/login/device
          │           Enter code: ABCD-1234
          │
          ├─► pollForToken()
          │   └─► POST /login/oauth/access_token (loop)
          │       └─ device_code, client_id, grant_type
          │
          └─► createProvider() con apiKey = access_token
              └─► POST https://models.github.com/api/openai/v1/chat/completions
                  └─ Bearer token auth

Manejo de errores

El código maneja varios estados de error de GitHub:

Error	Acción
authorization_pending	Continúa sondeando
slow_down	Aumenta intervalo de sondeo
expired_token	Falla con mensaje claro
access_denied	Usuario rechazó

Próximos pasos

Para completar la integración:

1. UI de autenticación - Integrar en el onboarding step de Rowboat
2. Almacenamiento de tokens - Guardar en ~/.rowboat/config/auth.json
3. Renovación de tokens - Implementar refresh token si GitHub lo soporta
4. Selección de modelos - Descubrir modelos disponibles automáticamente
5. Tests - Agregar tests unitarios para device flow

Referencia

• RFC 8628: Device Authorization Grant - https://tools.ietf.org/html/rfc8628
• GitHub Device Flow Docs - https://docs.github.com/en/developers/apps/building-oauth-apps/authorizing-oauth-apps#device-flow
• GitHub Models API - https://docs.github.com/en/github/copilot/github-copilot-in-the-cli/about-github-copilot-in-the-cli