sdac-generate-district-contact

Purpose

Produces structured, district-friendly email drafts for common SDAC follow-ups (credential verification, enrollment confirmation, sendback notices, etc.).

Tool type

Deterministic (templated)

Tool ID

sdac-generate-district-contact

Inputs

• report_id (string)
• contact_type (enum):
  • PCA_ENROLLMENT
  • PDN_ENROLLMENT
  • PSYCHOLOGIST_VERIFICATION
  • BEHAVIORAL_HEALTH_CONFIRMATION
  • GENERAL_INQUIRY
  • SENDBACK_NOTIFICATION
  • VALIDATION_CONFIRMATION
• reviewer_name (string, optional)
• specific_positions (string[], optional)
• custom_context (string, optional)

Outputs

• success
• district_name, contact_emails
• suggested_email_subject, suggested_email_body
• positions_referenced, urgency, follow_up_deadline

Example output

{
  "success": true,
  "district_name": "Example R-II School District",
  "contact_emails": [
    "sdac@example.k12.mo.us"
  ],
  "suggested_email_subject": "SDAC cost report follow-up for Q2 2024",
  "suggested_email_body": "Please review the attached replacement linkage and source-code findings before resubmitting.",
  "positions_referenced": [
    {
      "row_number": 72,
      "job_title": "Speech Language Pathologist"
    }
  ],
  "urgency": "NORMAL",
  "follow_up_deadline": "2026-05-15"
}

Functional details

• Selects a predefined template based on contact_type.
• Injects district name, quarter, and optional position context.
• Assigns urgency and recommended follow-up window.

Usage notes

• Use after validation steps when district action is required.
• Combine with sdac-generate-sendback-summary for full sendback packages.

Implementation details

• Pulls district metadata from SDAC tables.
• Uses deterministic template strings (no LLM calls).
• Calculates follow-up dates based on urgency level.

Code Location: packages/domain-sdac/src/tools/generate-district-contact.tool.ts