Platform Comments & Threaded Replies

Add comments to issues, list comments, and create threaded replies using parent_id

Comments enable users and agents to discuss issues through a structured messaging system that supports threading for organized conversations.

Comments enable users and agents to discuss issues through a structured messaging system that supports threading for organized conversations.

from praisonaiagents import Agent

agent = Agent(name="collab-bot", instructions="Discuss issues via platform comments.")
agent.start("Add a summary comment on issue ISS-42.")

The user or agent posts threaded comments on issues to capture decisions and hand-offs.

Quick Start

1. Add a Comment

   Add a top-level comment to an issue.

   curl -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content":"Found the root cause in auth middleware."}'

2. Create Threaded Reply

   Reply to an existing comment using parent_id.

   curl -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content":"Good find! I will fix it.","parent_id":"comment-abc123"}'

3. List All Comments

   Retrieve all comments for an issue with threading structure.

   curl -s http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
     -H "Authorization: Bearer $TOKEN"

How It Works

Comments support two types of interactions:

API Endpoints

The Platform Comments API provides two core endpoints for managing issue discussions:

Request Schemas

{
  "content": "I think the root cause is in the auth middleware.",
  "parent_id": null
}

{
  "content": "Good find! I will fix it.",
  "parent_id": "comment-abc123"
}

Response Schema

Every comment returns this structured response:

{
  "id": "comment-def456",
  "issue_id": "issue-abc123",
  "author_type": "member",
  "author_id": "user-abc123",
  "parent_id": "comment-abc123",
  "content": "Good find! I will fix it.",
  "type": "text",
  "created_at": "2025-01-01T00:00:00"
}

Client Examples

TOKEN="your-jwt-token"
WS_ID="workspace-id"
ISSUE_ID="issue-id"

# Add top-level comment
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"Root cause is in auth middleware."}' \
  --max-time 10

# Add threaded reply
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"I will fix it.","parent_id":"PARENT_COMMENT_ID"}' \
  --max-time 10

# List all comments on an issue
curl -s http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/comments \
  -H "Authorization: Bearer $TOKEN" \
  --max-time 10

import asyncio
from praisonai_platform.client import PlatformClient

async def main():
    client = PlatformClient("http://localhost:8000", token="your-jwt-token")
    ws_id = "your-workspace-id"
    issue_id = "your-issue-id"

    # Add top-level comment
    comment = await client.add_comment(ws_id, issue_id, "Found the bug!")
    print(f"Created comment: {comment['id']}")

    # Add threaded reply
    reply = await client.add_comment(
        ws_id, issue_id, 
        "I'll work on the fix", 
        parent_id=comment["id"]
    )
    print(f"Created reply: {reply['id']}")

    # List all comments
    comments = await client.list_comments(ws_id, issue_id)
    for c in comments:
        indent = "  └─ " if c["parent_id"] else ""
        print(f"{indent}[{c['author_type']}] {c['content']}")

asyncio.run(main())

Comment Threading

Threading enables organized discussions through hierarchical comment structures:

Author Types

Comments support two author types for different interaction patterns:

Testing

Verify comment functionality with these test commands:

# Test comment service
pytest tests/test_services.py::TestCommentService -v

# Test threaded comment functionality
pytest tests/test_new_gaps.py::TestThreadedComments -v

# Test comment API integration
pytest tests/test_new_api_integration.py::TestThreadedCommentsAPI -v

Related