Skip to content

Commit 2c39459

Browse files
committed
release v1.8.0 at 2026-09-30 11:14:13 UTC
1 parent e556c95 commit 2c39459

66 files changed

Lines changed: 3029 additions & 2010 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "google-agents-cli",
3-
"version": "1.7.0",
3+
"version": "1.8.0",
44
"description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles skills for the agent development lifecycle.",
55
"author": { "name": "Google LLC" },
66
"homepage": "https://github.com/google/agents-cli",

‎README.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,8 @@ See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tut
116116

117117
</details>
118118

119+
120+
119121
## How it works
120122

121123
<div align="center">
@@ -165,6 +167,42 @@ The best way to contribute is through feedback: bug reports, feature requests, a
165167

166168
See the [contributing guide](CONTRIBUTING.md) for details.
167169

170+
## Telemetry
171+
172+
> **Note:** Telemetry is experimental and off by default. It only runs when
173+
> enabled with `AGENTS_CLI_EXPERIMENTS='{"cli_telemetry": true}'`.
174+
175+
`agents-cli` can emit a single usage signal per command invocation to help
176+
improve the tool and better understand how it's used. Each signal
177+
is a structured log entry written to **your own Google Cloud project**:
178+
`GOOGLE_CLOUD_PROJECT`, or else the default project of your Application Default
179+
Credentials (`logName=projects/<project>/logs/agents-cli`), where you can query
180+
it in Cloud Logging. It records only the metadata such as command name
181+
(e.g. `deploy`, `scaffold.create`), exit code, error class, duration (measured
182+
from command dispatch to exit, so it excludes CLI startup), CLI/Python versions,
183+
and OS — never file contents, arguments, or other input. Commands added by
184+
extensions are recorded without their names.
185+
186+
The request that writes the entry also carries usage metadata in its
187+
`User-Agent` and `X-Goog-Api-Client` headers, which Google receives for
188+
agents-cli usage analytics: the CLI and Python versions, the OS and its release,
189+
the CPU architecture, the command name and a random per-invocation ID. The log
190+
entry's contents, such as the exit code, error class and duration, stay in your
191+
project.
192+
193+
To opt out of sending telemetry, use one of the following environment variables:
194+
195+
```bash
196+
# our cli-specific variable
197+
# 0, false, no, or off (case-insensitive):
198+
export AGENTS_CLI_TELEMETRY=0
199+
200+
# donottrack.sh standard variable
201+
export DO_NOT_TRACK=1
202+
```
203+
204+
Use `agents-cli info` to see the current telemetry state.
205+
168206
## Terms of Service
169207

170208
`agents-cli` leverages Google Cloud APIs. When you deploy agents, you'll be deploying resources in your own Google Cloud project and will be responsible for those resources. Please review the [Google Cloud Service Terms](https://cloud.google.com/terms/service-terms) for details.

‎RELEASE_NOTES.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,26 @@
33
All notable changes to this project will be documented in this file.
44

55

