Load or initialise the persistent session profile
load_session_profileReads the session profile file to provide a unified JSON snapshot of cached artist preferences and past work, resetting to defaults if requested. Ensures agents have context without re-running multiple tools.
Instructions
Reads ~/.tdmcp/session-profile.json (or a custom path) and returns a unified JSON snapshot that an agent should load at the start of every session. The profile caches the most recent outputs of style_memory, recall_similar_work, learn_conventions, and learn_from_my_corpus so the agent has the artist's preferences and past work at hand without running all four tools every time. If no file exists, a default skeleton is created and returned. Pass reset=true to overwrite with fresh defaults. The profile_path field in the returned object is always the resolved path that was read or written.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile_path | No | Absolute path to the session-profile JSON file. Defaults to ~/.tdmcp/session-profile.json. | |
| reset | No | If true, overwrite the existing profile with the built-in defaults and return them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile_path | Yes | Absolute path of the profile file read or written. | |
| created | Yes | True when the profile was created fresh (no prior file). | |
| reset | Yes | True when reset=true was requested. | |
| loaded_at | Yes | ISO-8601 timestamp of this read. | |
| style_memory | No | Snapshot from style_memory (Memory/style.md) if previously captured. | |
| recent_work | No | Top hits from recall_similar_work if previously captured. | |
| conventions | No | Snapshot from learn_conventions (Memory/conventions.md) if previously captured. | |
| corpus_style | No | Snapshot from learn_from_my_corpus (Memory/corpus_style.md) if previously captured. | |
| notes | Yes | Human-readable notes about what was loaded or defaulted. |