| name | message-parser |
| description | Parse raw WhatsApp exports (TXT or JSON) into normalized message objects with `timestamp`, `sender`, and `content`. Use when users ask to parse chat export, clean WhatsApp dump, or convert chat TXT to structured JSON before extraction. Recommended chain start: message-parser then lead-extractor. Do not use for lead interpretation, storage, summarization, or action suggestions. |
Message Parser
Convert raw chat exports into a strict array of parsed message objects.
Quick Triggers
- Parse this WhatsApp export file.
- Convert this group dump into structured messages.
- Clean this TXT chat into timestamp/sender/content rows.
Recommended Chain
message-parser -> lead-extractor -> india-location-normalizer -> sentiment-priority-scorer -> summary-generator -> action-suggester -> lead-storage
Execute Workflow
- Accept raw WhatsApp export input as plain text, JSON, or file contents already loaded by Supervisor.
- Detect and parse the source format, including WhatsApp export lines like
DD/MM/YYYY, HH:MM - sender: message.
- Normalize each event into exactly three fields:
timestamp (RFC 3339 date-time string)sender (non-empty string)content (string; allow empty message bodies)
- Merge multiline continuation lines into the previous message when they do not start with a new timestamp marker.
- Preserve message ordering. If timestamps collide, preserve original source order.
- Ignore chat-system boilerplate as lead content (encryption notice, group created, member added) while preserving raw line fidelity for audit.
- Validate output against
references/parsed-message-array.schema.json.
- Return only the validated array.
Enforce Boundaries
- Never infer or extract leads.
- Never write to databases or files.
- Never generate summaries or action plans.
- Never send or schedule outbound communication.
- Never bypass Supervisor routing.
Handle Errors
- Return explicit parse errors for malformed entries.
- Include line offsets when source lines are available.
- Fail closed if output cannot satisfy the schema.
