Skip to content

Show maxLlmCalls in the RunConfig Kotlin tabs - #2163

Open
happyhuman wants to merge 1 commit into
mainfrom
docs-kotlin-runconfig-maxllmcalls
Open

Show maxLlmCalls in the RunConfig Kotlin tabs#2163
happyhuman wants to merge 1 commit into
mainfrom
docs-kotlin-runconfig-maxllmcalls

Conversation

@happyhuman

Copy link
Copy Markdown
Collaborator

What

  • Adds maxLlmCalls to the two Kotlin regions on docs/runtime/runconfig.md (basic_usage → 200, streaming_config → 150), matching the values their siblings already use.
  • Corrects one line of the runtime-limits prose that described the overflow error in Python-only terms.

Why this was invisible

This is a parity gap, not a missing tab. Both Kotlin tabs exist, and every symbol in them is valid at v0.8.0 — so a symbol diff sees nothing and a "missing Kotlin tab" scan sees nothing. Only comparing a tab's contents against its siblings surfaces it. RunConfig.maxLlmCalls has been there since v0.1.0.

Notes

  • The streaming_config region gets a comment. Its siblings set supportCfc alongside maxLlmCalls; Kotlin's RunConfig has no equivalent, so the comment says so rather than leaving the reader to wonder what was dropped.
  • The audio/speech group is deliberately left without a Kotlin tab. Kotlin's RunConfig carries only streamingMode, maxLlmCalls and customMetadata — there is no speechConfig or responseModalities to show, so a tab there would have to invent API.
  • One backlog detail was wrong. The row said the init block "rejects Int.MAX_VALUE and any value <= 0". At v0.8.0 only Int.MAX_VALUE throws; a value <= 0 logs a warning and disables the limit. The existing page prose ("Set to 0 or negative for unlimited calls") is therefore correct for Kotlin as written, and I left it alone.
  • LlmCallsLimitExceededException is not documented here, because the page does not describe what happens on limit exhaustion in any language. That is a docs-wide gap rather than a Kotlin one; adding a Kotlin-only mention would create a new asymmetry.

Verification

Grounded against the v0.8.0 git tag. Full ladder green (L0, L1 compile with KSP, L2 ktlint, L3, L5, L6). L4 runSnippets SKIP — no such Gradle task in this repo.

Tracked as KT-31.

Two groups on the RunConfig page had a Kotlin tab that set only
streamingMode while the Python, TypeScript and Java siblings also set
max_llm_calls. The tab existed and every symbol in it was valid, so
neither a symbol diff nor a missing-tab scan could see the gap - only
comparing a tab's contents against its siblings.

Also corrects the runtime-limits prose, which described the overflow
error purely in Python terms. Kotlin rejects Int.MAX_VALUE the same way.

The audio and speech group is deliberately left without a Kotlin tab:
Kotlin's RunConfig carries only streamingMode, maxLlmCalls and
customMetadata, so there is no speechConfig or responseModalities to
show.
@netlify

netlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit 779545d
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/6a872bf166ac2d0007c2300e
😎 Deploy Preview https://deploy-preview-2163--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@happyhuman happyhuman self-assigned this Aug 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant