Skip to content

Update kagent 1.x reference docs at v1.0.0-alpha12 (version conrefs changed) - #591

Merged
Rachael-Graham merged 3 commits into
mainfrom
api-gen-update-1.x
Oct 13, 2026
Merged

Rachael-Graham merged 3 commits into
mainfrom
api-gen-update-1.x

Conversation

@github-actions

Copy link
Copy Markdown

Regenerates the kagent 1.x API and Helm references, its CLI and environment variable pages, and the version conrefs at a released tag. Nothing here was read from either repository's main:

The 1.x span of versions/kagent.md moves to 1.0.0-alpha12, so the helm install --version lines on those pages and the reference content beside them describe the same release. Only this line's spans were written; the other line's are asserted unchanged.

The environment variable reference is regenerated from docs/env.md in the kagent checkout, which upstream generates from the registry in go/core/pkg/env and holds to it in CI. The testing section is dropped as repository-facing; pass --include-section testing to publish it.

Important

A version conref moved in this run, so this is not a routine regeneration.
These values render into helm install --version lines that readers copy out of
setup/installation.md, observability/tracing.md, and observability/audit-prompts.md.
Merging asserts the guides work against the versions below, so re-test the affected
guides rather than merging on green CI alone.

-{{< version include-if="0.x" >}}0.0.9{{< /version >}}{{< version include-if="1.x" >}}0.4.0-alpha1{{< /version >}}
+{{< version include-if="0.x" >}}0.0.9{{< /version >}}{{< version include-if="1.x" >}}0.5.0-alpha2{{< /version >}}
-{{< version include-if="0.x" >}}0.10.2{{< /version >}}{{< version include-if="1.x" >}}1.0.0-alpha9{{< /version >}}
+{{< version include-if="0.x" >}}0.10.2{{< /version >}}{{< version include-if="1.x" >}}1.0.0-alpha12{{< /version >}}
-ghcr.io/kagent-dev/kagent/claude-harness@sha256:e72d66d9f3b6eafbc59d18cef150fb5d31cb89ead83999a33c06264c21e86d4c
+ghcr.io/kagent-dev/kagent/claude-harness@sha256:95a5f4839a337aaf78e0eeff480025ed5586d3cfec22277102318826236e3d74
-ghcr.io/kagent-dev/kagent/codex-harness@sha256:aef1e913671c65721af8003494afbeacc6c81e41309afbbb1e8d888e1868d8ce
+ghcr.io/kagent-dev/kagent/codex-harness@sha256:7748610b7eccd94e556e0b9cd7bef93c8961e99d445519135b77513ead81f379
-ghcr.io/kagent-dev/kagent/golang-adk@sha256:26ae5c772d4a59b24ecb3619c3499e106e3b28abbc239de25b4ff8d746f97e69
+ghcr.io/kagent-dev/kagent/golang-adk@sha256:9c2e93b1dc6ac4bfa586cd2636891b5c17e91ca6978338fe02de307098147493

Version conrefs in this run. Each is read from the same place kagent's own build reads it, at the tag above, except the two runtime images, which are resolved from the registry because a digest exists only once the image is pushed:

Conref Value Source
kagent (1.x span) 1.0.0-alpha12 the release tag this run documents
agent-substrate (1.x span) 0.5.0-alpha2 go/go.mod replace target
max-kube (1.x span) 1.35 Makefile KIND_IMAGE_VERSION
kmcp 0.4.0 go/go.mod require (what kagent bundles)
kmcp-latest 0.4.0 kmcp's latest release (what the kmcp guides show)
kagent-tools 0.3.0 helm/kagent/Chart-template.yaml
runtime-image ghcr.io/kagent-dev/kagent/golang-adk@sha256:9c2e93b1dc6ac4bfa586cd2636891b5c17e91ca6978338fe02de307098147493 GHCR, at v1.0.0-alpha12
runtime-image-claude ghcr.io/kagent-dev/kagent/claude-harness@sha256:95a5f4839a337aaf78e0eeff480025ed5586d3cfec22277102318826236e3d74 GHCR, at v1.0.0-alpha12
runtime-image-codex ghcr.io/kagent-dev/kagent/codex-harness@sha256:7748610b7eccd94e556e0b9cd7bef93c8961e99d445519135b77513ead81f379 GHCR, at v1.0.0-alpha12

Unchanged conref values are normal: most runs touch only the generated reference pages.

This PR was automatically generated by the Update Reference documentation workflow.

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@github-actions github-actions Bot added automated pr documentation Improvements or additions to documentation labels Oct 13, 2026
Signed-off-by: Rachael Graham <rachael.graham@solo.io>
@github-actions

github-actions Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Author

Docs preview

Link Points at
Branch preview The newest push to this branch. Updates in place.
Commit preview 0ef30c0 only. Frozen.

Both are uploaded Worker versions and serve no production traffic.

Takes the content of three automated draft PRs into this branch rather than
merging them. Each was cut before main rewrote the page it targets, so all
three conflict with main on their own; the conflicts are not caused by the
alpha12 work on this branch.

#590, WorkerPool placement labels. Verified against the alpha12 chart: the
substrate-workerpool template applies kagent.dev/worker-pool-name and
kagent.dev/worker-pool-namespace through mergeOverwrite after
substrateWorkerPool.labels, so an extra label reusing either key is
overwritten. The chart's own unit test asserts kagent.dev/worker-pool is no
longer set and records why a pinned revision from an earlier release still
needs it. Compressed against the draft, which carried two field tables that
restated their YAML.

#589, push notification signing. controller.push.signing.secretName and
.issuer both exist at v1.0.0-alpha12. Dropped the draft's numbered
`helm upgrade` step: every other setting on this page shows the values block
and leaves the upgrade implicit. Spelled out A2A, which the page used
unexpanded.

#582, Session share TTL. controller.sessionShareMaxTTL exists at alpha12. The
draft added a row to a values table that main's rewrite replaced with prose,
so the cap moved into the prose instead. Its cross-link pointed at
#expire-idle-conversations, which no longer exists; retargeted to
#expire-idle-sessions.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Signed-off-by: Rachael Graham <rachael.graham@solo.io>
@Rachael-Graham
Rachael-Graham merged commit 3a23b3d into main Oct 13, 2026
4 checks passed
@Rachael-Graham
Rachael-Graham deleted the api-gen-update-1.x branch October 13, 2026 17:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automated pr documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant