action posthog_task_activity_list {
  label: "List the requester's task activity"
  description: "Task lifecycle rows collapse per task. Comment notifications remain separate. Results are most-recent first and restricted to tasks the requester can see."
  provider: posthog
  method: GET
  path: "/api/projects/{project_id}/task_activity/"
  encoding: json
  input: {
    type: "object"
    properties: {
      before: {
        type: "string"
        format: "date-time"
      }
      before_id: {
        type: "string"
        format: "uuid"
      }
      limit: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "A page of the requester's activity feed, plus the unread total across the whole feed."
    required: ["results", "unread_count"]
    properties: {
      next_before: {
        type: ["string", "null"]
        format: "date-time"
        description: "Activity timestamp to pass as before for the next page, or null on the final page."
      }
      next_before_id: {
        type: ["string", "null"]
        format: "uuid"
        description: "Activity ID to pass as before_id for the next page, or null on the final page."
      }
      results: {
        type: "array"
        description: "Tasks with activity, most recent first."
        items: {
          type: "object"
          description: "Response shape for one task in the requester's activity feed (one row per task)."
          required: ["activity_at", "activity_kind", "channel_id", "channel_name", "id", "is_unread", "snippet", "task_id", "task_title"]
          properties: {
            activity_at: {
              type: "string"
              format: "date-time"
            }
            activity_kind: {
              description: "What the latest activity on this task was: an agent run waiting on the requester (awaiting_input), a completed run (completed), someone @-mentioning them (mention), a comment-thread reply (thread_reply), a comment on their item (owned_item_comment), a task-thread reply (message), or their creating the task (created).\n\n* `awaiting_input` - awaiting_input\n* `completed` - completed\n* `mention` - mention\n* `thread_reply` - thread_reply\n* `owned_item_comment` - owned_item_comment\n* `message` - message\n* `created` - created"
              type: "object"
            }
            channel_id: {
              type: ["string", "null"]
              format: "uuid"
            }
            channel_name: {
              type: ["string", "null"]
            }
            id: {
              type: "string"
              format: "uuid"
            }
            is_unread: {
              type: "boolean"
              description: "Whether the requester has yet to see this activity. Activity they caused themselves is never unread."
            }
            latest_author: {
              description: "Author of the thread message tied to the latest activity, when one applies."
              type: "object"
            }
            latest_comment_id: {
              type: ["string", "null"]
              format: "uuid"
            }
            latest_comment_item_id: {
              type: ["string", "null"]
            }
            latest_comment_scope: {
              type: ["string", "null"]
            }
            latest_message_id: {
              type: ["string", "null"]
              format: "uuid"
            }
            snippet: {
              type: "string"
              description: "Content of the thread message or resource comment tied to the latest activity."
            }
            task_id: {
              type: "string"
              format: "uuid"
            }
            task_title: {
              type: "string"
            }
          }
        }
      }
      unread_count: {
        type: "integer"
        description: "Unread tasks across the requester's whole feed, not just this page. Backs the sidebar badge."
      }
    }
  }
}