From f5463881ad46c5adf3570e2512f49bdf94fb3186 Mon Sep 17 00:00:00 2001 From: Shahin Saadati Date: Wed, 19 Aug 2026 15:23:45 -0700 Subject: [PATCH 1/2] Bump adk-docs to adk-kotlin 1.0.0 KT-23. adk-docs compiles its Kotlin snippets against the pinned SDK, so no 1.0 feature can be documented until this pin moves. Prerequisite only - no snippets, no prose about 1.0 features. Moves the examples pin (core, webserver, processor, a2a) and the install instructions readers copy from, which track the pin for the same reason they did at 0.8.0: leaving them behind hands newcomers an SDK older than the snippets on the same page. THIS DOES NOT BUILD YET, and cannot until the artifacts are published: > Could not find com.google.adk:google-adk-kotlin-core:1.0.0. > Could not find com.google.adk:google-adk-kotlin-webserver:1.0.0. > Could not find com.google.adk:google-adk-kotlin-a2a:1.0.0. Maven Central carries 0.8.0 as the newest release for every artifact today, and google/adk-kotlin has no v1.0.0 tag. The PR is a draft until the release lands. Two comments that pinned third-party versions against adk-kotlin 0.8.0's catalog - Ktor 2.3.13 and a2a-java-sdk-client 1.0.0.Final - now say the match was made against 0.8.0 and needs re-checking, rather than restating it as though it still held. A major release is exactly where a transitive version moves. Also note the version string is assumed to be `1.0.0`. If the release is cut as `1.0.0-rc.1` or similar, these five coordinates need to match it. --- docs/agents/models/litert-lm.md | 4 ++-- docs/get-started/installation.md | 4 ++-- docs/get-started/kotlin.md | 16 ++++++++-------- examples/kotlin/build.gradle.kts | 17 +++++++++-------- 4 files changed, 21 insertions(+), 20 deletions(-) diff --git a/docs/agents/models/litert-lm.md b/docs/agents/models/litert-lm.md index 28f471bcae..7d8aa77f04 100644 --- a/docs/agents/models/litert-lm.md +++ b/docs/agents/models/litert-lm.md @@ -184,8 +184,8 @@ repositories { } dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - implementation("com.google.adk:google-adk-kotlin-litertlm:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + implementation("com.google.adk:google-adk-kotlin-litertlm:1.0.0") implementation("com.google.ai.edge.litertlm:litertlm-jvm:0.13.1") // other dependencies... } diff --git a/docs/get-started/installation.md b/docs/get-started/installation.md index 1ab41a7ebf..dcd1fb5bad 100644 --- a/docs/get-started/installation.md +++ b/docs/get-started/installation.md @@ -168,8 +168,8 @@ across supported languages. For a guided introduction, start with the } dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - ksp("com.google.adk:google-adk-kotlin-processor:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + ksp("com.google.adk:google-adk-kotlin-processor:1.0.0") } ``` diff --git a/docs/get-started/kotlin.md b/docs/get-started/kotlin.md index e497c69e47..1d9acff9a8 100644 --- a/docs/get-started/kotlin.md +++ b/docs/get-started/kotlin.md @@ -108,8 +108,8 @@ An ADK Kotlin agent project requires the following dependencies in your ```kotlin title="my_agent/build.gradle.kts (partial)" dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - ksp("com.google.adk:google-adk-kotlin-processor:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + ksp("com.google.adk:google-adk-kotlin-processor:1.0.0") } ``` @@ -129,9 +129,9 @@ dependencies { } dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - implementation("com.google.adk:google-adk-kotlin-webserver:0.8.0") - ksp("com.google.adk:google-adk-kotlin-processor:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + implementation("com.google.adk:google-adk-kotlin-webserver:1.0.0") + ksp("com.google.adk:google-adk-kotlin-processor:1.0.0") } kotlin { @@ -235,9 +235,9 @@ to your `build.gradle.kts`: ```kotlin title="my_agent/build.gradle.kts (add to dependencies)" dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - implementation("com.google.adk:google-adk-kotlin-webserver:0.8.0") - ksp("com.google.adk:google-adk-kotlin-processor:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + implementation("com.google.adk:google-adk-kotlin-webserver:1.0.0") + ksp("com.google.adk:google-adk-kotlin-processor:1.0.0") } ``` diff --git a/examples/kotlin/build.gradle.kts b/examples/kotlin/build.gradle.kts index b057c5cd7f..aac1860f30 100644 --- a/examples/kotlin/build.gradle.kts +++ b/examples/kotlin/build.gradle.kts @@ -14,21 +14,22 @@ repositories { } dependencies { - implementation("com.google.adk:google-adk-kotlin-core:0.8.0") - implementation("com.google.adk:google-adk-kotlin-webserver:0.8.0") - ksp("com.google.adk:google-adk-kotlin-processor:0.8.0") + implementation("com.google.adk:google-adk-kotlin-core:1.0.0") + implementation("com.google.adk:google-adk-kotlin-webserver:1.0.0") + ksp("com.google.adk:google-adk-kotlin-processor:1.0.0") implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.9.0") // The Vertex AI session and memory services expose Ktor's HttpClient as a // defaulted constructor parameter, so any snippet naming them needs Ktor on - // the COMPILE classpath, not just at runtime. Version matches what - // adk-kotlin 0.8.0 already resolves to. + // the COMPILE classpath, not just at runtime. Version was matched against + // adk-kotlin 0.8.0; re-check what 1.0 resolves to before merging. implementation("io.ktor:ktor-client-core:2.3.13") implementation("io.ktor:ktor-client-java:2.3.13") // A2A. The a2a artifact publishes the A2A SDK as runtime-only, but A2AAgent's // httpClient parameter defaults to JdkA2AHttpClient(), so the client artifact - // is needed on the COMPILE classpath too. Version matches adk-kotlin 0.8.0's - // own catalog; the spec and jsonrpc transport arrive transitively. - implementation("com.google.adk:google-adk-kotlin-a2a:0.8.0") + // is needed on the COMPILE classpath too. Version was matched against + // adk-kotlin 0.8.0's catalog; re-check against 1.0. The spec and jsonrpc + // transport arrive transitively. + implementation("com.google.adk:google-adk-kotlin-a2a:1.0.0") implementation("org.a2aproject.sdk:a2a-java-sdk-client:1.0.0.Final") implementation("com.google.cloud:google-cloud-storage:2.48.2") implementation("io.opentelemetry:opentelemetry-sdk:1.56.0") From c0a5676753a98088d3a5b85acf0319ac22f7d5f2 Mon Sep 17 00:00:00 2001 From: Shahin Saadati Date: Wed, 19 Aug 2026 15:28:10 -0700 Subject: [PATCH 2/2] Bump the A2A quickstart's dependency to 1.0.0 as well Missed on the first pass, and the reason is worth recording: the sweep used `google-adk-kotlin[a-z-]*:0\.8\.0`, whose character class has no digits, so it silently skipped `google-adk-kotlin-a2a` - the one artifact with a digit in its name. Every other coordinate matched, so the search looked exhaustive and was not. The corrected pattern is `google-adk-kotlin[a-z0-9-]*:[0-9]+\.[0-9]+\.[0-9]+`. Run repo-wide it now finds five live coordinates in the examples build file and seventeen in the docs, all at 1.0.0, and nothing left below it. --- docs/a2a/quickstart-consuming-kotlin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/a2a/quickstart-consuming-kotlin.md b/docs/a2a/quickstart-consuming-kotlin.md index 1763c168f6..d684788fac 100644 --- a/docs/a2a/quickstart-consuming-kotlin.md +++ b/docs/a2a/quickstart-consuming-kotlin.md @@ -27,7 +27,7 @@ compile classpath as well, because `A2AAgent`'s `httpClient` parameter defaults to `JdkA2AHttpClient()`: ```kotlin title="build.gradle.kts" -implementation("com.google.adk:google-adk-kotlin-a2a:0.8.0") +implementation("com.google.adk:google-adk-kotlin-a2a:1.0.0") implementation("org.a2aproject.sdk:a2a-java-sdk-client:1.0.0.Final") ```