Whilst a steer message is under edit, every steer message now waits, not just the one under edit and the ones behind it. Say Next step holds A, B and C, and you edit B. Before this, A went to the agent at the next model call whilst B and C waited. Now nothing goes out until the edit ends, then A, B and C go in together. If the turn ends whilst a steer message is under edit, the chat pauses, the same as it already does for a queue message. `GetChatQueuedMessageHead` now returns a steer message under edit first, so the paused check still finds it when it isn't the first row. Queue messages are unchanged: editing one holds it and the messages behind it. On the site, every other row shows "Waiting" whilst a steer message is under edit, and Enter on an empty composer won't send the first held message whilst it's waiting on an edit. The docs are updated to match. The first version of this PR refused edits on steer messages instead, following [Mathias's review of #30074](https://github.com/coder/coder/pull/30074#pullrequestreview-5352986208). Mathias has since suggested holding the whole steer lane, so the agent never starts working on part of what you sent. Part of CODAGT-1140
6.2 KiB
6.2 KiB
title
| title |
|---|
| Conversation search syntax |
The chat list endpoint accepts a q query parameter for filtering conversations.
All filters use key:value syntax.
Bare search terms are rejected.
Use title: for title filtering or search: for full-text search.
Filters
| Key | Values | Description |
|---|---|---|
title |
substring | Case-insensitive substring match. Quote multi-word values. |
archived |
true, false |
Filter by archived state. Default: false. |
has_unread |
true, false |
Conversations with unread assistant messages. |
status |
waiting, running, error, requires_action, interrupting, paused |
Conversation state. Comma-separated or repeated values match any of them. |
pr_status |
draft, open, merged, closed, none |
Linked pull request state. Comma-separated for OR. none matches conversations with no linked pull request. |
diff_url |
URL | Match by associated diff URL. Quote values containing colons. |
pr |
positive integer | Exact PR number match. |
repo |
substring | Case-insensitive substring match against git remote origin or URL. Quote values containing colons. |
pr_title |
substring | Case-insensitive PR title substring match. Quote multi-word values. |
source |
created_by_me, shared_with_me |
Ownership scope. Default: created_by_me. Pass both values comma-separated to return owned and shared conversations. |
search |
text | Full-text search across chat titles, PR titles, PR numbers, and message content. Quote multi-word values. |
Multiple filters in one query combine with AND logic.
search: cannot be combined with title:, pr_title:, or pr:.
Full-text search
search: uses token-based PostgreSQL full-text search:
- Case-insensitive whole-word matching with AND semantics.
Quoted phrases,
OR, and-negation followwebsearch_to_tsqueryrules. - Message content matches English word stems (
refactormatchesrefactoring) and ignores English stopwords. Titles and PR titles do not stem. - No fuzzy, semantic, or word-prefix matching.
- Whole-number values also match PR numbers by prefix:
302matches PR30281. - A value with no searchable words (punctuation only) returns an empty list. An empty value returns HTTP 400.
- Results use the standard chat list ordering (pinned first, then most recently updated) and pagination, without match snippets.
- Message content becomes searchable shortly after it is written (background indexing, usually within 10 minutes). Titles and PR titles are searchable immediately.
Examples
# Title substring (case-insensitive)
?q=title:deploy
# Multi-word title (URL-encode the space or use +)
?q=title:my+project
# Unread conversations
?q=has_unread:true
# Conversations that need you, or that failed
?q=status:requires_action,error
# Conversations with a turn in progress
?q=status:running
# Conversations with open or draft PRs
?q=pr_status:open,draft
# Conversations with no pull request, or an open one
?q=pr_status:none,open
# Filter by diff URL (quote values containing colons)
?q=diff_url:"https://github.com/coder/coder/pull/123"
# Combine filters
?q=title:refactor+has_unread:true+pr_status:merged
# Conversations linked to PR #42
?q=pr:42
# Conversations for a specific repository
?q=repo:coder/coder
# Conversations with a specific PR title
?q=pr_title:"fix auth bug"
# Conversations shared with you, plus your own
?q=source:created_by_me,shared_with_me
# Full-text search across titles, PR titles, and messages
?q=search:"kubernetes restart"
# Combine full-text search with other filters
?q=search:refactor+pr_status:open
Notes
status:waitingis an idle conversation,status:runningis a turn in progress, andstatus:interruptingis a turn being stopped.status:requires_actionmeans the agent needs you before it can continue, andstatus:errormeans the turn failed.status:pausedmeans a turn finished while the next queued message, or any message under Next step, was being edited. The agent does not continue until the edit ends.title:,repo:, andpr_title:use ILIKE matching.%and_act as wildcards.pr_status:draftmeans the PR is open and marked as a draft.pr_status:openmeans the PR is open and not a draft.pr_status:nonematches conversations with no pull request, including those whose linked PR was cleared.- Conversations without a linked diff status are excluded when
pr,repo,pr_title, or anypr_statusvalue other thannoneis set. Therepo:filter also matches chats tracking a branch with no PR. - Unrecognized keys, bare terms, or combining
search:withtitle:,pr_title:, orpr:return HTTP 400 with a validation error.