Narrate a live set (persisted decision log)
narrate_setRecord timestamped narration lines during a live VJ or show set to create a persistent set log. Append notes with optional sections and cues, or recall previous entries.
Instructions
Persist the running narration of a live VJ/show set so decisions can be recalled afterwards. mode='append' adds a timestamped line (with optional section + cue) to a markdown session log (default ~/.tdmcp/narration-.md); mode='recall' reads the log back (last tail lines). Pair with the auto_vj_director prompt: instead of narrating only in chat, call narrate_set on each major move so the set leaves a diary/setlist trail. Writes a local file (not read-only). Delta vs log_performance, which writes a one-shot network snapshot rather than an append-only decision log.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cue | No | Optional cue name being fired/recalled, for cross-reference. | |
| line | No | The narration line to record (required for mode='append'), e.g. "holding through the build → cue 'drop' on the next bar". | |
| mode | No | append: add a narration line to the running set log. recall: read back the log lines. | append |
| tail | No | For mode='recall': return at most the last N narration lines. | |
| section | No | Optional song section/phase this line belongs to, e.g. 'intro', 'drop', 'breakdown'. | |
| log_path | No | Explicit path to the narration log file, overriding set_name. Honors TDMCP_NARRATION_PATH otherwise. | |
| set_name | No | Session name; picks the log file ~/.tdmcp/narration-<set_name>.md. Defaults to today's date. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| count | Yes | Total narration lines in the log. | |
| entries | No | Parsed narration entries (mode='recall'). | |
| appended | No | The entry that was appended (mode='append'). | |
| log_path | Yes | Absolute path of the narration log file. |