search_transcripts
Search transcripts by full text, archived agents included.
read-onlyidempotentMCP toolAgent
Quote phrases, prefix - to exclude, and narrow with qualifiers such as from:me, agent:NAME, workflow:NAME, is:reviewer, since:2d and on:DATE. Only the caller's transcript is searched unless agent_id or a qualifier names others.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/SearchTranscripts \
-H 'Content-Type: application/json' \
-d '{
"query": "<query>"
}'komrad rpc search-transcripts \
--query '<string>'{
"name": "search_transcripts",
"arguments": {
"query": "<query>"
}
}Offered by the komrad MCP server to writer, reviewer, orchestrator agents.
Request#
SearchTranscriptsRequest#
| Field | Type | Description |
|---|---|---|
query | string* at most 500 characters | The words to search for, matched whole and stemmed. A quoted phrase matches in order, a leading minus excludes a word, and qualifiers narrow the search. |
pagination | Pagination | The page to read. One cursor pages through |
agent_id | uuid | The agent whose transcript to search, by id. Unset searches the caller's own, unless a qualifier names other agents. |
Response#
SearchTranscriptsResponse#
| Field | Type | Description |
|---|---|---|
matches | SearchHit[] | The turns that contain the words, in the order the query asked for. |
near | SearchHit[] | The turns that contain the letters only inside other text, such as a word inside a path. They are ranked by how closely the letters match. |
next_page_token | string | The cursor for the next page of both lists. Unset on the last page. |
Types#
Pagination#
Pagination selects one page of a listing.
SearchHit#
SearchHit is one turn of a transcript that matched a search.
| Field | Type | Description |
|---|---|---|
agent_id | uuid* | The id of the agent whose transcript holds the turn. |
snippet | string | The turn's text around the match, with the match marked. |
name | string | The agent's name. |
archived | bool | Whether the agent is archived. Search includes archived agents. |
score | double | How well the turn matched. Zero when the hits are ordered by time. |
seq | int32 | The turn's position in the transcript, counting from zero. |
role | string | Who wrote the turn: the agent, or whoever prompted it. |
content_offset | int64 | The byte offset of the turn in the whole transcript, for reading the text around it. |
content_length | int64 | How many bytes the turn runs to from |
spoken_at | timestamp | When the turn was written. Unset when the CLI's log was gone before komrad read the time. |