chat_history_append
Append one structured entry to the chat-history log to record decisions, notes, or phase markers that persist across sessions and can be distilled later.
Instructions
Append one structured entry to the consumer project's chat-history log (a JSONL file). Use to record a decision, note, or phase marker that should persist into a later session or be distilled by mine_session. Writes to the filesystem (agents/runtime/.agent-chat-history by default; agents/.agent-chat-history and .agent-chat-history accepted for back-compat) and returns the written entry plus its resolved target path. Path-scoped: a path outside the allowlist, or any traversal escaping the project root, raises an error before writing. Set dry_run: true to preview the entry and target path without touching disk.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The entry body to record. | |
| entry_type | No | Short ``t`` tag categorising the entry (e.g. note, decision, phase). Defaults to ``note``. | |
| path | No | Optional path override. Must resolve to `agents/runtime/.agent-chat-history` (current default), `agents/.agent-chat-history`, or `.agent-chat-history` under consumer_root. | |
| session | No | Optional 16-char session id to group the entry under. Defaults to the current session. | |
| dry_run | No | When true, return the entry and resolved target path without writing to disk. | |
| min_schema_version | No | Refuse to write if the on-disk history schema is older than this version. |