All your AI agent sessions in one place — browse, search, resume. Rust + GPUI.
Rust
feat(search): index session titles
Corey Chiua30e6c0ca15e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 49fa5dd..e7d624e 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,9 @@# Changelog+## Unreleased++- Update: search now matches session titles too, in ⌘K / Ctrl+K, `wake_search` and `wake-cli search` — title hits come first and open the session at its start+## [0.6.4] — 2026-09-14- New: CodeBuddy and WorkBuddy support — sessions from Tencent's CodeBuddy Code CLI and the WorkBuddy desktop agent now show up alongside every other agent, with search and the transcript view, plus one-click resume for CodeBuddydiff --git a/README.md b/README.mdindex b5e8c0d..cd5e17c 100644--- a/README.md+++ b/README.md@@ -76,7 +76,7 @@ Wake ships `wake-mcp`, a small read-only [MCP](https://modelcontextprotocol.io)| Tool | What it does ||---|---|-| `wake_search` | Full-text search across every agent's transcripts (CJK and code substrings work); each snippet carries a `wake://session/<key>#<seq>` reference |+| `wake_search` | Full-text search across every agent's session titles and transcripts (CJK and code substrings work); each snippet carries a `wake://session/<key>#<seq>` reference || `wake_list_sessions` | Most recently updated sessions, scoped by project (pass the agent's working directory), agent, time window or starred || `wake_get_session` | One transcript as compact Markdown — user and assistant messages with `[seq N]` markers, tool calls folded to a line, injected context omitted — paginated by `from_seq` || `wake_list_projects` | Projects with indexed sessions, most recently active first |diff --git a/crates/wake-core/src/db.rs b/crates/wake-core/src/db.rsindex 467e883..19800d6 100644--- a/crates/wake-core/src/db.rs+++ b/crates/wake-core/src/db.rs@@ -120,6 +120,14 @@ CREATE TABLE IF NOT EXISTS remote_hosts (last_sync_at INTEGER,last_sync_error TEXT);++-- 标题的全文索引。独立一张表而不挂在 messages 上:标题不是转录消息、没有 seq+-- 可对,塞成假消息会破坏 seq 契约。key 不索引、只用来回查/删除+CREATE VIRTUAL TABLE IF NOT EXISTS titles_fts USING fts5(+ key UNINDEXED,+ title,+ tokenize="trigram case_sensitive 0"+);"#;fn open_conn(path: &Path) -> Result<Connection> {@@ -174,12 +182,36 @@ fn open_conn(path: &Path) -> Result<Connection> {"CREATE INDEX IF NOT EXISTS idx_sessions_host ON sessions(host) WHERE host != ''",[],)?;+ // titles_fts 回填(2026-09-14 加表):老库首次打开时表是空的而 sessions 不空,+ // 把既有标题一次性灌进去;之后由 upsert_session 逐行维护。判据是"空表且有+ // 会话",不记 schema_meta 旗子——全删过的库再开也只是白查一次 count+ let needs_titles: bool = conn.query_row(+ "SELECT (SELECT count(*) FROM titles_fts) = 0 AND EXISTS (SELECT 1 FROM sessions)",+ [],+ |r| r.get(0),+ )?;+ if needs_titles {+ conn.execute(+ "INSERT INTO titles_fts(key, title) SELECT key, title FROM sessions WHERE title != ''",+ [],+ )?;+ }Ok(conn)}/// 最近一次迁移加的列——`open_read_only` 用它判断库够不够新。**加新迁移时把/// 这里改成新列**,否则只读入口会放行老库、深处查询才报 no such columnconst NEWEST_COLUMN: (&str, &str) = ("sessions", "host");+/// 最近一次迁移加的表,与 NEWEST_COLUMN 同一用途、同一维护规矩+const NEWEST_TABLE: &str = "titles_fts";++fn table_exists(conn: &Connection, table: &str) -> Result<bool> {+ Ok(conn.query_row(+ "SELECT EXISTS(SELECT 1 FROM sqlite_master WHERE type IN ('table','view') AND name = ?1)",+ params![table],+ |r| r.get(0),+ )?)+}/// 只读连接:不建表、不迁移、不改 journal_mode(旁路进程用;`open_read_only`/// 与只读 Store 的 insights 临时连接共用,别的入口不要直开)@@ -265,7 +297,9 @@ impl Store {);}let read = open_conn_ro(path)?;- if !table_has_column(&read, NEWEST_COLUMN.0, NEWEST_COLUMN.1)? {+ if !table_has_column(&read, NEWEST_COLUMN.0, NEWEST_COLUMN.1)?+ || !table_exists(&read, NEWEST_TABLE)?+ {anyhow::bail!("Wake index at {} is empty or from an older version — launch Wake once to upgrade it",path.display()@@ -480,6 +514,7 @@ impl Store {fts_del.execute(params![id, text])?;}tx.execute("DELETE FROM messages WHERE session_key = ?1", params![key])?;+ tx.execute("DELETE FROM titles_fts WHERE key = ?1", params![key])?;tx.execute("DELETE FROM sessions WHERE key = ?1", params![key])?;if tombstone {if let Some(fp) = file_path {@@ -897,7 +932,7 @@ impl Store {pub fn rebuild_all(&self) -> Result<()> {let conn = self.write.lock().unwrap();conn.execute_batch(- "DELETE FROM messages; DELETE FROM messages_fts; DELETE FROM sessions;",+ "DELETE FROM messages; DELETE FROM messages_fts; DELETE FROM titles_fts; DELETE FROM sessions;",)?;Ok(())}@@ -1446,40 +1481,48 @@ impl Store {let degraded = segs.iter().any(|s| s.chars().count() < 3);let limit = if f.limit > 0 { f.limit } else { 60 };+ // 会话侧筛选(agent / 项目并集 / 时间下界):SQL 片段拼一次,参数按需重建+ // ——正文与标题是两条查询,Box<dyn ToSql> 不能 clonelet mut filter_sql = String::new();- let mut filter_args: Vec<Box<dyn rusqlite::ToSql>> = Vec::new();if !f.agents.is_empty() {filter_sql.push_str(&format!(" AND s.agent_id IN ({})",placeholders(f.agents.len())));- for a in &f.agents {- filter_args.push(Box::new(a.as_str().to_string()));- }}if !f.project_paths.is_empty() {filter_sql.push_str(&format!(" AND s.project_path IN ({})",placeholders(f.project_paths.len())));- for p in &f.project_paths {- filter_args.push(Box::new(p.clone()));- }}- if let Some(t) = f.updated_since {+ if f.updated_since.is_some() {filter_sql.push_str(" AND s.updated_at >= ?");- filter_args.push(Box::new(t));}+ let filter_args = |f: &SearchFilter| -> Vec<Box<dyn rusqlite::ToSql>> {+ let mut v: Vec<Box<dyn rusqlite::ToSql>> = Vec::new();+ for a in &f.agents {+ v.push(Box::new(a.as_str().to_string()));+ }+ for p in &f.project_paths {+ v.push(Box::new(p.clone()));+ }+ if let Some(t) = f.updated_since {+ v.push(Box::new(t));+ }+ v+ };+ // FTS 的 MATCH 表达式(正文与标题两张表共用)+ let match_expr = segs+ .iter()+ .map(|s| format!("\"{}\"", s.replace('"', "\"\"")))+ .collect::<Vec<_>>()+ .join(" AND ");let conn = self.read.lock().unwrap();let mut raw: Vec<(String, i64, Option<String>, String, Option<i64>, String)> = Vec::new();if !degraded {- let match_expr = segs- .iter()- .map(|s| format!("\"{}\"", s.replace('"', "\"\"")))- .collect::<Vec<_>>()- .join(" AND ");let sql = format!("SELECT m.session_key, m.seq, m.sidechain_id, m.role, m.ts,snippet(messages_fts, 0, ?, ?, '…', 16)@@ -1493,9 +1536,9 @@ impl Store {let mut all_args: Vec<Box<dyn rusqlite::ToSql>> = vec![Box::new(HL_OPEN.to_string()),Box::new(HL_CLOSE.to_string()),- Box::new(match_expr),+ Box::new(match_expr.clone()),];- all_args.extend(filter_args);+ all_args.extend(filter_args(f));all_args.push(Box::new(limit));let rows = stmt.query_map(rusqlite::params_from_iter(all_args.iter().map(|b| b.as_ref())),@@ -1530,7 +1573,7 @@ impl Store {.iter().map(|s| Box::new(format!("%{}%", escape_like(s))) as Box<dyn rusqlite::ToSql>).collect();- all_args.extend(filter_args);+ all_args.extend(filter_args(f));all_args.push(Box::new(limit));let rows = stmt.query_map(rusqlite::params_from_iter(all_args.iter().map(|b| b.as_ref())),@@ -1558,6 +1601,60 @@ impl Store {}}+ // 标题命中:独立的 titles_fts。排在正文命中之前——词出现在标题里是最强的+ // 相关性信号;role 记 "title"、seq 记 0,跳转落到会话开头(标题没有对应的+ // 转录行,不伪造 seq)+ let mut title_raw: Vec<(String, String)> = Vec::new();+ if !degraded {+ let sql = format!(+ "SELECT t.key, highlight(titles_fts, 1, ?, ?)+ FROM titles_fts t JOIN sessions s ON s.key = t.key+ WHERE titles_fts MATCH ?{filter_sql}+ ORDER BY bm25(titles_fts) LIMIT ?"+ );+ let mut stmt = conn.prepare_cached(&sql)?;+ let mut all_args: Vec<Box<dyn rusqlite::ToSql>> = vec![+ Box::new(HL_OPEN.to_string()),+ Box::new(HL_CLOSE.to_string()),+ Box::new(match_expr),+ ];+ all_args.extend(filter_args(f));+ all_args.push(Box::new(limit));+ let rows = stmt.query_map(+ rusqlite::params_from_iter(all_args.iter().map(|b| b.as_ref())),+ |r| Ok((r.get::<_, String>(0)?, r.get::<_, String>(1)?)),+ )?;+ for r in rows {+ title_raw.push(r?);+ }+ } else {+ let like_where = segs+ .iter()+ .map(|_| "s.title LIKE ? ESCAPE '\\'")+ .collect::<Vec<_>>()+ .join(" AND ");+ let sql = format!(+ "SELECT s.key, s.title FROM sessions s+ WHERE {like_where}{filter_sql}+ ORDER BY s.updated_at DESC LIMIT ?"+ );+ let mut stmt = conn.prepare_cached(&sql)?;+ let mut all_args: Vec<Box<dyn rusqlite::ToSql>> = segs+ .iter()+ .map(|s| Box::new(format!("%{}%", escape_like(s))) as Box<dyn rusqlite::ToSql>)+ .collect();+ all_args.extend(filter_args(f));+ all_args.push(Box::new(limit));+ let rows = stmt.query_map(+ rusqlite::params_from_iter(all_args.iter().map(|b| b.as_ref())),+ |r| Ok((r.get::<_, String>(0)?, r.get::<_, String>(1)?)),+ )?;+ for r in rows {+ let (key, title) = r?;+ title_raw.push((key, make_like_snippet(&title, segs[0])));+ }+ }+// 补齐 session meta:按会话只查一次(一个会话常占几十行命中),语句走// prepare_cached——Connection::query_row 每次都是裸 preparelet mut hits = Vec::new();@@ -1566,15 +1663,29 @@ impl Store {"SELECT {SESSION_COLS} FROM sessions s LEFT JOIN user_data u ON u.session_key = s.key WHERE s.key = ?1");let mut stmt = conn.prepare_cached(&sql)?;+ let mut hydrate = |key: &str| -> Result<Option<SessionMeta>> {+ if let Some(cached) = metas.get(key) {+ return Ok(cached.clone());+ }+ let meta = stmt.query_row(params![key], row_to_meta).optional()?;+ metas.insert(key.to_string(), meta.clone());+ Ok(meta)+ };+ for (key, snippet) in title_raw {+ if let Some(session) = hydrate(&key)? {+ let timestamp = Some(session.updated_at);+ hits.push(SearchHit {+ session,+ seq: 0,+ sidechain_id: None,+ role: "title".to_string(),+ snippet,+ timestamp,+ });+ }+ }for (key, seq, sidechain_id, role, ts, snippet) in raw {- let session = if let Some(cached) = metas.get(&key) {- cached.clone()- } else {- let meta = stmt.query_row(params![key], row_to_meta).optional()?;- metas.insert(key.clone(), meta.clone());- meta- };- if let Some(session) = session {+ if let Some(session) = hydrate(&key)? {hits.push(SearchHit {session,seq,@@ -1782,6 +1893,16 @@ fn write_session_tx(}fn upsert_session(tx: &rusqlite::Transaction<'_>, m: &SessionMeta, file_mtime: i64) -> Result<()> {+ // titles_fts 与 sessions.title 同步的**唯一写点**:全量、增量、quick(write_meta_only)+ // 三条路都经这里,标题一改索引即跟上。按 key 删再插(UNINDEXED 列的 DELETE 是+ // 整表扫,几千行也就微秒级),空标题不入索引+ tx.execute("DELETE FROM titles_fts WHERE key = ?1", params![m.key])?;+ if !m.title.is_empty() {+ tx.execute(+ "INSERT INTO titles_fts(key, title) VALUES (?1, ?2)",+ params![m.key, m.title],+ )?;+ }tx.execute("INSERT INTO sessions(key, agent_id, native_id, title, project_path, project_name,git_branch, created_at, updated_at, message_count, tokens_used, model, source,diff --git a/crates/wake-core/src/mcp/tools.rs b/crates/wake-core/src/mcp/tools.rsindex 721f815..8ed6d7e 100644--- a/crates/wake-core/src/mcp/tools.rs+++ b/crates/wake-core/src/mcp/tools.rs@@ -119,7 +119,7 @@ pub fn definitions() -> Vec<Value> {json!({"name": SEARCH,"title": "Search session history",- "description": "Full-text search across every indexed coding-agent session on this machine (user prompts, assistant replies, tool names and inputs). Use it when the user asks whether something was discussed, tried or solved before, or wants the conversation about a topic, an error message, a file or a decision — git history does not hold that. Terms are ANDed; CJK text and code substrings like `useEffect(` work. Returns matching sessions with up to three snippets each, plus a `wake://session/<key>#<seq>` reference per snippet that you can read with wake_get_session.",+ "description": "Full-text search across every indexed coding-agent session on this machine (session titles, user prompts, assistant replies, tool names and inputs). Use it when the user asks whether something was discussed, tried or solved before, or wants the conversation about a topic, an error message, a file or a decision — git history does not hold that. Terms are ANDed; CJK text and code substrings like `useEffect(` work. Returns matching sessions with up to three snippets each, plus a `wake://session/<key>#<seq>` reference per snippet that you can read with wake_get_session.","inputSchema": {"type": "object","properties": {@@ -561,6 +561,15 @@ fn search(ctx: &ToolContext, args: &Value) -> ToolResult {let (meta, snippets) = &groups[key];out.push_str(&format!("{}. {}", ix + 1, session_line(meta)));for h in snippets {+ // 标题命中没有对应消息:只报"标题里有",引用落到会话开头+ if h.role == "title" {+ out.push_str(&format!(+ " - title: {}\n ref: {}\n",+ clean_snippet(&h.snippet),+ session_ref(&meta.key, 0)+ ));+ continue;+ }let when = h.timestamp.filter(|t| *t > 0)diff --git a/crates/wake-core/tests/db_roundtrip.rs b/crates/wake-core/tests/db_roundtrip.rsindex 42fadee..8fe15c8 100644--- a/crates/wake-core/tests/db_roundtrip.rs+++ b/crates/wake-core/tests/db_roundtrip.rs@@ -930,3 +930,106 @@ fn host_column_migration_and_remote_host_roundtrip() {store.remove_remote_host("devbox").unwrap();assert!(store.list_remote_hosts().unwrap().is_empty());}++#[test]+fn titles_are_searchable_and_tracked_with_the_session() {+ let (_dir, store) = temp_store();+ let m = meta("claude-code:t1", "部署脚本重构 deploy");+ store+ .write_session(+ &m,+ m.updated_at,+ &[+ unit(0, Role::User, "hello world"),+ unit(2, Role::Assistant, "deploy pipeline ok"),+ ],+ )+ .unwrap();++ // 标题命中:role=title、seq=0、高亮哨兵包住命中词+ let (hits, degraded) = store.search("部署脚本", &[], None, 10).unwrap();+ assert!(!degraded);+ assert_eq!(hits.len(), 1, "正文里没有这个词,只有标题命中");+ assert_eq!(hits[0].role, "title");+ assert_eq!(hits[0].seq, 0);+ assert_eq!(hits[0].session.key, "claude-code:t1");+ assert!(hits[0]+ .snippet+ .contains(&format!("{HL_OPEN}部署脚本{HL_CLOSE}")));++ // 短词走 LIKE 降级,标题同样命中+ let (hits, degraded) = store.search("部署", &[], None, 10).unwrap();+ assert!(degraded);+ assert_eq!(hits.len(), 1);+ assert_eq!(hits[0].role, "title");++ // 标题与正文都命中时,标题排在前+ let (hits, _) = store.search("deploy", &[], None, 10).unwrap();+ assert_eq!(+ hits.iter().map(|h| h.role.as_str()).collect::<Vec<_>>(),+ ["title", "assistant"]+ );+ assert_eq!(hits[1].seq, 2, "正文命中的 seq 契约不受标题影响");++ // 会话侧筛选对标题命中同样生效+ let (hits, _) = store.search("deploy", &[AgentId::Codex], None, 10).unwrap();+ assert!(hits.is_empty());++ // quick 路径(write_meta_only)改标题:旧标题不再命中,新标题命中+ let mut renamed = m.clone();+ renamed.title = "数据库迁移".into();+ store.write_meta_only(&[(renamed, m.updated_at)]).unwrap();+ assert!(store+ .search("部署脚本", &[], None, 10)+ .unwrap()+ .0+ .is_empty());+ assert_eq!(+ store.search("数据库迁移", &[], None, 10).unwrap().0.len(),+ 1+ );++ // 删除与重建都带走标题索引+ store.remove_session(&m.key, false).unwrap();+ assert!(store+ .search("数据库迁移", &[], None, 10)+ .unwrap()+ .0+ .is_empty());+ let again = meta("claude-code:t2", "第二个会话标题");+ store.write_meta_only(&[(again, 1)]).unwrap();+ assert_eq!(+ store.search("第二个会话", &[], None, 10).unwrap().0.len(),+ 1+ );+ store.rebuild_all().unwrap();+ assert!(store+ .search("第二个会话", &[], None, 10)+ .unwrap()+ .0+ .is_empty());+}++/// 老库(titles_fts 刚由本版建出、还是空的)首次打开时把既有标题灌进去+#[test]+fn title_index_is_backfilled_for_older_databases() {+ let dir = tempfile::tempdir().unwrap();+ let path = dir.path().join("test.db");+ {+ let store = Store::open(&path).unwrap();+ let a = meta("claude-code:old1", "旧库里的标题一");+ let b = meta("codex:old2", "Legacy title two");+ store.write_meta_only(&[(a, 1), (b, 2)]).unwrap();+ }+ // 模拟"表刚建出来":清空标题索引,sessions 照旧+ {+ let conn = rusqlite::Connection::open(&path).unwrap();+ conn.execute("DELETE FROM titles_fts", []).unwrap();+ }+ let store = Store::open(&path).unwrap();+ assert_eq!(+ store.search("旧库里的标题", &[], None, 10).unwrap().0.len(),+ 1+ );+ assert_eq!(store.search("Legacy", &[], None, 10).unwrap().0.len(), 1);+}diff --git a/docs/cli.md b/docs/cli.mdindex 3799e7e..b0db049 100644--- a/docs/cli.md+++ b/docs/cli.md@@ -44,7 +44,7 @@ There is no default project scope. Pass `--project "$PWD"` when you mean "here"### `search`-Full-text search across every indexed session — user prompts, assistant replies, tool names and inputs. Terms are ANDed; CJK text and code substrings like `useEffect(` work. Returns matching sessions with up to three snippets each, and a `wake://session/<key>#<seq>` reference per snippet.+Full-text search across every indexed session — titles, user prompts, assistant replies, tool names and inputs. A title match is listed as `title` with a reference to the start of the session. Terms are ANDed; CJK text and code substrings like `useEffect(` work. Returns matching sessions with up to three snippets each, and a `wake://session/<key>#<seq>` reference per snippet.| Option | Value | Notes ||---|---|---|diff --git a/docs/mcp.md b/docs/mcp.mdindex 787e921..a97c423 100644--- a/docs/mcp.md+++ b/docs/mcp.md@@ -133,7 +133,7 @@ All four tools are read-only and return Markdown text (`content[0].text`). Param### `wake_search`-Full-text search across every indexed transcript: user prompts, assistant replies, tool names and tool inputs (tool outputs are not indexed). Terms are ANDed. CJK text and code substrings such as `useEffect(` both work; terms shorter than three characters fall back to a slower substring scan.+Full-text search across every indexed session: titles, user prompts, assistant replies, tool names and tool inputs (tool outputs are not indexed). A title match is reported as `title` and its reference points at the start of the session. Terms are ANDed. CJK text and code substrings such as `useEffect(` both work; terms shorter than three characters fall back to a slower substring scan.| Parameter | Type | Default | Notes ||---|---|---|---|