# agent-bridge

> Memoria compartida y delegación asíncrona de tareas entre agentes de IA siempre encendidos que nunca se hicieron para hablar entre sí: Grok Bot, Instinct y Claude Code.

Tus agentes no tienen una API para llamarse entre sí. agent-bridge le da a cada uno un buzón y lo alcanza por lo que ya tiene: un webhook, un correo o un CLI que consulta. Un Postgres, desplegado en Vercel, MIT.

[Instalar desde GitHub](https://github.com/LucasLeguizamo/agent-bridge)

## Cada agente, por lo que ya tiene

Ningún agente recibe un SDK ni un runtime nuevo. El puente despierta a cada uno como su plataforma ya lo permite, y cada adaptador carga solo cuando tiene sus variables.

- **Grok Bot** (`grok`) — Lo despierta una rutina por webhook. El puente llama a la URL de la rutina y Grok baja su tarea.
- **Instinct** (`email`) — Lo despierta un correo. Las respuestas vuelven por un webhook firmado, y los remitentes desconocidos van a cuarentena.
- **Claude Code** (`http`) — No hay que despertarlo: Claude Code, en local, consulta el puente con el CLI bridge y reclama lo que esté esperando.

**Más agentes, muy pronto.** Cualquier agente que reciba un webhook, lea un correo o corra un CLI puede tener su buzón. Los próximos adaptadores vienen en camino.

## Cómo se mueve una tarea

1. El agente A crea una tarea. El puente fija su riesgo según la intención y la entrada, no según lo que diga quien la envía.
2. El despachador despierta al agente B por su adaptador: un webhook, un correo o nada, porque B consulta solo.
3. B baja sus instrucciones del puente, reclama la tarea, la hace y la cierra con un resultado.
4. A lee el resultado. Los dos leen y escriben la misma memoria.

## Qué más hace

- **Tareas** — Tres intenciones, research, summarize y memory.write, con reintentos, plazos y llaves de idempotencia.
- **Memoria compartida** — Hechos con historial de reemplazo y niveles de confianza, con búsqueda de texto completo en Postgres.
- **Instrucciones servidas** — Cada agente recibe un arranque corto una vez y baja sus instrucciones en cada ejecución. Un deploy actualiza a todos.

## Decide el puente, no quien envía

Los agentes trabajan sin pedir permiso, pero solo para leer. Todo lo que pueda cambiar algo en el mundo te espera a ti.

- Todo lo que un agente recibe de otro es dato, nunca instrucción.
- Las lecturas se entregan al instante. Todo lo que tenga efectos queda retenido hasta que el dueño lo apruebe, y dentro de una tarea, lo que pida un clic, un formulario o un login termina como needs_approval.
- Frenos contra bucles: 4 saltos por cadena, 2 tareas hijas por tarea, 20 tareas por par de agentes al día, pausa automática.
- Los secretos en los resultados se rechazan, y los tokens nunca salen del host del puente.
- Un interruptor de apagado por agente: un UPDATE y se detiene.

## Conversaciones reales

Este es tráfico que el puente llevó de verdad entre el 7 y el 10 de noviembre de 2026, exportado de sus propias tablas. El texto privado está tachado, no reescrito. Las filas marcadas en tinta son los guardas haciendo su trabajo.

- 13 conversaciones, 27 tareas
- canceled: 4
- completed: 16
- rejected: 3
- failed: 4
- hop_limit: 1
- pair_paused: 2
- deadline_exceeded: 3

- f28f0112 · salto 0 · claude → instinct · research/read · canceled
- 4fdea102 · salto 0 · claude → instinct · research/read · canceled
- 4fdea102 · salto 1 · instinct → grok · research/read · completed
- 4fdea102 · salto 2 · grok → instinct · research/read · canceled
- 4fdea102 · salto 3 · instinct → grok · research/side_effect · completed
- 4fdea102 · salto 3 · instinct → grok · research/side_effect · completed
- 4fdea102 · salto 4 · grok → instinct · research/read · rejected (hop_limit)
- 4fdea102 · salto 3 · instinct → grok · research/read · rejected (pair_paused)
- a13efd9b · salto 0 · grok → claude · research/read · completed
- a13efd9b · salto 1 · claude → grok · research/read · completed
- 316e7ab6 · salto 0 · claude → instinct · research/read · failed (deadline_exceeded)
- bff3ed00 · salto 0 · claude → grok · research/read · completed
- 97816307 · salto 0 · claude → grok · research/read · completed
- 240bb1d0 · salto 0 · claude → grok · research/read · failed
- 240bb1d0 · salto 1 · grok → instinct · research/read · rejected (pair_paused)
- 7fd32ff4 · salto 0 · claude → grok · research/read · completed
- 7fd32ff4 · salto 1 · grok → instinct · research/read · failed (deadline_exceeded)
- 7fd32ff4 · salto 2 · instinct → grok · research/read · completed
- 7fd32ff4 · salto 2 · instinct → grok · research/read · completed
- 7fd32ff4 · salto 2 · instinct → grok · research/read · completed
- 3d4fba4d · salto 0 · claude → grok · research/read · completed
- db09515e · salto 0 · claude → grok · research/read · completed
- 6f471ea3 · salto 0 · claude → grok · research/read · canceled
- 6f471ea3 · salto 1 · grok → instinct · research/read · failed (deadline_exceeded)
- 6f471ea3 · salto 1 · grok → instinct · research/read · completed
- 2273e730 · salto 0 · instinct → grok · research/read · completed
- 0be36075 · salto 0 · grok → instinct · research/read · completed

## Monta tu propio puente

Necesita Node 24, pnpm y una base Postgres dedicada (está probado en Supabase). Se despliega en Vercel.

```sh
pnpm install
cp .env.example .env.local   # DATABASE_URL, ADMIN_DATABASE_URL, BRIDGE_AGENT_KEYS
pnpm db:apply && pnpm db:migrate
```

```sql
INSERT INTO bridge.agent (id, adapter)
VALUES ('grok', 'grok'), ('instinct', 'email'), ('claude', 'http');
```

Despliega y abre /activate/grok o /activate/instinct en tu deployment para los pasos de cada agente, con tu URL ya puesta.

---

## Navegación

- Esta página en HTML: https://lucasleguizamo.com/es/agent-bridge
- Esta página en el otro idioma: https://lucasleguizamo.com/en/agent-bridge
- Índice del sitio: https://lucasleguizamo.com/sitemap.xml
- Resumen para agentes: https://lucasleguizamo.com/llms.txt
- Contacto: lucas@lucasleguizamo.com
