patch3.diff

--- codex-rs/core/src/agentmemory/mod.rs
+++ codex-rs/core/src/agentmemory/mod.rs
@@ -5,6 +5,7 @@
 //! as a replacement for Codex's native memory engine.
 
 use std::path::Path;
+use serde::Serialize;
 
 /// A placeholder adapter struct for agentmemory integration.
 #[derive(Debug, Default, Clone)]
@@ -34,5 +35,16 @@
                 .to_string(),
         )
     }
+
+    /// Asynchronously captures and stores lifecycle events in `agentmemory`.
+    ///
+    /// This method allows Codex hooks (like `SessionStart`, `PostToolUse`) to
+    /// be transmitted without blocking the hot path of the shell or model output.
+    pub async fn capture_event<P: Serialize + Send + 'static>(&self, _event_name: &str, _payload: P) {
+        // TODO: Transmit the event to agentmemory's ingestion endpoint.
+        // The payload will typically be a hook request (e.g. `PostToolUseRequest`).
+        // This is a stub for future PRs.
+    }
 }