Skip to content

Docs: define ACP-only JSON stream contract#34

Merged
osolmaz merged 4 commits intoopenclaw:mainfrom
osolmaz:feat/acp-only-stream-spec
Feb 28, 2026
Merged

Docs: define ACP-only JSON stream contract#34
osolmaz merged 4 commits intoopenclaw:mainfrom
osolmaz:feat/acp-only-stream-spec

Conversation

@dutifulbob
Copy link
Contributor

Summary

This PR updates ACPX docs to make the JSON stream contract ACP-only.

Key changes:

  • docs/2026-02-27-acpx-session-model.md

    • Rewritten to specify that the canonical stream is raw ACP JSON-RPC only.
    • Removes custom stream envelope/event-schema guidance.
    • Clarifies boundary: local runtime/bookkeeping state stays out-of-band.
  • docs/CLI.md

    • Updates --format json semantics to raw ACP NDJSON stream.
    • Removes acpx.event.v1 envelope examples and synthetic control-event mapping.
    • Adds explicit ACP-stream hard rules (no wrapper fields, no key renaming).
  • docs/2026-02-22-openclaw-integration-plan.md

    • Aligns integration plan wording with ACP-only stream direction.
    • Replaces old envelope-oriented acceptance criteria with ACP JSON-RPC criteria.

Why

To enforce a single protocol surface in streamed automation output:

  • ACP stream payloads should remain ACP, unchanged.
  • acpx-specific orchestration metadata should not be injected into the ACP stream.
  • This reduces schema drift and simplifies downstream orchestrators (including OpenClaw).

Scope

Docs-only. No runtime behavior changes in this PR.

@osolmaz osolmaz merged commit 3ba7ca2 into openclaw:main Feb 28, 2026
1 check passed
@osolmaz osolmaz deleted the feat/acp-only-stream-spec branch February 28, 2026 19:24
@dutifulbob dutifulbob restored the feat/acp-only-stream-spec branch February 28, 2026 21:08
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.

2 participants