2 Commits

Author	SHA1	Message	Date
Shahin Saadati	8da5856bc5	Add Kotlin snippets to the custom tools page, including toolset filtering (#2114) ... * Add Kotlin snippet for filtering a toolset's tools The Toolsets section had no Kotlin. ToolFilter and ToolPredicate arrived in adk-kotlin 0.7.0 and give Kotlin something the other languages do not have: a filter that receives the ReadonlyContext, so a toolset's tool list can depend on session state or the current user. The Python tab in the Simple Math Toolset example only gestures at this, in a commented-out branch inside get_tools(). This snippet implements it, showing all three states: no filter selects everything, allowList selects by name, and a Predicate decides per invocation. Placed in its own subsection rather than as a fourth tab on the Simple Math Toolset example. That group is one worked example explained by five bullets -- an agent, a greet tool, name prefixing, a tool_context.state write and close() -- and a filtering snippet satisfies none of them. Kotlin cannot satisfy the prefix bullet at all, since BaseTool.name is a val and adk-kotlin has no prefix mechanism. A tab there would have left readers with four bullets that do not describe the code above them. Transcluded, so CI compiles and lints it. Verified beyond compiling: the tools are generated by KSP, filtering returns the expected sets for all three cases, and the tool bodies run -- addNumbers(7,3) -> {result=10}. * feat: add Kotlin code snippets for tool definition and usage examples to ADK documentation * refactor: move doc snippet markers above imports in Kotlin tool examples * Match ExternalApprovalTool to the 0.8.0 BaseTool.run signature adk-kotlin 0.8.0 widened `BaseTool.run`'s args from `Map<String, Any>` to `Map<String, Any?>`, so the override in this snippet overrides nothing and the class no longer implements its abstract member. `compileKotlin` fails with "'run' overrides nothing" at MultiAgentExample.kt:61. The break arrived on main with the 0.8.0 bump in #2143, not from this branch. It surfaces here because the snippet runner builds the whole examples project, while that PR's own check only compiled the files it changed - and it changed no .kt files at all. Fixing it here because it blocks this PR; it is one character and unrelated to the toolset filtering content. * Correct the tool badges and drop the exclusivity from the filter heading Four things from joefernandez's review: - Heading shortened to "Filter tools in toolsets" as suggested. - That shorter heading is conceptual, and the subsection carries a Kotlin-only badge, which would repeat the exclusivity claim his b/548652184 is about. Python, Java and TypeScript all filter toolsets by name or by a context-aware predicate on BaseToolset, so the section now says so in a sentence and the badge's title scopes the version to the Kotlin ToolFilter API rather than to filtering as a concept. - Page badge Kotlin v0.7.0 -> v0.1.0, and the Toolsets badge likewise. @Tool, ToolContext and Toolset all exist at the v0.1.0 tag; only ToolFilter is new in v0.7.0, and function-tools.md already carries v0.1.0. - The Toolsets badge's bare "Java" span now reads v0.3.0, the first adk-java release containing BaseToolset (added in a211ac4c, tagged v0.3.0).	2026-08-19 10:32:11 -07:00
Kristopher Overholt	50f7df7f46	Add Kotlin language support to ADK docs (#1768) ... * Add Kotlin to hero / front page * Add quickstart page for Kotlin * Complete Kotlin quickstart guide and fix hero code sample (#2) * Replace GitHub repo links with language icons in header (#3) * Fix header icon FOUC and homepage font weight regression (#4) * Testing staging pipeline * Revert test edit (for staging pipeline) * Update language icon tooltips to indicate GitHub destination (#5) * Add link to ADK Kotlin release notes (#7) * Initial commit of ADK Kotlin API reference docs (#6) * Add script to generate ADK Kotlin API reference docs (#8) * Update links and link checker ignore list (temporarily) (#9) * Add ADK Kotlin for Android getting started guide to Advanced setup page (#10) * Add advanced setup page with steps to "Use ADK Kotlin in Android projects" * Update temp link checker rules * Add placeholder folder for adk-samples (#13) * adding linter/compilation checks for kotlin snippets (#12) * adding linter/compilation checks for kotlin snippets * Add Kotlin validation scripts * Initial commit of Kotlin sample agents for adk-samples (#15) * Adding kotlin snippet for llm agents (#16) * Adding kotlin snippets to Events (#17) * Pull changes to docs/events/index.md from glaforge-kotlin-snippets * fixing kotlin event timestamp and longRunningToolIds * Fix language tags (#19) * Fix language tags * Update * Fix wrapping * Fix wrapping (again) * Fix wrapping/format * Fix language tag on integration page * Enable check_paths in PyMdown Snippets Extension to make the build fail if a snippet can't be found (#20) * Update mkdocs config (#21) * Fix broken links, update URLs to adk.dev, and improve (temp) lychee config (#22) * Add Kotlin/maven badge to README (#23) * Adding Kotlin snippets for artifacts (#18) * Pull Kotlin snippets for artifacts from glaforge-kotlin-snippets * Add comprehensive Kotlin snippets for artifacts * Refactor artifacts documentation to use external Kotlin snippets * Update Kotlin model to gemini-flash-latest * Fix GCS initialization in Kotlin artifact snippet * afixi failing test with capital-agent added to files_to_check * Fix snippet label syntax for MkDocs build * Configure proper Gradle project for Kotlin snippets and fix dependencies * Add KSP support and generated sources to Kotlin snippets build * fixing capital_agent turnComplete * Fix syntax error in build.gradle.kts by removing invalid placeholders (#25) * Adding Kotlin snippets to google-gemini.md (#27) Pulling kotlin changes to google-gemini.md from glaforge-kotlin-snippets * Add a warning about not adding an api key to production code. (#28) * Add a warning about not adding an api key to production code. * Update note --------- Co-authored-by: Kristopher Overholt <koverholt@google.com> * Add ADK Demo App sample showcasing Gemini-powered agents (#29) This sample demonstrates how to use the Google ADK (Agent Development Kit) in an Android application to create a chat interface powered by a Gemini-based "Fun Facts" agent. The implementation features: * Integration with the Kotlin ADK core and processor libraries. * A `FunFactsAgent` defined using `LlmAgent` and the Gemini model. * A `ChatViewModel` utilizing `InMemoryRunner` for asynchronous message streaming. * A modern UI built with Jetpack Compose and Material 3. * Build configuration logic for secure API key management via environment variables or `local.properties`. * Update Kotlin docs and samples to align with adk-kotlin API changes (#30) Rename GeminiModel to Gemini, @AdkTool/@AdkParam to @Tool/@Param, adkTools() to generatedTools(), replace DebugRunner with InMemoryRunner, fix AgentLoader import path, use SingleAgentLoader, bump Kotlin to 2.3.21 and KSP to 2.3.7, and update Android minSdk from 24 to 26. * adding kotlin info to READMEs (#14) * Reorganize Android sample agent and add READMEs (#31) * Move Android sample agent * Update repo README, add Android README, update sample agent README * Minor edit to language support tags (#32) * Remove blog post link (#33) Will re-add after it's published * Remove examples link (#34) * Adding Kotlin snippets for Sessions docs (#26) * initial kotlins snippets additions to sessions docs * Updating memory docs with kotlin snippets * Adding kotlin snippets to session state docs. * update model to gemini-flash-latest * sessions examples clean-up * fixing sessions snippet markers * adding kotlin session snippets to files to test * adding callback to memory_example * Fixing capital agent snippet (#35) Fixing file name Updating adkTool > Tool Updating GeminiModel > Gemini * Adding kotlin snippets for tools docs (#36) * adding function tool kotlin snippets * adding function_tools snippets to files to test * Adding kotlin snippets to observability docs (#37) * initial kotlin observability updates * adding observability snippets to file check (#38) * Adding Kotlin snippets to Callbacks docs (#39) * kotlin callbacks snippets * adding callbacks snippets to file check * Align Kotlin and KSP versions with published 0.1.0 artifacts (#40) * switch CLI entry points from InMemoryRunner to ReplRunner (#41) * Switch CLI entry points from InMemoryRunner to ReplRunner * Fix wording * Update API reference docs for Kotlin, 2026-05-18 (#42) * Remove ADK on Android note until published (#43) * Update Kotlin code samples (#44) * Rename GeminiModel to Gemini in Kotlin snippets and docs * Remove broken SessionKey call and use sessionId directly in AgentTool snippet * Rewrite Go hero snippet to use llmagent API * Use isFinalResponse with safe access in CapitalAgent snippet * Use Role.USER constant instead of raw string in SetupExample * Use full semver v0.1.0 in Kotlin language support tags * Remove Android setup steps, moving to new property (#45) * Tutorial Kotlin agent (#46) * Adding multi-tool-agent snippet and updating tutorial * Fixing Go language order on tutorial page * adding multi tool agent example to files to test * Inline Kotlin get-started code sample * Kotlin Multi agents snippets (#47) * Multi-agent kotlin snippets * Fixing docs tags in multiagent example * Fix Kotlin language support tags, code samples, and google-gemini.md cleanup (#48) * Add Kotlin v0.1.0 to language support tags across docs * Fix MultiToolAgent.kt model string and argument style * Update MultiAgentExample.kt to use gemini-flash-latest model string * Fix google-gemini.md: add Kotlin sample, remove unsupported Java tabs * Remove explicit apiKey from CallbackBasic.kt for consistency * Standardize Gemini() constructor to use named args in all snippets * Remove adk-samples directory (moved to google/adk-samples#1969) * Remove adk-samples directory (moved to google/adk-samples#1969) (#49) * Update API reference docs for ADK Kotlin 0.1.0 (#50) * Remove adk-samples directory (moved to google/adk-samples#1969) * Update API reference docs for ADK Kotlin 0.1.0 * Remove kotlin lycheeignore config (#51) * Remove adk-samples directory (moved to google/adk-samples#1969) * Remove Kotlin .lycheeignore config links --------- Co-authored-by: Toni Klopfenstein <2359976+ToniCorinne@users.noreply.github.com> Co-authored-by: Jolanda Verhoef <JolandaVerhoef@users.noreply.github.com>	2026-05-19 11:43:42 -05:00