feat: roll back to mrkdwn

Author: kieran-wilkinson-4

packages/cdk/prompts/systemPrompt.txt

@@ -62,24 +62,26 @@ IMPORTANT: This is informational guidance only. Always verify against current cl
     - Medication dosing: "Consult BNF/local formulary and prescribing clinician"
     - Patient-specific data: "Cannot access or discuss patient health information"
 
-6. Text Formatting
-  a. Use Markdown text formatting
-  a. Bold for:
-    - Headings, subheadings: **Answer:**, **Bibliography:**
-    - Source names: **NHS Digital**, **EPS**
-  b. Italic for:
+6. Slack Formatting Standards
+  a. *Bold* for:
+    - Headings, subheadings: *Answer:*, *Bibliography:*
+    - Source names: *NHS Digital*, *EPS*
+  b. _Italic_ for:
     - Citations, references
     - Document titles: _Integration Guide v3.2_
-  c. Block Quotes for:
-    - Direct quotes
+  c. ```code blocks``` for:
+    - Direct quotes >1 sentence
     - Technical specifications, parameters
     - Example configurations
-  d. Inline Code for:
+  d. `inline code` for:
     - System names, field names: `PrescriptionID`
     - Short technical terms: `HL7 FHIR`
+  e. Links:
+    - Format: <https://example.com|Descriptive Name>
+    - Always test readability of link text
 
 7. Bibliography and References
   a. In line citations should be proceeded by [cit_{index number}] and use a http link
-  b. Citations in the [citation] sections should be formatted: <cit>source number|title|link|filename|reference text</cit>
+  b. Citations in the [citation] sections should be formatted: <cit>source number|title|link|filename|reference text|</cit>
     - If the link doesn't exist, or the link isn't to a website, enter "none" in the link section
   c. Any source used, inline or as a source to generate an answer, should be listed in the Bibliography section

packages/slackBotFunction/app/slack/slack_events.py

@@ -174,9 +174,14 @@ def _create_feedback_blocks(
             citation_link = citation.get("link") or ""
             citation_number = citation.get("source number", 0)
 
+            # Buttons can only be 75 characters long, truncate to be safe
+            button_text = f"[{citation_number}] {title}"
             button = {
                 "type": "button",
-                "text": {"type": "plain_text", "text": title},
+                "text": {
+                    "type": "plain_text",
+                    "text": button_text if len(button_text) < 75 else f"{button_text[:70]}...",
+                },
                 "action_id": f"cite_{citation_number}",
                 "value": json.dumps(
                     {**feedback_data, "title": title, "body": body, "link": citation_link},
@@ -198,7 +203,7 @@ def _create_feedback_blocks(
     )
 
     # Main body
-    blocks.append({"type": "section", "text": {"type": "markdown", "text": response_text}})
+    blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": response_text}})
 
     # Citation action block
     if action_buttons:
@@ -632,7 +637,7 @@ def open_citation(channel: str, timestamp: str, message: Any, params: Dict[str,
         citation_block = {
             "type": "section",
             "text": {
-                "type": "markdown",
+                "type": "mrkdwn",
                 "text": f"{title}\n\n{body}\n\n<{link}|View Source>" if link else f"*{title}*\n\n{body}",
             },
             "block_id": "citation_block",