Analyze XMemo memory text
analyze_memory_textRead-onlyIdempotent
Count how often a word or phrase appears in your memories, with optional grouping by month, agent, or location.
Instructions
Count a word or phrase across XMemo memories, optionally grouped by month, agent, location, or type. Call this when the user asks how often a word/topic appears.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Optional scope that narrows memory access; leave blank for the token default. | |
| since | No | Only include memories or activity on or after this ISO 8601 timestamp. | |
| until | No | Only include memories or activity on or before this ISO 8601 timestamp. | |
| phrase | Yes | Exact word or phrase to count across visible XMemo memories. | |
| group_by | No | Optional grouping: none, month, agent, location, memory_type, type, source, path, bucket, day, or comma-separated advanced fields. | none |
| match_mode | No | How to match phrase: exact, case_insensitive, or regex_lite. | exact |
| memory_type | No | Memory type/category filter or value, such as episodic, identity, procedural, semantic, working, auto, or %. | % |
| output_json | No | Return a machine-readable JSON response instead of a human-readable summary. | |
| path_filter | No | Memory path filter; % matches all paths. | % |
| max_examples | No | Maximum number of short snippets to include. | |
| max_memories | No | Maximum number of memories to inspect while analyzing text. | |
| include_examples | No | Whether to include a few short matching memory snippets. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |