Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

fix(hooks): filter OpenCode subagent title preamble (#519)

Lucas do Amaral Saboyaab4338d9dabf
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9abc0fc6..a25ed59b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,6 +25,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
fingerprints, or native session ids. The Docker shell wrapper routes the
command through its native host client so repository identity remains
correct. (#499)
+### Fixed
+- OpenCode subagent session pages no longer use the fixed `You are a subagent
+ spawned by another session.` preamble as their title. The zero-LLM
+ synthesizer now promotes the first usable task line from the prompt body and
+ falls back to the session identity when the prompt contains only the
+ preamble. Repeated real user requests still remain separate session pages.
+ (#518)
## [1.33.1] - 2026-08-28
diff --git a/crates/ai-memory-hooks/src/payload.rs b/crates/ai-memory-hooks/src/payload.rs
index 468ae981..607a13b5 100644
--- a/crates/ai-memory-hooks/src/payload.rs
+++ b/crates/ai-memory-hooks/src/payload.rs
@@ -886,7 +886,7 @@ fn best_body_excerpt(event: HookEvent, raw: &serde_json::Value) -> Option<String
}
}
-fn truncate_for_title(s: &str) -> String {
+pub(crate) fn truncate_for_title(s: &str) -> String {
const MAX: usize = 80;
let one_line: String = s.chars().take_while(|c| *c != '\n').collect();
if one_line.chars().count() <= MAX {
diff --git a/crates/ai-memory-hooks/src/synth.rs b/crates/ai-memory-hooks/src/synth.rs
index 84b5a19d..4b2950d5 100644
--- a/crates/ai-memory-hooks/src/synth.rs
+++ b/crates/ai-memory-hooks/src/synth.rs
@@ -14,9 +14,12 @@ use ai_memory_core::{
};
use jiff::tz::TimeZone;
+use crate::payload::truncate_for_title;
+
const RAW_OBSERVATION_MAX_LINES: usize = 500;
const RAW_OBSERVATION_HEAD_LINES: usize = 250;
const RAW_OBSERVATION_TAIL_LINES: usize = RAW_OBSERVATION_MAX_LINES - RAW_OBSERVATION_HEAD_LINES;
+const SUBAGENT_PROMPT_PREAMBLE: &str = "You are a subagent spawned by another session.";
/// Build a [`NewPage`] from the observations collected during a session.
///
@@ -101,19 +104,35 @@ pub fn synthesize_session_page(
/// literal "session" remains only for the case where there is nothing else
/// at all.
fn derive_title(observations: &[Observation], session_id: SessionId) -> String {
+ let mut rejected_subagent_preamble = false;
for obs in observations {
- if obs.kind == ObservationKind::UserPrompt
- && !obs.title.is_empty()
- && !looks_like_scaffolding(&obs.title)
- {
+ if obs.kind != ObservationKind::UserPrompt {
+ continue;
+ }
+ if obs.title.trim() == SUBAGENT_PROMPT_PREAMBLE {
+ rejected_subagent_preamble = true;
+ if let Some(title) = obs
+ .body
+ .lines()
+ .map(str::trim)
+ .find(|line| !line.is_empty() && !looks_like_title_scaffolding(line))
+ {
+ return truncate_for_title(title);
+ }
+ continue;
+ }
+ if !obs.title.is_empty() && !looks_like_scaffolding(&obs.title) {
return obs.title.clone();
}
}
+ if rejected_subagent_preamble {
+ return format!("Session {session_id}");
+ }
for obs in observations {
if obs.kind == ObservationKind::SessionStart {
continue;
}
- if !obs.title.is_empty() && !looks_like_scaffolding(&obs.title) {
+ if !obs.title.is_empty() && !looks_like_title_scaffolding(&obs.title) {
return obs.title.clone();
}
}
@@ -126,6 +145,10 @@ fn derive_title(observations: &[Observation], session_id: SessionId) -> String {
format!("Session {session_id}")
}
+fn looks_like_title_scaffolding(candidate: &str) -> bool {
+ candidate.trim() == SUBAGENT_PROMPT_PREAMBLE || looks_like_scaffolding(candidate)
+}
+
/// The per-session counts that both the rendered body and the frontmatter
/// summary are built from.
struct SessionTally<'a> {
@@ -588,6 +611,68 @@ mod tests {
}
}
+ #[test]
+ fn subagent_preamble_promotes_the_first_task_line() {
+ let preamble = "You are a subagent spawned by another session.";
+ let task = "Review the audit runbook and identify stale checks.";
+ let mut prompt = obs(ObservationKind::UserPrompt, preamble);
+ prompt.body = format!("{preamble}\n\n{task}");
+
+ let page = synthesize_session_page(
+ WorkspaceId::new(),
+ ProjectId::new(),
+ SessionId::new(),
+ AgentKind::OpenCode,
+ &[prompt],
+ );
+
+ assert_eq!(page.title, task);
+ }
+
+ #[test]
+ fn subagent_preamble_without_a_task_falls_back_to_session_identity() {
+ let session_id = SessionId::new();
+ let preamble = "You are a subagent spawned by another session.";
+ let mut prompt = obs(ObservationKind::UserPrompt, preamble);
+ prompt.body = preamble.into();
+ let observations = vec![prompt, obs(ObservationKind::PostToolUse, "tool file")];
+
+ let page = synthesize_session_page(
+ WorkspaceId::new(),
+ ProjectId::new(),
+ session_id,
+ AgentKind::OpenCode,
+ &observations,
+ );
+
+ assert_eq!(page.title, format!("Session {session_id}"));
+ }
+
+ #[test]
+ fn repeated_user_requests_remain_separate_session_pages() {
+ let first_session = SessionId::new();
+ let second_session = SessionId::new();
+ let observations = vec![obs(ObservationKind::UserPrompt, "Review the audit runbook")];
+
+ let first = synthesize_session_page(
+ WorkspaceId::new(),
+ ProjectId::new(),
+ first_session,
+ AgentKind::OpenCode,
+ &observations,
+ );
+ let second = synthesize_session_page(
+ WorkspaceId::new(),
+ ProjectId::new(),
+ second_session,
+ AgentKind::OpenCode,
+ &observations,
+ );
+
+ assert_eq!(first.title, second.title);
+ assert_ne!(first.path, second.path);
+ }
+
/// Every candidate is scaffolding. The page still needs a title, and
/// "session" repeated across every such page is not one.
#[test]