Release v1.5.0

- **Extension system with a LangChain template.** `agents-cli` can now be extended with custom commands and add-on agent templates, shipped with a LangChain extension and authoring guides. Extensions install from GitHub, other git hosts (including self-hosted and enterprise servers), or a local path for development.
- Add `agents-cli infra show` to inspect the Terraform configuration provisioned by `agents-cli infra single-project`.
- Add `--update-only` to `agents-cli deploy`, so a deploy updates an existing Agent Runtime engine instead of creating a duplicate.
- Add a `--labels` flag to `agents-cli deploy` to tag Agent Runtime and Cloud Run deployments.
- Add `--qps` to `agents-cli eval` that controls the request rate instead of being throttled to the default value.
- Name the scaffolded root agent after its project instead of a generic default.
- `agents-cli deploy` now retries throttled Agent Platform calls.
- `agents-cli create` now reports precondition failures as clear errors instead of exiting successfully or printing a traceback.
  - #68
- Fix background server reuse ignoring the requested session mode.
  - #70
- Fix `reasoning_engine_adapter` streaming returning an empty response.
  - #80
- Prevent multi-region deployments in scaffold and deploy.
  - #81
- Give a clear error for malformed project manifests instead of silently defaulting or printing a traceback.
  - #74
- Fix stale command references in docs and CLI hints.
  - #77
- Scaffolded A2A agents now forward tool calls and responses to clients, not just text.
- `agents-cli setup` now works without network or git access, with skills bundled into the package.
- Fix a Windows failure loading a scaffolded project whose config points at a local path.

Release v1.4.2

- Adds upper-bound for google-cloud-aiplatform dependency.

Release v1.4.1

- Scaffolds now default to `gemini-3.7-flash`.
- `agents-cli eval generate` no longer fails to generate traces for some agents.
- `agents-cli deploy` now defaults to `--min-instances 0` (was `1`) on Agent Runtime and Cloud Run, so that idle dev and demo agents don't take up resources.
- `agents-cli scaffold upgrade` now creates a project backup before applying changes, just like `agents-cli scaffold enhance`.
- Fixed `npx skills find` to use the pinned `skills` version.
  - #72
- Fixed an arbitrary file write vulnerability in `agents-cli scaffold create`.
  - #50

Release v1.4.0

- Add Agent Gateway support to `agents-cli deploy`
- Improve A2A-on-Agent-Runtime and MCP Agent Registry guidance in skills
- Use token-based context compaction in ADK cheatsheet
- Add held-out case guidance during iteration to the eval skill
- Remove built-in feedback endpoint, add guidance on building a feedback mechanism to the observability skill instead
- Display project language in `agents-cli info`
- Use $GH_TOKEN and $GITHUB_TOKEN environment variables as fallbacks for `--github-pat`
  - #18
- Populate class_methods contract on agent_runtime deploy
  - #55

Release v1.3.1

- Add agent-plugins.org plugin manifest
- Smarter backoff handling for CICD command
- Rollback to npx skills 1.5.9 to avoid a spurious error message during `setup`
  - #59

Release v1.3.0

- Update to use A2A 1.0 throughout, with a compatibility layer for A2A 0.3 clients
- Improve retry for Cloud Run deploy
- Streamline retry handing for `infra cicd` command
- Fix `npx skills` output formatting during setup and update
- Print Cloud Logging URL at Agent Runtime deploy start
- Add --concurrency and --header flags to eval generate/run
- Tweak messages around `--session-type` when used with `agent_runtime`

Release v1.2.1

- Fix an import problem on `uv sync` caused by a yanked `opentelemetry-resourcedetector-gcp` version
- Add optional HTTP-based path for `eval generate` using `--url` (in-progress feature, stay tuned)

Release v1.2.0

- **Cloud telemetry moved to ADK's `otel_to_cloud`, across the CLI and deploys.** `playground` and `run` gain an `--otel-to-cloud` flag that forwards ADK's current `--otel_to_cloud`; the old `--trace-to-cloud` stays as a hidden, still-functional alias that warns when used. On the deployment side, Agent Runtime now exports through `otel_to_cloud` (gated on `GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY`) and generated projects configure Cloud telemetry declaratively in Terraform instead of at runtime. Bundled `google-adk` moves to `>=2.2.0` with the `otel-gcp` extra, and the observability skill was updated to match.
- Scaffolds now default to `gemini-3.6-flash`.
- **Agent Analytics now captures GenAI completions on Agent Runtime.** The BigQuery telemetry log sink is configured per deployment target, so Agent Runtime deployments route their GenAI request/response logs into BigQuery instead of leaving the completions view empty.
- **Managed Agents guidance in the ADK code skill.** The bundled ADK cheatsheet gained a Managed Agents section covering when to use `ManagedAgent`, Gemini API vs Agent Platform (GEAP) setup, and a runnable create-and-use example.

Release v1.1.0

- **Guided brainstorming for new agents.** The workflow skill's Phase 0 is now an interactive brainstorming dialogue that helps you shape an agent's spec before any code is written, and surfaces its assumptions for review when it can't ask.
- `eval generate` and `eval grade` no longer clutter output with benign third-party warnings and progress bars that never affected results. This output is still shown on failure and can be re-enabled for debugging.
- Generated projects now name the default scaffolded eval metric module `tests/eval/response_quality.py` (was `metrics.py`) to match the metric it implements.
- Broad Windows compatibility fixes across the CLI.
- Fixed a command-name typo in user-facing hints so they point to the correct `agents-cli` command.
- Refreshed the bundled skills, including pointing the RAG samples at `core/python/` in `google/adk-samples`.

Release v1.0.0

**Agents CLI is now 1.0 — Generally Available.** This is our first GA release: a stable, production-ready CLI for scaffolding, evaluating, and deploying ADK agents on Google Cloud.

- Redeploys now preserve the existing deployment spec on Agent Runtime and Cloud Run instead of resetting unspecified settings.
- Agent Runtime deploys now honor `.gcloudignore` and `.gitignore` when packaging source, so uploads no longer include ignored files.
- RAG is now a clone-and-study recipe: start from the `rag-vector-search` / `rag-agent-search` samples in `google/adk-samples` (surfaced via the workflow skill). The `agentic_rag` template, the `--datastore` flag, and the `infra datastore` / `data-ingestion` commands were removed and now print a redirect.
- Generated projects now consolidate Python environment configuration into a single templated `.env` file.
- Eval commands now tolerate ADK toolsets when introspecting eval metadata, so agents that use toolsets no longer fail metadata collection.
- GKE Cloud Build deploys are now resilient to log-streaming limits and no longer fail when the build log stream is truncated.
- Refreshed the bundled skills: RAG samples point to `core/` on adk-samples `main`, the always-active workflow skill was generalized and trimmed, and the ADK code guidance notes `streaming_agent_run_with_events` for debugging on Agent Runtime.