--- name: Agent Kit slug: inngest-agent-kit type: github source_url: https://github.com/inngest/agent-kit organization: Inngest organization_slug: inngest total_releases: 35 latest_version: @inngest/agent-kit@0.13.2 latest_date: 2025-11-13 last_updated: 2026-04-19 tracking_since: 2024-11-22 canonical: https://releases.sh/inngest/inngest-agent-kit organization_url: https://releases.sh/inngest --- ### Patch Changes - 3818d37: Support multiple `AsyncContext` shapes following an update in `inngest@3.45.0` ### Patch Changes - 07ae4dd: Remove unused json-schema-to-zod require from bundled cjs ### Minor Changes - 2ffb890: made history strongly typed with AgentKitMessage ### Minor Changes - c9b0b16: support for latest version of inngest (3.43.1) integrated azure-openai model from @inngest/ai migrated to zod v4 and removed zod-to-json-schema package in favor of native z.toJSONSchema() ### Patch Changes - 4a81376: replacing the static import of json-schema-to-zod with a dynamic import() inside the function where it's used to resolve crashing when loading agentkit in a cjs project using require() ### Minor Changes - b175718: # New Package: @inngest/use-agent Introducing a comprehensive React hooks package for building AI chat interfaces with AgentKit networks. ## What's New **@inngest/use-agent** is a standalone npm package that provides a complete set of React hooks for integrating with AgentKit. This package extracts and consolidates all the React functionality needed to build sophisticated AI chat applications. ### Core Features - **Core Hooks**: `useAgent`, `useChat`, `useThreads` for real-time streaming and thread management - **Utility Hooks**: `useEphemeralThreads`, `useConversationBranching`, `useEditMessage`, `useMessageActions`, `useSidebar`, `useIsMobile` - **Provider System**: `AgentProvider` for shared connections and configuration - **Transport Layer**: Configurable API layer with `DefaultAgentTransport` and custom transport support - **TypeScript Support**: Full type definitions for all hooks and components - **Next.js Compatibility**: All hooks properly marked with "use client" directives ### Installation ```bash npm install @inngest/use-agents # Peer dependencies npm install react @inngest/realtime uuid ``` ### Basic Usage ```typescript import { useChat, AgentProvider } from '@inngest/use-agents'; function App() { return ( ); } function ChatComponent() { const { messages, sendMessage, status } = useChat(); return

/* Your chat UI */

