Skip to content

Personal AI, On Personal Devices

Python

docs(a2a): clarify library-only server configuration (#1101)

Huanyi Xie36a2f097aec0
diff --git a/docs/user-guide/data-boundary-scan.md b/docs/user-guide/data-boundary-scan.md
index 3944e962..e1c7104e 100644
--- a/docs/user-guide/data-boundary-scan.md
+++ b/docs/user-guide/data-boundary-scan.md
@@ -51,7 +51,7 @@ The current checks cover:
- unset `security.profile` (informational)
- web search, browser, local file, shell, code, knowledge chunk scanning, and MCP tool surfaces
- local knowledge.db composition with cloud-capable Deep Research targets
-- server binding and unauthenticated A2A exposure
+- server binding and A2A configuration/authentication settings
- channel enablement, channel credential fields, and channel credential env vars
- skills, skill auto-sync, digest sources, and cloud speech/TTS backends such as Cartesia
- local stores such as `knowledge.db`, `credentials.toml`, `memory.db`, `traces.db`,
@@ -65,6 +65,18 @@ Configured database paths (for example `traces.db_path` or `memory.db_path`)
are resolved from config when set, not only the default locations under the
OpenJarvis home directory.
+### A2A configuration and the built-in server
+
+A2A findings describe configuration, rather than a probe of mounted network
+routes. The current `jarvis serve` application does not mount the `A2AServer`
+library's endpoints. Setting `[a2a] enabled = true` therefore does not add A2A
+discovery or task routes to that application.
+
+Applications that integrate `A2AServer` themselves control its transport and
+authentication explicitly. A scan finding about `a2a.enabled` or `a2a.auth_token`
+does not establish that such an integration is running, nor does it certify a
+particular A2A protocol version or transport.
+
Static Deep Research targeting uses configuration only (no request overrides):
`deep_research.engine` or `engine.default`, and `deep_research.model` or
`server.model` or `intelligence.default_model`.
diff --git a/src/openjarvis/core/config.py b/src/openjarvis/core/config.py
index b3a073a9..fc425af7 100644
--- a/src/openjarvis/core/config.py
+++ b/src/openjarvis/core/config.py
@@ -1591,7 +1591,12 @@ class SessionConfig:
@dataclass(slots=True)
class A2AConfig:
- """Agent-to-Agent protocol settings."""
+ """Settings for A2A integrations and configuration diagnostics.
+
+ The built-in ``jarvis serve`` app does not mount A2A endpoints; ``enabled``
+ does not change that app's route surface. Library integrations using
+ ``A2AServer`` must configure their transport and authentication explicitly.
+ """
enabled: bool = False
# Bearer token required for inbound A2A requests. Empty = unauthenticated