Skip to content

docs: explain independent ReAct streaming message identity - #6

Open
logicwu0 wants to merge 1 commit into
agentic-ai-java:mainfrom
logicwu0:docs/372-stream-message-identity
Open

logicwu0 wants to merge 1 commit into
agentic-ai-java:mainfrom
logicwu0:docs/372-stream-message-identity

Conversation

@logicwu0

Copy link
Copy Markdown

Related issue

Confirmed contribution to ARGI. Addresses only the streaming message identity item of agentic-ai-java/argi#372, based on merged agentic-ai-java/argi#358. The remaining documentation work stays open.

Changes

  • Add matching Chinese and English guides for the independent ReAct streaming API and link them in navigation.
  • Explain delta append versus snapshot replacement, invocation-local IDs, tool-turn isolation, and failure/cancellation boundaries. Keep the graph-based API and historically pinned guides out of scope.
  • Add an executable offline example using the real ReAct engine with a scripted ChatClient. It checks multi-turn/tool isolation, snapshot replacement, fresh views across invocations, and partial text after failure.
  • Record exact source baselines, commands and validation limitations in the example README. No Core runtime or dependency-lock changes.

Validation

Website base: 7974c3b40392722557a4404210cfb6cb4a975a16; Core source: ef67b8e083746899da43c0a056b76b71db9e92ab; contribution: 6594ce29.

Validated locally on macOS arm64 with JDK 21 targeting Java 17 and Maven 3.10.1:

  • Installed the pinned Core dependencies; compiled and executed the example successfully, then reran with Maven offline mode.
  • Ran the pinned Core ReActAgentStreamMessageIdTest: 11 tests passed, no failures/errors/skips. This is not a full Core suite claim.
  • Passed website typecheck, ESLint, existing contract check, Chinese/English production build, search verification, changed-page Markdown lint, and git diff --check.

The existing contract checker still contains old API literal checks; its success is not used as proof of Java compatibility. The compiled example supplies that evidence. No live provider, browser UI, or network-cancellation validation is claimed. JDK 17 runtime execution was not tested, and the source baseline is not a claim of Maven Central publication.

Screenshots

Not included; this contribution adds documentation and an offline Java example, with no site styling changes.

This branch has not been deployed

No deployments
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