Core Rules

•Always confirm the action taken
•Match language - Urdu input gets Urdu response
•Include context - Show task title/ID in response
•Handle errors gracefully - Friendly, actionable error messages
•Embed tool results - Include relevant data from tool output

Response Templates

English Confirmations

Intent	Success Response
`add_task`	Task '{{title}}' added!
`list_tasks`	Here are your {{count}} tasks:
`complete_task`	Task '{{title}}' marked as complete!
`delete_task`	Task '{{title}}' has been deleted.
`update_task`	Task '{{title}}' updated successfully!
`get_task`	Here's task #{{id}}: {{title}}

Urdu Confirmations (اردو)

Intent	Success Response
`add_task`	ٹاسک '{{title}}' شامل کر دیا گیا!
`list_tasks`	یہ ہیں آپ کے {{count}} ٹاسک:
`complete_task`	ٹاسک '{{title}}' مکمل ہو گیا!
`delete_task`	ٹاسک '{{title}}' حذف کر دیا گیا۔
`update_task`	ٹاسک '{{title}}' اپڈیٹ ہو گیا!
`get_task`	یہ ہے ٹاسک #{{id}}: {{title}}

Error Responses

English Errors

Error Code	Response
`TASK_NOT_FOUND`	Task not found – please check the ID and try again.
`VALIDATION_ERROR`	Invalid input: {{details}}. Please correct and retry.
`UNAUTHORIZED`	Please log in to manage your tasks.
`SERVER_ERROR`	Something went wrong. Please try again in a moment.
`NO_TASKS`	You don't have any tasks yet. Try adding one!

Urdu Errors (اردو)

Error Code	Response
`TASK_NOT_FOUND`	ٹاسک نہیں ملا – براہ کرم آئی ڈی چیک کریں۔
`VALIDATION_ERROR`	غلط معلومات: {{details}}۔ درست کر کے دوبارہ کوشش کریں۔
`UNAUTHORIZED`	براہ کرم اپنے ٹاسک دیکھنے کے لیے لاگ ان کریں۔
`SERVER_ERROR`	کچھ غلط ہو گیا۔ تھوڑی دیر بعد دوبارہ کوشش کریں۔
`NO_TASKS`	آپ کے پاس ابھی کوئی ٹاسک نہیں۔ ایک شامل کریں!

Response Builder Function

python

def build_response(
    intent: str,
    tool_result: dict,
    is_urdu: bool = False
) -> str:
    """Build natural language response from tool result."""

    if not tool_result.get("success"):
        return get_error_response(
            tool_result["error"]["code"],
            is_urdu,
            tool_result["error"].get("details")
        )

    template = get_template(intent, is_urdu)
    return template.format(**tool_result["data"])

List Formatting

English List

code

Here are your 3 tasks:

1. Buy milk (pending)
2. Call dentist (pending)
3. Submit report (completed)

Urdu List (اردو)

code

یہ ہیں آپ کے 3 ٹاسک:

1. دودھ خریدو (زیر التواء)
2. ڈینٹسٹ کو کال کرو (زیر التواء)
3. رپورٹ جمع کرو (مکمل)

Status Translations

English	Urdu
pending	زیر التواء
completed	مکمل
in_progress	جاری

Response Object Format

json

{
  "message": "Task 'Buy milk' added!",
  "language": "en",
  "intent": "add_task",
  "data": {
    "task_id": 123,
    "title": "Buy milk",
    "status": "pending"
  }
}

Tone Guidelines

•Friendly: Use exclamation marks for success
•Helpful: Provide next steps on errors
•Concise: Keep responses short and clear
•Consistent: Same structure for same intent
•Natural: Read like human conversation

Integration Points

•natural-language-parser: Provides is_urdu flag
•mcp-tool-craft: Provides tool results to format
•conversation-state-manager: Stores formatted responses