6+
## [1.8.0] - 2026-09-30
7+
8+
- New flag for`agents-cli scaffold upgrade`: `--force`. A fallback for when the 3-way merge cannot run or leaves too many conflicts, similar to the existing flag for `agents-cli scaffold enhance`. It generates only the new template and overwrites the scaffolding files:
9+
- Agent code, config files and files you own are kept: your tests, custom eval metrics, eval datasets, READMEs, agent guidance files, `.gitignore`, `deployment_metadata.json` and Terraform `env.tfvars` files.
10+
- Dependencies are merged as a union. For a dependency in both files the template's version wins, and dependencies only your project has are kept.
11+
- `agents-cli scaffold upgrade` keeps your Terraform `env.tfvars` files instead of treating them as template files.
12+
- `agents-cli scaffold upgrade` and `agents-cli scaffold enhance` stop with an error when writing the merged dependencies fails. Previously they reported success and stamped the new version, so a rerun said "already at version" and could not retry.
13+
- `agents-cli run --mode a2a` sends messages and your bearer token only to the `--url` host, not to the endpoint declared in the agent card.
14+
- https://github.com/google/agents-cli/issues/46
15+
- Two concurrent `agents-cli deploy` deploys no longer overwrite each other's deployment state.
16+
- https://github.com/google/agents-cli/issues/76
17+
- Clarified the documentation on when to use `agents-cli infra single-project --apply` for deployments.
18+
- https://github.com/google/agents-cli/issues/79
19+
- Generated CI/CD Terraform for Cloud Build now waits for the CI/CD service account's IAM grants to propagate before creating build triggers, so the first push after `agents-cli infra cicd` no longer fails on missing permissions.
20+
- Generated CI/CD Terraform grants Artifact Registry read access on the app's own repository instead of the whole CI/CD project. Destroying one project's infrastructure no longer breaks image pulls for other projects sharing the CI/CD project. A deploy project that relied on the project-wide grant to read another repository loses that access.
21+
- `agents-cli deploy` prints pod state, pod descriptions and namespace events when a GKE rollout does not finish.
22+
- Changed the formatting of some error messages so that they stand out more.
23+
- Updated the ADK version in scaffolded projects to `google-adk>=2.9.2,<3.0.0`.
24+
- Added experimental usage telemetry, off by default. Enable it with `AGENTS_CLI_EXPERIMENTS='{"cli_telemetry": true}'`. It writes one log entry per command to your own Cloud project, with the command, exit code, error class, duration, and CLI, Python and OS versions (but not arguments). Opt out with `AGENTS_CLI_TELEMETRY=0` or `DO_NOT_TRACK=1`.
25+
626
## [1.7.0] - 2026-09-22
727

828
- **Live (voice) agents now work in `run` and `eval`.** Pass `--mode adk_live` wherever you already pass `--mode adk`:
@@ -18,6 +38,8 @@ All notable changes to this project will be documented in this file.
1838
- `agents-cli deploy` and scaffolded Terraform both set `identity_type = SERVICE_ACCOUNT` on the Agent Runtime engine, so an agent keeps its service account when Agent Runtime changes that default to Agent Identity.
1939
- `agents-cli scaffold create --agent <remote URL>` handles symlinks again. Since 1.4.1 every symlink in a remote template was dropped, so a template that shared a library across variants scaffolded a project that failed at import. Links inside the cloned repo are copied as real file contents, and a link pointing outside it stops the scaffold with an error.
2040
- https://github.com/google/agents-cli/issues/89
41+
- `agents-cli deploy` gets a new flag `--framework`, which sets the `agent_framework` property on the deployed agents.
42+
- https://github.com/google/agents-cli/issues/63
2143
- The generated Cloud SQL password no longer lands in Terraform state. State lives in `gs://{cicd_project}-terraform-state`, whose default IAM let anyone with Viewer on the CI/CD project read the prod database password. Generated Terraform now needs Terraform 1.11.0 or later.
2244
- Scaffolded projects need `google-adk>=2.8.0`. 2.7.x does not emit `interactionStatus`, so a Live turn boundary falls back to a heuristic there. The `<2.9.0` cap from 1.6.1 is unchanged.
2345
- The deprecated `--trace-to-cloud` alias is gone from `agents-cli playground` and `agents-cli run`. Use `--otel-to-cloud`.

‎docs/src/guide/deployment.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ agents-cli scaffold enhance -d cloud_run
5555
Run `agents-cli scaffold enhance --help` to see all available options.
5656

5757
!!! tip
58-
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project` after deploying. Terraform provisions the telemetry resources and updates your service to use them. See the [Observability Guide](observability/index.md) for details.
58+
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project --apply` before deploying. Terraform provisions the telemetry resources, and the subsequent deploy uses them. See the [Observability Guide](observability/index.md) for details.
5959

6060
**Verify it works:**
6161

