[release] v0.99.2

[github-actions]

New version v0.99.2 in

• (web)
• web/oss
• web/ee
• sdk
• api
• services

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview, Comment	May 6, 2026 2:44pm

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• New Features

  • Commit messages can be omitted when saving or committing workflows and test sets (accepts null/undefined).

• Chores

  • Released v0.99.2 across packages and bumped various dependencies.
  • Added database migration and accompanying SQL guidance to migrate built-in workflow schemas.
  • Updated CI workflows and test dependency manifests to modernize caching and test setups.

Walkthrough

Adds an Alembic migration wired to a new data-migration that canonicalizes built-in application workflow schemas, a SQL reference for the migration, UI/type changes to allow nullable commit messages, package version/dependency bumps, and CI workflow cache/install adjustments.

Changes

Workflow Schema Canonicalization

Layer / File(s)	Summary
Data Shape / Canonical Source api/oss/databases/postgres/migrations/core/data_migrations/workflow_revision_schemas.py, docs/design/workflow-revision-schema-migration/pgadmin-chat-completion-schemas.sql	Defines BUILTIN_APPLICATION_URIS, helpers to load/parse catalog entries, and canonical schemas; SQL doc shows canonical table, preview, update, and verification queries.
Core Migration Logic api/oss/databases/postgres/migrations/core/data_migrations/workflow_revision_schemas.py	Implements upgrade_builtin_application_workflow_revision_schemas(session) to replace workflow_revisions.schemas JSONB for listed URIs; downgrade_... raises NotImplementedError.
Alembic Wiring (OSS & EE) api/oss/databases/postgres/migrations/core/versions/e6f7a8b9c0d1_update_builtin_application_workflow_schemas.py, api/ee/databases/postgres/migrations/core/versions/e6f7a8b9c0d1_update_builtin_application_workflow_schemas.py	New revision files declare revision metadata and delegate upgrade()/downgrade() to the data-migration functions using context.get_bind().

Commit Message Nullability

Layer / File(s)	Summary
Type Definitions web/packages/agenta-entities/src/workflow/api/api.ts, web/packages/agenta-entity-ui/src/modals/types.ts, web/oss/src/state/entities/testset/mutations.ts, web/oss/src/services/testsets/api/index.ts	Widened commit/message types to `string
UI Call Sites / Normalization web/oss/src/components/Playground/Components/Modals/CommitVariantChangesModal/index.tsx, web/oss/src/components/Playground/Components/TestsetDropdown/index.tsx, web/packages/agenta-entity-ui/src/modals/commit/components/EntityCommitModal.tsx	Call sites now pass commitMessage ?? undefined or `trim()

Repo Version, Dependency, and CI Updates

