Skip to content

Align with main - #5

Merged
piscoTech merged 18 commits into
ciolo:feat/strands-native-interruptsfrom
ag-ui-protocol:main
Aug 6, 2026
Merged

Align with main#5
piscoTech merged 18 commits into
ciolo:feat/strands-native-interruptsfrom
ag-ui-protocol:main

Conversation

@piscoTech

Copy link
Copy Markdown
Collaborator

No description provided.

contextablemark and others added 18 commits August 4, 2026 14:19
`ToolMessage.error` is documented on the messages concept page and in the
JS, Python, and Ruby SDK references, but two pages omit it -- both pages an
integration author is likely to work from.

- concepts/tools.mdx: the Tool Results example showed only `content` +
  `toolCallId`. Adds a failure example alongside the existing success one,
  reusing the page's confirmAction / tool-123 scenario.
- sdk/kotlin/core/types.mdx: the ToolMessage declaration omitted `error`,
  which the Kotlin SDK does have. Also corrects the name / toolCallId order
  to match the source.

concepts/events.mdx was checked and left alone: ToolCallResultEvent has no
`error` field in either SDK, so its property table is accurate.

Refs #2306, #2226

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Nothing validated Python lockfiles. Every --frozen-lockfile check in CI is pnpm,
which is how three released packages drifted -- ag_ui_adk five releases deep --
without a single red build (#2313 repaired it, #2314 removes the cause).

Adds --locked to the nine `uv sync` steps rather than nine new `uv lock --check`
steps: uv sync --locked asserts the lockfile is already in step with
pyproject.toml and exits 1 if not, so the gate rides along with a command CI
already runs. Measured on the aws-strands package -- with the lock's self-version
knocked back a patch it exits 1 with "The lockfile at `uv.lock` needs to be
updated, but `--locked` was provided", and exits 0 once restored.

Safe to merge as-is: verified that all eight uv-managed packages this workflow
covers currently pass `uv lock --check` against main, so no job goes red on
landing. Note the check is resolution-level, not byte-level -- it tolerates a lock
whose metadata representation is merely older than what today's uv would emit,
and fails only when the lock genuinely disagrees with pyproject. That is the right
sensitivity here: the version drift this exists to catch trips it, and a uv
upgrade alone does not.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
uv.lock carries an entry for the package it locks -- the one whose source is
{ editable = "." } -- so editing pyproject.toml alone leaves that entry one
version stale. prepare-release.ts did exactly that, so every release shipped a
stale lock: four consecutive aws-strands releases are each a one-line, one-file
commit, and ag_ui_adk drifted five releases deep before anyone noticed. #2313
repaired the accumulated drift; this stops it recurring.

Runs `uv lock`, which is what the tooling is for. Note it may also flush latent
metadata corrections unrelated to the bump: it rewrites the whole file once it
has any reason to, and what it writes reflects the package metadata in uv's cache
at that moment. Measured -- the same uv 0.9.24 binary added an exceptiongroup
dependency marker on Aug 4 that it had not added on Jul 30 from an identical
starting state, because the cache had refreshed from PyPI in between. Those are
corrections rather than corruption (exceptiongroup genuinely needs
typing-extensions only below 3.13), and the companion `uv lock --check` CI gate
(#2315) keeps them from accumulating: with locks continuously current, a release
bump has nothing extra to flush and its diff stays to the version line.

Packages with no uv.lock (poetry-managed, or unlocked) are skipped; a missing uv
is fatal rather than skipped, since silently publishing a stale lock is the
failure this exists to prevent. uv's stdout is discarded so the script's JSON
summary stays parseable, with stderr passed through for diagnostics.

Testability: repoRoot was pinned to the script's own location, so a non-dry-run
would have edited the real repo and --dry-run (which never writes) was the only
safe mode -- leaving the write path uncovered. It now honours
PREPARE_RELEASE_ROOT, so a test can point config, package files and lockfiles at
a throwaway tree. The added test builds a dependency-free fixture package (so
`uv lock` needs no network), seeds its lock with a real uv run rather than
hand-writing one, bumps it through the actual script, and asserts pyproject.toml
and uv.lock both land on the new version. Commenting out the re-lock makes it
fail with "uv.lock self-entry not re-locked", so it guards the regression rather
than the implementation.

The test skips itself when uv is absent, so test-release-scripts.yml gains the uv
install -- otherwise it would pass vacuously in CI and give false confidence.

Rejected: a main-guard refactor to make the script importable. A guard whose
condition silently mismatched would stop main() running at all -- a quiet no-op in
release tooling, worse than the bug being fixed. The env override achieves the
same testability with no effect on normal invocation.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
chore(deps): update github/codeql-action action to v4.37.6
`git lfs fsck --pointers HEAD` reported 34 files committed as ordinary Git
blobs on paths that .gitattributes declares LFS-governed, and every clone
printed a 34-line "should have been pointers, but weren't" notice.

PNI-185 proposed converting those 34 files to pointers. Investigating each
one showed the policy, not the contents, is what is wrong:

  * docs/** (9 files, 7.4 MB) is served straight from a repository checkout
    by Mintlify, which does not hydrate Git LFS -- an open, unanswered
    feature request since March 2026. Converting these would serve 130-byte
    pointer text in place of every docs image and the landing-page video.

  * apps/dojo/public|src (14 files, 3.1 MB) is served the same way by Render.

  * The Kotlin example's launcher icons (10 files) are Android Studio
    template output at 1-8 KB each -- smaller than the overhead LFS adds.

  * config_test.dill (10.3 MB, 48% of the total) is a Dart kernel snapshot:
    compiler output committed by accident in #316, referenced by nothing.
    It escaped .gitignore only because the compiler wrote it beside its
    source rather than into .dart_tool/ or build/.

Converting would also not have shrunk the repository. A forward-only change
leaves the original blobs in history, so full clones keep carrying all
21.3 MB and would additionally fetch the LFS objects on every hydrating
clone -- against ~95k clones/month, purely additive bandwidth.

So: exempt the four path groups, delete the build artifact, and drop the now
dead *.dill LFS rule. No file is converted and no LFS object is uploaded.

Adds .github/scripts/check-lfs-pointers.sh, which derives the governed set
from `git check-attr` rather than any filename list, and fails in both
directions -- a plain blob on a governed path, and a stranded pointer left
behind by a future exemption. Verified: 34 violations on the previous main,
zero here; fails on a plain blob added to a governed path and passes once
the same file is re-added through LFS.

Refs PNI-185

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Clears zizmor/anonymous-definition (note severity) on the job added by the
previous commit.

Only the new job is named. The two pre-existing jobs in this file trip the
same rule, but renaming them would change their reported check context, and
`main` is protected with required checks that are not readable without admin
access -- if either is required by name, the rename would leave the context
permanently pending.

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

fix(repo): reconcile Git LFS policy with repository contents
The Clients listings covered web, terminal, and React Native, which left
the impression that AG-UI targets web applications. Add chat platforms
(Slack, Microsoft Teams) alongside the existing entries, and state that a
client need not be a web app because the protocol describes an event
stream rather than a rendering target.

The added text separates the layers: a chat-platform client is something
anyone can build against AG-UI, the Channels SDK is one implementation,
OpenTag is a readable application built on it, and CopilotKit
Intelligence is named as a hosted service outside the protocol.

No protocol, specification, or event-set changes.

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

docs: document chat platforms as an AG-UI client surface
ci(python): fail the build on a stale uv.lock
fix(release): re-lock uv-managed Python packages after a version bump
The TOOL_CALL_START handler appended to the parent assistant message's
`toolCalls` with no check for an existing entry, so any re-application of
a start event corrupted message state. The same start can reach the
reducer twice — a tool call already carried in `agent.messages` from an
earlier run and then replayed by the backend (the HITL path does this
when the run re-syncs after `respond()`), or one stream re-delivered over
two transports.

The duplicate's `arguments` stay empty, because TOOL_CALL_ARGS deltas
resolve to the first match. That malformed assistant message — the same
tool call twice, one copy with no arguments — is what travels back to the
provider on the next turn.

Resolve any existing entry for the id and update it in place instead of
pushing a second one, leaving `arguments` untouched (a start event carries
none, so the copy already in state holds the only streamed args). A start
that reuses an id under a different name warns and updates the name.

The check runs before resolveOrCreateAssistantMessage, which also closes a
second latent defect on the same path: a replay whose parentMessageId is
no longer in state would otherwise create a stray empty assistant message
to hang the duplicate off. A replay is now a true no-op — no duplicate, no
stray message, and no state emission at all.

Note that TOOL_CALL_ARGS remains non-idempotent by nature (deltas append).
The evidence in CPK-7770 shows only the start event was replayed, so this
covers the observed defect; whole-stream re-delivery would surface next as
doubled arguments, which cannot be deduped without sequence numbers.

Refs CPK-7772, follow-up to CPK-7770 / CopilotKit#6407

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
fix(client): make TOOL_CALL_START idempotent
…ror-example

docs(tools): document ToolMessage.error in tool result examples
chore(deps): update swatinem/rust-cache action to v2.9.2
@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Python Preview Packages — Publish Failed

Preview publish failed for commit aa82754.
See the workflow run for details.

@pkg-pr-new

pkg-pr-new Bot commented Aug 6, 2026

Copy link
Copy Markdown

Open in StackBlitz

@ag-ui/a2a-middleware

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/a2a-middleware@5

@ag-ui/a2ui-middleware

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/a2ui-middleware@5

@ag-ui/event-throttle-middleware

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/event-throttle-middleware@5

@ag-ui/mcp-apps-middleware

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/mcp-apps-middleware@5

@ag-ui/mcp-middleware

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/mcp-middleware@5

@ag-ui/a2a

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/a2a@5

@ag-ui/adk

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/adk@5

@ag-ui/ag2

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/ag2@5

@ag-ui/agno

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/agno@5

@ag-ui/aws-strands

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/aws-strands@5

@ag-ui/claude-agent-sdk

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/claude-agent-sdk@5

@ag-ui/claude-managed-agents

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/claude-managed-agents@5

@ag-ui/crewai

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/crewai@5

@ag-ui/langchain

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/langchain@5

@ag-ui/langgraph

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/langgraph@5

@ag-ui/llamaindex

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/llamaindex@5

@ag-ui/mastra

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/mastra@5

@ag-ui/pydantic-ai

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/pydantic-ai@5

@ag-ui/vercel-ai-sdk

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/vercel-ai-sdk@5

@ag-ui/watsonx

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/watsonx@5

@ag-ui/a2ui-toolkit

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/a2ui-toolkit@5

create-ag-ui-app

pnpm add https://pkg.pr.new/ciolo/ag-ui/create-ag-ui-app@5

@ag-ui/client

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/client@5

@ag-ui/core

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/core@5

@ag-ui/encoder

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/encoder@5

@ag-ui/proto

pnpm add https://pkg.pr.new/ciolo/ag-ui/@ag-ui/proto@5

commit: e946e19

@piscoTech
piscoTech merged commit ce5c190 into ciolo:feat/strands-native-interrupts Aug 6, 2026
17 checks passed
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.

4 participants