Release 2.0.0

Important

This is a breaking change release! But we've made it easy to migrate automatically. See Migration Guide to make it painless and explain changes or use npx @agentuity/migrate to migrate your project for you

🥇 a special thanks to @Huijiro for leading the v2 development effort (along with his trusty agent, Agentuity Coder)

New Features

• #1167 Major v2 architecture: agents and routes are now explicitly registered via createApp() instead of auto-discovered from the filesystem — Gabriel Rodrigues Campos
• #1167 New @agentuity/migrate package (npx @agentuity/migrate) to automate v1→v2 migration, including deleting src/generated/, rewriting routes to chained Hono style, generating barrel files, and removing bootstrapRuntimeEnv() — Gabriel Rodrigues Campos
• #1167 Version mismatch detection warns when @agentuity/* packages have conflicting versions — Gabriel Rodrigues Campos
• #1167 Deprecation warnings when v1 packages are used with the v2 runtime — Gabriel Rodrigues Campos
• #1291 Add scopes option to sandbox creation for fine-grained permission opt-in, and warning/warningTitle fields to OAuth permission levels — Jeff Haynie
• #1289 Add agentuity cloud sandbox job logs command to stream stdout/stderr from sandbox jobs, with --follow, --stderr, --timestamps, --grep, and --tail options — Jeff Haynie

Breaking Changes

• #1167 Agents must be explicitly imported and passed to createApp({ agents }) — file-based auto-discovery from src/agent/*/agent.ts is removed — Gabriel Rodrigues Campos
• #1167 Routes must use an explicit Hono router passed to createApp({ router }) — file-based routing from src/api/*.ts is removed — Gabriel Rodrigues Campos
• #1167 createRouter() wrapper is removed; use new Hono<Env>() with chained methods directly — Gabriel Rodrigues Campos
• #1167 setup and shutdown hooks removed from createApp(); use module-level initialization and process.on("beforeExit", ...) instead — Gabriel Rodrigues Campos
• #1167 createClient, useAPI, useEventStream, and useWebsocket removed from @agentuity/react; use hc<AppRouter>() from hono/client or any data-fetching library instead — Gabriel Rodrigues Campos
• #1167 Client helpers (eventstream, websocket, stream) removed from @agentuity/frontend; use hono/client directly — Gabriel Rodrigues Campos
• #1167 agentuity.config.ts no longer handles Vite configuration; use a standard vite.config.ts and move runtime settings to createApp() — Gabriel Rodrigues Campos

Improvements

• #1167 Removed ~5,000 lines of build-time AST-based code generation (ast.ts, entry-generator.ts, workbench.ts, route-migration.ts) in favor of a simplified config extractor — Gabriel Rodrigues Campos
• #1167 Dev server now uses bun --hot for backend HMR instead of manual file-watching restart loop — Gabriel Rodrigues Campos
• #1167 Server lifecycle (analytics, workbench, static serving, middleware) extracted from createApp() into dedicated bootstrap helpers — Gabriel Rodrigues Campos
• #1289 Centralized streaming into a shared utility with consistent cancellation, byte/chunk reporting, line/raw modes, and filtering/tailing behavior — Jeff Haynie

Bug Fixes

• #1288 Fixed create-agentuity dist-tag logic so bun create agentuity@next correctly resolves beta versions (e.g., 2.0.0-beta.1 now maps to the beta dist-tag instead of next) — Gabriel Rodrigues Campos

Documentation

• #1290 Reorganized documentation: consolidated APIs content into Agents and Routes sections, added "Agents vs Routes" guide and "Calling Agents from Routes" page, and set up redirects from old API doc URLs — Parteek Singh
• #1167 Added v1→v2 migration guide — Gabriel Rodrigues Campos