Layer / File(s)	Summary
Package Versions & Dependencies api/pyproject.toml, sdk/pyproject.toml, services/pyproject.toml, web/package.json, web/oss/package.json, web/ee/package.json, web/packages/*/package.json, web/packages/agenta-shared/package.json, docs/package.json	Bumped many package versions from 0.99.1 → 0.99.2; updated dependency constraints (agenta, daytona, uuid, postcss, next, etc.) and adjusted dev deps (pytest, pytest-asyncio).
Test Requirements Cleanup api/oss/tests/requirements.txt, sdk/oss/tests/requirements.txt, api/oss/tests/legacy/requirements.test.txt, sdk/oss/tests/legacy/new_tests/requirements.test.txt	Cleared some oss test requirements files and loosened pins for pytest-asyncio and python-dotenv in legacy test requirement files.
CI Workflows .github/workflows/12-check-unit-tests.yml, .github/workflows/44-railway-tests.yml	Adjusted cache key inputs to exclude per-test requirements, simplified install steps to use editable SDK installs, and expanded/rewired services test env and install steps.

Sequence Diagram(s)

sequenceDiagram
    participant Alembic as Alembic migration
    participant DataMig as Data-migration module
    participant Catalog as Catalog (catalog storage)
    participant DB as Postgres (workflow_revisions)

    Alembic->>DataMig: upgrade(session=connection)
    DataMig->>Catalog: fetch canonical entry for URI
    Catalog-->>DataMig: canonical schema JSON
    DataMig->>DB: UPDATE workflow_revisions SET schemas = canonical WHERE uri IN (...)
    DB-->>DataMig: rows updated count
    DataMig-->>Alembic: return / print summary

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

• Agenta-AI/agenta#4283: Related CI workflow cache key and dependency bump changes.
• Agenta-AI/agenta#4279: Adds same Alembic and data-migration files for workflow schema canonicalization.
• Agenta-AI/agenta#4280: Parallel commit message nullability changes across UI and type files.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 60.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title '[release] v0.99.2' clearly and concisely summarizes the main change—a version release. It is specific, relates directly to the changeset, and follows conventional release naming.
Description check	✅ Passed	The description lists the packages affected by the v0.99.2 release (web, web/oss, web/ee, sdk, api, services) and is directly related to the changeset. While brief, it provides meaningful information about which components are included.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release/v0.99.2

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Railway Preview Environment

Status	Destroyed (PR closed)

Updated at 2026-05-06T15:09:14.980Z

[coderabbitai]

🧹 Nitpick comments (3)

api/oss/tests/legacy/requirements.test.txt (1)

1-9: ⚡ Quick win

Legacy requirements file appears disconnected from the active test install path.

Line 1 and Line 8 adjust pins here, but CI installs API test deps via uv sync --locked from api/pyproject.toml/api/uv.lock (.github/workflows/12-check-unit-tests.yml, Lines 142–161). This creates drift risk where edits in this file don’t affect real test environments. Consider removing this file or explicitly wiring a job/script that consumes it.

web/packages/agenta-ui/package.json (1)

56-56: ⚡ Quick win

Consider aligning peerDependency version with the actual dependency.

The peerDependencies specifies uuid: ">=9.0.0" (line 56) while the dependencies section now uses uuid: "^11.1.1" (line 94). If uuid 11.x introduced API changes that your code depends on, consumers using uuid 9.x or 10.x might encounter runtime issues. Consider updating the peer dependency to >=11.0.0 to accurately reflect the minimum supported version.

♻️ Suggested fix

     "peerDependencies": {
         ...
-        "uuid": ">=9.0.0"
+        "uuid": ">=11.0.0"
     },

Also applies to: 94-94

sdk/oss/tests/legacy/new_tests/requirements.test.txt (1)

1-9: 💤 Low value

Remove this orphaned requirements file.

This file is no longer used by the test infrastructure. The CI workflows now use uv sync --locked which reads from pyproject.toml and uv.lock, not from this requirements file. No test configuration or scripts in the codebase reference it. Removing it will eliminate confusion about which dependency specifications are authoritative.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 646a949b-954f-497c-b608-f662219c1476

📥 Commits

Reviewing files that changed from the base of the PR and between a0f386e and 15faddf.

⛔ Files ignored due to path filters (9)

• api/uv.lock is excluded by !**/*.lock
• docs/package-lock.json is excluded by !**/package-lock.json
• docs/pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
• examples/node/observability-opentelemetry/pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
• examples/node/observability-vercel-ai/package-lock.json is excluded by !**/package-lock.json
• examples/python/RAG_QA_chatbot/frontend/pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
• sdk/uv.lock is excluded by !**/*.lock
• services/uv.lock is excluded by !**/*.lock
• web/pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (19)

• .github/workflows/12-check-unit-tests.yml
• .github/workflows/44-railway-tests.yml
• api/oss/tests/legacy/requirements.test.txt
• api/oss/tests/requirements.txt
• api/pyproject.toml
• docs/package.json
• sdk/oss/tests/legacy/new_tests/requirements.test.txt
• sdk/oss/tests/requirements.txt
• sdk/pyproject.toml
• services/pyproject.toml
• web/ee/package.json
• web/oss/package.json
• web/package.json
• web/packages/agenta-entities/package.json
• web/packages/agenta-entity-ui/package.json
• web/packages/agenta-playground-ui/package.json
• web/packages/agenta-playground/package.json
• web/packages/agenta-shared/package.json
• web/packages/agenta-ui/package.json

💤 Files with no reviewable changes (2)

• api/oss/tests/requirements.txt
• sdk/oss/tests/requirements.txt

🚧 Files skipped from review as they are similar to previous changes (1)

• web/ee/package.json