@coder/ai-sdk-agent weekly downloads statistics

@coder/ai-sdk-agent

A Vercel AI SDK agent backed by Coder Agents, Coder's server‑side agent runtime. new CoderAgent(...) implements the AI SDK's Agent interface (generate() / stream()): script it, stream from it, and attach your own tools exactly like the SDK's own ToolLoopAgent.

Coder Agents runs the complete agent loop server‑side: the multi‑step tool loop, built‑in tools, MCP, sub‑agents, multi‑provider model routing, and automatic context compaction. This package bridges it to the AI SDK's client‑side loop without re‑implementing the loop.

Status: targets Coder's stable chat API (/api/v2/chats), available since Coder 2.37.0 (September 1, 2026). This package remains pre‑1.0. See API compatibility for older deployments.

Contents

Get started	Build	Reference	Run in production
Install	Custom tools	Auth	Timeouts & cancellation
Quick start	Files	Configuration	Handling errors
Examples	Structured output	API compatibility	Cleanup
Agent vs. provider	Sessions	How it works	Usage & cost
	Rehydrating chat history	Testing	Observability
	Watching chats	Limitations	Workspaces & quota
	Workspace previews		Durable workflows
	Sources

Agent vs. provider — which package?

	@coder/ai-sdk-agent (this package)	@coder/ai-sdk-provider
What runs	Coder's server‑side agent: tool loop, built‑in tools, MCP servers, workspace‑scoped file/shell tools, sub‑agents, and compaction, on the deployment	Plain model calls through Coder's AI Gateway. A normal AI SDK provider: generateText, streamText, generateObject
Server state	Each CoderAgent is one server chat ("session"), bound to at most one workspace	No chat, no workspace; natively cancelable
Structured output	Through a tool call (Structured output)	generateObject, schema‑constrained
Reach for it when	You need server‑side tools, MCP, or a workspace	You just need a model (plan / extract / summarize / classify)

They compose: a multi‑step pipeline often uses the provider for its pure text/JSON steps and the Agent only for the steps that touch tools.

Install

pnpm add @coder/ai-sdk-agent ai@^7 zod

Requires Node ≥ 22 and ai v7. The constructors throw an actionable error when another ai major is detected, instead of failing cryptically mid‑generation. The guard fails open when the installed version can't be resolved.

Quick start

import { CoderAgent } from "@coder/ai-sdk-agent";
import { tool } from "ai";
import { z } from "zod";…