ag-ui-protocol / ag-ui-protocol/ag-ui

Add Convex Agent integration

Abierto
#1,064 5 comentarios 1 reacción 1 asignado Reclamado por @mikelrobbins Ver en GitHub
Roadmap
Lenguaje dominante
Python
Estrellas
15.9k
Forks
1.4k
Merge medio
1 d 17 h
PR fusionados (30 d)
163

Descripción

## Summary

Proposing a community integration for [Convex Agents](https://docs.convex.dev/agents) - AI agents built on Convex with built-in persistence, streaming, and the Vercel AI SDK.

## Why Convex?

Convex provides:
- Built-in real-time sync and persistence
- Native streaming support in HTTP actions
- TypeScript-first with end-to-end type safety
- Convex Agents wrap Vercel AI SDK with threads, messages, and tool execution

## Implementation Approach

Server-side integration using Convex HTTP Actions:
- Receive AG-UI `RunAgentInput` via POST
- Execute Convex Agent internally
- Translate Vercel AI SDK `fullStream` parts to AG-UI events
- Return SSE response

## AG-UI Events Supported

| Vercel AI SDK Stream Part | AG-UI Event |
|---------------------------|-------------|
| `text-start` | `TEXT_MESSAGE_START` |
| `text-delta` | `TEXT_MESSAGE_CONTENT` |
| `text-end` | `TEXT_MESSAGE_END` |
| `tool-call` | `TOOL_CALL_START` + `TOOL_CALL_ARGS` + `TOOL_CALL_END` |
| `tool-result` | `TOOL_CALL_RESULT` |
| `start-step` / `finish-step` | `STEP_STARTED` / `STEP_FINISHED` |
| `error` | `RUN_ERROR` |

## Status

I have a working implementation ready to submit as a PR to `integrations/community/convex/typescript/`.

Happy to provide more details or adjust the approach based on feedback.

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.