Struct MemoryCaptureTurnRequest 

pub struct MemoryCaptureTurnRequest {
    pub host_session_id: String,
    pub host_turn_index: i64,
    pub role: String,
    pub content: String,
    pub host_kind: Option<String>,
    pub host_version: Option<String>,
    pub tool_calls: Vec<ToolCallSummary>,
    pub timestamp_iso: Option<String>,
    pub host_signature_b64: Option<String>,
    pub host_pubkey_b64: Option<String>,
    pub namespace: Option<String>,
    pub metadata: Option<Value>,
}

memory_capture_turn request body per RFC-0001 §“Tool input schema”.

Field-by-field doc comments become the schemars-generated description strings in the MCP inputSchema. The schema doubles as the wire contract for every MCP-aware host that volunteers turns.

Fields

host_session_id: String

Opaque identifier the host issues per conversation session. Stable across turns within a session; distinct across sessions. Used as one half of the dedup key (host_session_id, host_turn_index).

host_turn_index: i64

Monotonically increasing per-(host_session_id) turn counter. Starts at 0 for the first turn. The substrate uses (host_session_id, host_turn_index) as the canonical dedup key so re-delivery of the same turn is idempotent.

role: String

Speaker classification — user / assistant / tool_use / tool_result / system / other. Drives downstream memory_kind assignment in the v0.8 decision-detector classifier.

content: String

Verbatim turn text. The substrate preserves this byte-for-byte; classifiers run separately downstream via the existing atomiser / curator surface.

host_kind: Option<String>

Identifier for the host implementation (e.g. "claude-code", "codex", "gemini", "cursor", "cline"). Surfaced in the audit trail + the operator-facing per-host coverage report. When omitted, defaults to "unknown".

host_version: Option<String>

Version string for the host implementation. Surfaced in the audit trail so future format drift can be diagnosed by host version.

tool_calls: Vec<ToolCallSummary>

Optional summary of tool invocations within this assistant turn. Each entry is {tool: string, brief: string}. The substrate preserves the list verbatim but does not (at v0.7.0) classify or index per-tool-call. Reserved for v0.7.x atom- per-tool indexing; the field is wire-stable today so hosts can already populate it without breakage.

timestamp_iso: Option<String>

RFC3339 instant the host emitted the turn. Used as the recovered memory’s created_at so the timeline matches the original conversation rather than the capture-call wall-clock. When omitted, the substrate stamps with its current clock.

host_signature_b64: Option<String>

Optional Ed25519 signature over the canonical-bytes encoding host_session_id || 0x00 || host_turn_index || 0x00 || role || 0x00 || content. When present + verified, the substrate writes attest_level = "signed_by_peer" on the resulting memory. When absent, attest_level = "self_signed".

host_pubkey_b64: Option<String>

Ed25519 pubkey the substrate should verify host_signature_b64 against. The pubkey MUST be pre-enrolled via the existing federation peer-allowlist mechanism. Unenrolled pubkeys cause the call to fail with HOST_PUBKEY_NOT_ENROLLED.

namespace: Option<String>

Substrate namespace the turn lands in. Defaults to the agent’s resolved default namespace per the calling context.

metadata: Option<Value>

Optional arbitrary metadata the host wants to preserve alongside the turn. Reserved keys (agent_id, entity_id, mentioned_entity_id) follow the existing crate::validate::RequestValidator rules.

Trait Implementations

impl Clone for MemoryCaptureTurnRequest

fn clone(&self) -> MemoryCaptureTurnRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemoryCaptureTurnRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryCaptureTurnRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for MemoryCaptureTurnRequest

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.