Release 3.0.0

Agentuity SDK v3.0.0 — the first stable v3 release. This is the cumulative changelog for the v3 line (alpha/beta included).

New Features

• #1255 V3: framework-agnostic deploy pipeline and standalone service clients (Gabriel Rodrigues Campos).
• #1334 Added a framework-agnostic build pipeline for CNB/Buildpack support (Gabriel Rodrigues Campos).
• #1419 Added Node 24+ runtime support and introduced a dedicated @agentuity/storage package (Gabriel Rodrigues Campos).
• #1445 Service augments in the CLI: translation demo with optional DB/KV/Queue/Vector/Storage integrations (Gabriel Rodrigues Campos).
• #1444 Added AI Gateway support to Agentuity Coder (Jeff Haynie).
• #1440 Added a sandbox create wait option (Jeff Haynie).
• #1418 Added multi-select resource setup in project creation with resource name suggestions (Gabriel Rodrigues Campos).
• #1429 Added an auth project template (Parteek Singh).
• Added zero-config agentuity deploy support for vanilla JavaScript/TypeScript projects (Gabriel Rodrigues Campos).
• Added detection of existing framework projects in agentuity project create (Gabriel Rodrigues Campos).
• Added a v2→v3 migration mode (@agentuity/migrate) for upgrading projects (Gabriel Rodrigues Campos).
• Added the file-infra-issue skill to help file deduplicated infra issues for platform-side breakage (Gabriel Rodrigues Campos).

Breaking Changes

• #1255 The deploy pipeline is now framework-agnostic, and service clients are now standalone in v3 (Gabriel Rodrigues Campos).
• #1367 Sunset @agentuity/runtime and removed the v2 build pipeline and agent system (Gabriel Rodrigues Campos).
• Breaking: @agentuity/keyvalue and @agentuity/vector search/result types were aligned with the rest of the SDK, requiring type updates in existing integrations (Gabriel Rodrigues Campos).
• Deprecated @agentuity/postgres and @agentuity/drizzle (Gabriel Rodrigues Campos).
• Deprecated agentuity.config.ts in favor of migration-driven configuration (@agentuity/migrate) (Gabriel Rodrigues Campos).

Improvements

• #1432 Added Coder workspace snapshot inputs (Bobby Christopher).
• Improved CLI snapshot/sandbox org resolution and org ID handling across snapshot creation flows (#1433, #1438, Jeff Haynie).
• #1436 Improved fatal CLI output by hiding raw error codes from users (Jeff Haynie).
• #1435 Improved CLI project loading by supporting explicit project config paths (Jeff Haynie).
• Added fallback loading of AGENTUITY_SDK_KEY from project .env files and fallback to CLI auth key for AI Gateway when no project is linked (Gabriel Rodrigues Campos).
• #1447 Added startup cleanup to sweep old gravity versions after successful startup (Jeff Haynie).

Bug Fixes

• #1500 Fix(migrate): emit SIGINT/SIGTERM handlers in generated src/index.ts (Gabriel Rodrigues Campos).
• #1479 Fix(cli): avoid duplicate whoami JSON output (Jeff Haynie).
• Fixed template overlay behavior so copied files correctly overwrite defaults (cpSync with force: true) (Gabriel Rodrigues Campos).
• Fixed prerelease scaffolding behavior: dist-tag derivation/mapping and fallback major version handling for v3 prereleases (Gabriel Rodrigues Campos).
• Fixed package metadata normalization for npm provenance/repository URL consistency (Gabriel Rodrigues Campos).
• Fixed production server startup to prevent double Bun.serve() and EADDRINUSE failures (Gabriel Rodrigues Campos).
• Fixed Bun hot mode integration by including websocket handler in AppResult (Gabriel Rodrigues Campos).
• Fixed runtime frontend path resolution issues for nested Vite builds (index.html and client directory handling) (Gabriel Rodrigues Campos).
• Fixed CLI client build compatibility by spawning Vite as a subprocess for plugin compatibility (Gabriel Rodrigues Campos).
• Fixed AI Gateway fallback to use a regional Catalyst URL when needed (Gabriel Rodrigues Campos).
• Fixed @agentuity/core service imports by adding explicit subpath exports (Gabriel Rodrigues Campos).

Documentation

• #1420 Corrected v2 auth setup documentation (Parteek Singh).

Internal

• Updated smoke test DB execution to pass required org/database env vars and region settings, and temporarily skipped DB smoke pending SDK-key DB auth (#120, Gabriel Rodrigues Campos).
• #1430 Removed duplicated smoke tests to reduce CI duplication and maintenance overhead (Parteek Singh).
• Improved release/CI pipeline behavior (Node 24 action alignment, package build ordering, branch dist-tag handling, and PR npm branch publish flow) (Gabriel Rodrigues Campos).
• Added comprehensive CLI dev server lifecycle/public-folder test coverage and expanded testing-app validation paths (Gabriel Rodrigues Campos).
• Added release-note generation caching in publish tooling to avoid repeated OpenCode runs (Gabriel Rodrigues Campos).