Function chatThreadRead

chatThreadRead(
vault: Vault,
args: { note_path: string },
): Promise<ChatThreadReadResult>
Parse a note's chat thread into structured messages.

Reads the chat block starting at ## Chat: <title> and parses each ### <role> · <timestamp> sub-heading into a ChatThreadMessage. Content before that title is ignored. # / ## lines inside a message are kept as markdown. A later ## Chat: title starts a new title in the same parse; the walk continues to EOF. Returns thread_title: null and an empty messages array if the note has no chat block.
Parameters
- vault: Vault
  The vault.
- args: { note_path: string }
  note_path is the vault-relative path to the thread note.
Returns Promise<ChatThreadReadResult>
A ChatThreadReadResult with parsed messages in chronological order.
Throws
If note_path resolves outside the vault.

Throws
If the note doesn't exist.
Example
```
const thread = await chatThreadRead(vault, {
  note_path: "Threads/Research-2026-05-08.md"
});
for (const msg of thread.messages) {
  console.log(`[${msg.timestamp}] ${msg.role}: ${msg.content}`);
}
```
- Defined in src/tools/read.ts:1392