‎docs/src/guide/development.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,7 @@ Once the eval scores are good enough, deploy to Google Cloud.
118118
```
119119

120120
!!! tip
121-
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project` after deploying. See the [Observability Guide](observability/index.md) for details.
121+
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project --apply` before deploying. See the [Observability Guide](observability/index.md) for details.
122122

123123
For production pipelines with staging, approval gates, and CI/CD, see [Deployment](deployment.md) and [CI/CD & Production](cicd.md).
124124

‎docs/src/guide/extensions/first-party.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The LangChain template runs a [LangChain](https://python.langchain.com) agent th
2424

2525
```bash
2626
agents-cli create my-agent \
27-
--agent google/agents-cli/extensions/langchain/template@v1.7.0 \
27+
--agent google/agents-cli/extensions/langchain/template@v1.8.0 \
2828
-d cloud_run
2929
cd my-agent && agents-cli install
3030
```
@@ -66,7 +66,7 @@ AGENTS_CLI_DISABLE_OVERRIDES=1 agents-cli run --url https://<service-url> --mode
6666
### Full journey
6767

6868
```bash
69-
agents-cli create my-agent --agent google/agents-cli/extensions/langchain/template@v1.7.0 -d cloud_run
69+
agents-cli create my-agent --agent google/agents-cli/extensions/langchain/template@v1.8.0 -d cloud_run
7070
cd my-agent && agents-cli install
7171
agents-cli run "what's the weather in San Francisco?" # in-process graph
7272
agents-cli eval generate --dataset tests/eval/datasets/basic-dataset.json -o tests/eval/output/

‎docs/src/guide/hands-on-tutorial.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -231,7 +231,7 @@ Cloud Trace is enabled by default — no configuration needed. Send a few reques
231231
To inspect the actual prompts and responses your agent handles in production, provision the observability infrastructure:
232232

233233
```bash
234-
agents-cli infra single-project --project YOUR_DEV_PROJECT_ID
234+
agents-cli infra single-project --apply --project YOUR_DEV_PROJECT_ID
235235
```
236236

237237
This runs Terraform to create a dedicated service account, GCS bucket, and BigQuery dataset — and updates your deployed service to use them.

‎docs/src/guide/quickstart-tutorial.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ To go further and inspect the actual prompts and responses your agent handles in
139139

140140
> *"Set up observability infrastructure for my agent"*
141141
142-
Your coding agent runs `infra single-project`, which provisions the service account, GCS bucket, and BigQuery dataset — and updates the deployed service to use them. See the [Observability Guide](observability/index.md) for verification steps and advanced options.
142+
Your coding agent runs `infra single-project --apply`, which provisions the service account, GCS bucket, and BigQuery dataset — and updates the deployed service to use them. See the [Observability Guide](observability/index.md) for verification steps and advanced options.
143143

144144
---
145145

‎docs/src/reference/from-agent-starter-pack.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@ agents-cli supports the `adk` template (Python), with A2A built into every ADK a
5454
- **Terraform** — same infrastructure-as-code under `deployment/terraform/`
5555
- **CI/CD pipelines** — same Cloud Build and GitHub Actions configurations
5656

57+
58+
5759
---
5860

5961
## Migrating an Existing Project

‎extensions/langchain/template/.agents/skills/agents-cli-langchain/references/langchain.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Wrap them in a `StateGraph` node if you need to bring one along.
2929
when you can:
3030

3131
```bash
32-
agents-cli create my-lc-agent --agent google/agents-cli/extensions/langchain/template@v1.7.0 -d cloud_run --cicd-runner github_actions
32+
agents-cli create my-lc-agent --agent google/agents-cli/extensions/langchain/template@v1.8.0 -d cloud_run --cicd-runner github_actions
3333
```
3434

3535
For a project that skipped them, `agents-cli scaffold enhance -d cloud_run
@@ -78,7 +78,7 @@ AGENTS_CLI_DISABLE_OVERRIDES=1 agents-cli run --url https://<service-url> --mode
7878
## Journey
7979

8080
```bash
81-
agents-cli create my-lc-agent --agent google/agents-cli/extensions/langchain/template@v1.7.0 -d cloud_run
81+
agents-cli create my-lc-agent --agent google/agents-cli/extensions/langchain/template@v1.8.0 -d cloud_run
8282
cd my-lc-agent && agents-cli install
8383
agents-cli run "hello" # in-process graph invocation
8484
agents-cli eval generate --dataset tests/eval/datasets/basic-dataset.json -o tests/eval/output/

0 commit comments

Comments
 (0)