; } ``` ### Why This Package This package enables developers to: - Build AI chat applications without reinventing the wheel - Leverage pre-built, battle-tested React hooks for AgentKit integration - Maintain consistent patterns across different projects - Focus on UI/UX instead of low-level streaming and state management ### Migration Guide If you were previously using local hooks from AgentKit examples, replace local imports: ```typescript // Before import { useChat } from "@/hooks"; import { AgentProvider } from "@/contexts/AgentContext"; // After import { useChat, AgentProvider } from "@inngest/use-agents"; ``` No functional changes are required - the API is identical to the previous local implementation. ### Minor Changes - b175718: # Comprehensive AgentKit Enhancements Major improvements to AgentKit with enhanced documentation, new API routes, comprehensive UI components, and example applications. ## 📚 Documentation Enhancements **New Advanced Pattern Guides:** - Added `legacy-ui-streaming.mdx` - Guide for UI streaming with useAgent hook - Added `use-chat.mdx` - Comprehensive guide for building chat interfaces - Added `use-threads.mdx` - Documentation for managing conversation threads - Added `use-agent.mdx` - Updated agent integration patterns **Documentation Reorganization:** - Moved UI streaming guides to dedicated UI Integration section - Enhanced advanced patterns with practical examples - Added sequence diagrams and usage guides ## ⚡ Revolutionary Automatic Event Streaming System **Comprehensive Streaming Architecture:** - **StreamingContext**: Hierarchical context management for network/agent runs with shared sequence counters - **Event Schema**: 15+ event types covering complete agent lifecycle (run.started, part.created, text.delta, tool calls, HITL, etc.) - **Automatic Enrichment**: Events auto-enriched with threadId, userId, and context metadata - **Sequence Management**: Monotonic sequence numbering for perfect event ordering across contexts - **Parent/Child Contexts**: Seamless context inheritance for agent runs within network runs - **Proxy-based Step Wrapper**: Transparent integration with Inngest steps without breaking existing code - **Best-effort Publishing**: Graceful error handling that never breaks agent execution - **OpenAI-Compatible IDs**: Automatic generation of tool call IDs within OpenAI's 40-character limit **Event Types Supported:** - **Lifecycle Events**: `run.started`, `run.completed`, `run.failed`, `run.interrupted` - **Content Streaming**: `text.delta`, `reasoning.delta`, `data.delta` - **Tool Integration**: `tool_call.arguments.delta`, `tool_call.output.delta` - **Part Management**: `part.created`, `part.completed`, `part.failed` - **HITL Support**: `hitl.requested`, `hitl.resolved` - **Metadata & Control**: `usage.updated`, `metadata.updated`, `stream.ended` **Developer Experience:** - **Zero Configuration**: Automatic context extraction from network state - **Debug Logging**: Comprehensive debug output for development - **Shared Sequence Counters**: Perfect event ordering across multiple contexts - **Flexible Publishing**: Configurable publish functions for any transport This streaming system enables real-time UI updates that perfectly match the `useAgent` hook expectations, creating seamless agent-to-UI communication. ## 🚀 New API Routes & Backend Features **Chat & Communication:** - `POST /api/chat` - Main chat endpoint with Zod validation and Inngest integration - `POST /api/chat/cancel` - Chat cancellation with run interruption events - `POST /api/approve-tool` - Human-in-the-loop tool approval system - `POST /api/realtime/token` - Real-time subscription token generation **Thread Management:** - `GET/POST /api/threads` - Thread listing and creation with pagination - `GET/DELETE/PATCH /api/threads/[threadId]` - Individual thread operations - Thread title generation and metadata management - Support for both authenticated and anonymous users **Integration:** - `/api/inngest/route` - Inngest function serving with runAgentChat - PostgresHistoryAdapter integration for persistent storage ## 🎨 Comprehensive UI Component Library **AI-Specific Elements:** - `Actions` & `Action` - Interactive action buttons with tooltips - `Branch` components - Conversation branching and navigation - `CodeBlock` - Syntax-highlighted code display with copy functionality - `Conversation` - Chat conversation containers with scroll management - `Image` - AI-generated image display components - `InlineCitation` - Citation cards and source referencing - `Loader` - Loading animations and states - `Message` components - Message display with avatars and content - `PromptInput` - Responsive chat input with model selection - `Reasoning` - Agent reasoning display with streaming support - `Sources` - Source material display and linking - `Suggestion` - AI suggestion chips and interactions - `Task` - Task display and management components - `Tool` - Tool call display with input/output views - `WebPreview` - Web page preview components **Chat Interface Components:** - `Chat` - Main chat interface with sidebar integration - `EmptyState` - Welcome screen with suggestions - `ChatHeader` - Header with actions and agent information - `ShareDialog` - Thread sharing functionality - Message parts for all content types (Text, Tool, Data, File, Source, etc.) - `MessageActions` - Copy, edit, regenerate, like/dislike functionality - `MessageEditor` - In-place message editing - Sidebar components (Desktop & Mobile) with thread management **Playground & Development Tools:** - `SqlPlayground` - Interactive SQL query interface - `SqlEditor` - SQL editing with syntax highlighting - `EphemeralChat` - Client-side only chat for demos - `MultiChat` - Multiple concurrent chat sessions - Tab management for multiple contexts **UI Primitives & Layout:** - Complete shadcn/ui component library integration - `Button`, `Card`, `Dialog`, `Sheet`, `Tabs` and 30+ UI primitives - Responsive layouts and mobile-first design - Dark/light theme support with CSS custom properties ## 🔧 Developer Experience Improvements **Example Applications:** - Multi-chat interface for concurrent conversations - SQL playground with chat integration - Thread-based routing (`/chat/[threadId]`) - Responsive design patterns **Build & Configuration:** - Next.js App Router integration - Tailwind CSS with custom design system - TypeScript throughout with strict type checking - Component composition patterns **Development Tools:** - Hot reload support for rapid development - Comprehensive prop interfaces and documentation - Modular component architecture - Mobile-responsive design patterns ## 🎯 Key Benefits - **Faster Development**: Pre-built components reduce implementation time - **Consistent UX**: Unified design system across all AgentKit applications - **Production Ready**: Battle-tested components with proper error handling - **Flexible Architecture**: Composable components for custom implementations - **Enhanced Documentation**: Clear guides for common integration patterns This release significantly enhances the AgentKit ecosystem with production-ready tools for building sophisticated AI chat applications. ### Minor Changes - 81c90df: # Comprehensive AgentKit Enhancements Major improvements to AgentKit with enhanced documentation, new API routes, comprehensive UI components, and example applications. ## 📚 Documentation Enhancements **New Advanced Pattern Guides:** - Added `legacy-ui-streaming.mdx` - Guide for UI streaming with useAgent hook - Added `use-chat.mdx` - Comprehensive guide for building chat interfaces - Added `use-threads.mdx` - Documentation for managing conversation threads - Added `use-agent.mdx` - Updated agent integration patterns **Documentation Reorganization:** - Moved UI streaming guides to dedicated UI Integration section - Enhanced advanced patterns with practical examples - Added sequence diagrams and usage guides ## ⚡ Revolutionary Automatic Event Streaming System **Comprehensive Streaming Architecture:** - **StreamingContext**: Hierarchical context management for network/agent runs with shared sequence counters - **Event Schema**: 15+ event types covering complete agent lifecycle (run.started, part.created, text.delta, tool calls, HITL, etc.) - **Automatic Enrichment**: Events auto-enriched with threadId, userId, and context metadata - **Sequence Management**: Monotonic sequence numbering for perfect event ordering across contexts - **Parent/Child Contexts**: Seamless context inheritance for agent runs within network runs - **Proxy-based Step Wrapper**: Transparent integration with Inngest steps without breaking existing code - **Best-effort Publishing**: Graceful error handling that never breaks agent execution - **OpenAI-Compatible IDs**: Automatic generation of tool call IDs within OpenAI's 40-character limit **Event Types Supported:** - **Lifecycle Events**: `run.started`, `run.completed`, `run.failed`, `run.interrupted` - **Content Streaming**: `text.delta`, `reasoning.delta`, `data.delta` - **Tool Integration**: `tool_call.arguments.delta`, `tool_call.output.delta` - **Part Management**: `part.created`, `part.completed`, `part.failed` - **HITL Support**: `hitl.requested`, `hitl.resolved` - **Metadata & Control**: `usage.updated`, `metadata.updated`, `stream.ended` **Developer Experience:** - **Zero Configuration**: Automatic context extraction from network state - **Debug Logging**: Comprehensive debug output for development - **Shared Sequence Counters**: Perfect event ordering across multiple contexts - **Flexible Publishing**: Configurable publish functions for any transport This streaming system enables real-time UI updates that perfectly match the `useAgent` hook expectations, creating seamless agent-to-UI communication. ## 🚀 New API Routes & Backend Features **Chat & Communication:** - `POST /api/chat` - Main chat endpoint with Zod validation and Inngest integration - `POST /api/chat/cancel` - Chat cancellation with run interruption events - `POST /api/approve-tool` - Human-in-the-loop tool approval system - `POST /api/realtime/token` - Real-time subscription token generation **Thread Management:** - `GET/POST /api/threads` - Thread listing and creation with pagination - `GET/DELETE/PATCH /api/threads/[threadId]` - Individual thread operations - Thread title generation and metadata management - Support for both authenticated and anonymous users **Integration:** - `/api/inngest/route` - Inngest function serving with runAgentChat - PostgresHistoryAdapter integration for persistent storage ## 🎨 Comprehensive UI Component Library **AI-Specific Elements:** - `Actions` & `Action` - Interactive action buttons with tooltips - `Branch` components - Conversation branching and navigation - `CodeBlock` - Syntax-highlighted code display with copy functionality - `Conversation` - Chat conversation containers with scroll management - `Image` - AI-generated image display components - `InlineCitation` - Citation cards and source referencing - `Loader` - Loading animations and states - `Message` components - Message display with avatars and content - `PromptInput` - Responsive chat input with model selection - `Reasoning` - Agent reasoning display with streaming support - `Sources` - Source material display and linking - `Suggestion` - AI suggestion chips and interactions - `Task` - Task display and management components - `Tool` - Tool call display with input/output views - `WebPreview` - Web page preview components **Chat Interface Components:** - `Chat` - Main chat interface with sidebar integration - `EmptyState` - Welcome screen with suggestions - `ChatHeader` - Header with actions and agent information - `ShareDialog` - Thread sharing functionality - Message parts for all content types (Text, Tool, Data, File, Source, etc.) - `MessageActions` - Copy, edit, regenerate, like/dislike functionality - `MessageEditor` - In-place message editing - Sidebar components (Desktop & Mobile) with thread management **Playground & Development Tools:** - `SqlPlayground` - Interactive SQL query interface - `SqlEditor` - SQL editing with syntax highlighting - `EphemeralChat` - Client-side only chat for demos - `MultiChat` - Multiple concurrent chat sessions - Tab management for multiple contexts **UI Primitives & Layout:** - Complete shadcn/ui component library integration - `Button`, `Card`, `Dialog`, `Sheet`, `Tabs` and 30+ UI primitives - Responsive layouts and mobile-first design - Dark/light theme support with CSS custom properties ## 🔧 Developer Experience Improvements **Example Applications:** - Multi-chat interface for concurrent conversations - SQL playground with chat integration - Thread-based routing (`/chat/[threadId]`) - Responsive design patterns **Build & Configuration:** - Next.js App Router integration - Tailwind CSS with custom design system - TypeScript throughout with strict type checking - Component composition patterns **Development Tools:** - Hot reload support for rapid development - Comprehensive prop interfaces and documentation - Modular component architecture - Mobile-responsive design patterns ## 🎯 Key Benefits - **Faster Development**: Pre-built components reduce implementation time - **Consistent UX**: Unified design system across all AgentKit applications - **Production Ready**: Battle-tested components with proper error handling - **Flexible Architecture**: Composable components for custom implementations - **Enhanced Documentation**: Clear guides for common integration patterns This release significantly enhances the AgentKit ecosystem with production-ready tools for building sophisticated AI chat applications. ### Minor Changes - 81c90df: # New Package: @inngest/use-agent Introducing a comprehensive React hooks package for building AI chat interfaces with AgentKit networks. ## What's New **@inngest/use-agent** is a standalone npm package that provides a complete set of React hooks for integrating with AgentKit. This package extracts and consolidates all the React functionality needed to build sophisticated AI chat applications. ### Core Features - **Core Hooks**: `useAgent`, `useChat`, `useThreads` for real-time streaming and thread management - **Utility Hooks**: `useEphemeralThreads`, `useConversationBranching`, `useEditMessage`, `useMessageActions`, `useSidebar`, `useIsMobile` - **Provider System**: `AgentProvider` for shared connections and configuration - **Transport Layer**: Configurable API layer with `DefaultAgentTransport` and custom transport support - **TypeScript Support**: Full type definitions for all hooks and components - **Next.js Compatibility**: All hooks properly marked with "use client" directives ### Installation ```bash npm install @inngest/use-agents # Peer dependencies npm install react @inngest/realtime uuid ``` ### Basic Usage ```typescript import { useChat, AgentProvider } from '@inngest/use-agents'; function App() { return ( ); } function ChatComponent() { const { messages, sendMessage, status } = useChat(); return

/* Your chat UI */