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

Add Convex Agent integration

Ouverte
#1,064 5 commentaires 1 réaction 1 personne assignée Réclamée par @mikelrobbins Voir sur GitHub
Roadmap
Langage dominant
Python
Étoiles
15.9k
Forks
1.4k
Merge moyen
1 j 17 h
PR mergées (30 j)
163

Description

## 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.

Guide de contribution

Ouvrir le guide de contribution

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.