Bolta.add Comment

Goal

Add a review comment to a draft without approving or rejecting it. Used for suggestions, questions, or notes during review process.

Which Agents Use This

• reviewer — Add suggestions before approval, ask questions, note observations
• custom — Any agent participating in review process
• Humans can also add comments during review

Hard Rules

1. MUST attach comment to post
2. SHOULD specify comment_type for context (suggestion, question, note, praise)
3. SHOULD be specific and actionable
4. Comments don't change post status (still in review)

Steps

1. Validate input

• Verify post_id exists
• Verify comment is non-empty
• Validate comment_type if provided

2. Create comment

• Attach comment to post
• Record comment_type
• Record author (agent or human)
• Timestamp comment

3. Return confirmation

• Return comment_id and success message

Output

{
  "success": true,
  "comment_id": "uuid",
  "message": "Comment added to post."
}

Failure Handling

• If post_id not found: return error "Post not found"
• If comment empty: return error "Comment text required"

Example Usage

Scenario 1: Reviewer adding suggestion

{
  "post_id": "uuid",
  "comment": "Consider changing 'utilize' to 'use' (voice profile prefers simpler words)",
  "comment_type": "suggestion"
}

Result: Comment added to draft for creator to review

Scenario 2: Reviewer asking question

{
  "post_id": "uuid",
  "comment": "Is this stat current? I see different numbers in our latest report.",
  "comment_type": "question"
}

Result: Question flagged for creator or human to answer before approval