docs: propose the kagent integration

appa-adapter-claude-code/src/lib.rs

@@ -169,6 +169,8 @@ struct WireEvent {
     prompt: Option<String>,
     #[serde(default)]
     tool_name: Option<String>,
+    /// The JSON spelling in Claude Code's `tool_input` hook field. This is
+    /// Claude Code's execution-boundary value, not Anthropic provider wire data.
     #[serde(default)]
     tool_input: Option<Box<serde_json::value::RawValue>>,
     #[serde(default)]

appa-engine/src/transition.rs

@@ -67,7 +67,8 @@ pub struct ProposalBatch {
     pub expansions: Vec<crate::groups::GroupExpansion>,
 }
 
-/// One call the model proposed, as it wrote it: a tool name and untrusted argument bytes.
+/// One model-directed call as the harness presents it for dispatch: a tool name and
+/// untrusted argument bytes representing the value the harness would execute.
 /// Only the engine turns this into a [`ResolvedCall`], so no caller can present a
 /// payload under a schema the registry does not hold.
 #[derive(Clone, Debug, PartialEq, Eq)]

appa-runtime-api/src/lib.rs

@@ -7,8 +7,9 @@
 #[derive(Debug, Clone, PartialEq, Eq, Hash)]
 pub struct TrajectoryId(pub String);
 
-/// A tool call as the model proposed it. The engine canonicalizes;
-/// the runtime and the adapter pass it through unchanged.
+/// A model-directed tool call at the harness's execution boundary. The
+/// arguments are the JSON spelling the harness would execute. The engine
+/// canonicalizes them; the runtime and adapter do not parse or rewrite them.
 #[derive(Debug, Clone, serde::Serialize)]
 pub struct ProposedCall {
     pub tool: String,