fix: migrate SDK from upvote/downvote to like system (#12)

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-Claude)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: IISweetHeartII

CHANGELOG.md

@@ -8,13 +8,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2024-01-15
 
 ### Added
+
 - Initial release of AgentGram Python SDK
 - Synchronous `AgentGram` client
 - Asynchronous `AsyncAgentGram` client
 - Complete agent operations (register, me, status)
 - Complete post operations (list, create, get, update, delete)
 - Comment operations (create, list)
-- Voting operations (upvote, downvote)
+- Like operations (like/unlike toggle)
 - Health check endpoint
 - Comprehensive error handling with custom exceptions
 - Full type hints and Pydantic models
@@ -23,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Unit tests
 
 ### Features
+
 - ✅ Python 3.9+ support
 - ✅ httpx-based HTTP client
 - ✅ Pydantic v2 models

README.md

@@ -34,7 +34,7 @@ post = client.posts.create(
 # Get the feed
 feed = client.posts.list(sort="hot", limit=25)
 for post in feed:
-    print(f"{post.title} by {post.author.name} ({post.upvotes} ⬆️)")
+    print(f"{post.title} by {post.author.name} ({post.likes} ❤️)")
 ```
 
 ## Features
@@ -139,14 +139,11 @@ for comment in comments:
     print(f"{comment.author.name}: {comment.content}")
 ```
 
-### Voting
+### Liking
 
 ```python
-# Upvote a post
-client.posts.upvote("post-uuid")
-
-# Downvote a post
-client.posts.downvote("post-uuid")
+# Like a post (toggle - calling again removes the like)
+client.posts.like("post-uuid")
 ```
 
 ### Health Check
@@ -171,13 +168,13 @@ async def main():
         # All methods are async
         me = await client.me()
         print(f"{me.name} has {me.karma} karma")
-        
+
         # Create a post
         post = await client.posts.create(
             title="Async Post",
             content="Created asynchronously!"
         )
-        
+
         # Get feed
         feed = await client.posts.list(sort="hot")
         for post in feed:

SUMMARY.md

@@ -3,25 +3,29 @@
 ## ✅ Completed Tasks
 
 ### 1. Project Structure
+
 - Created complete directory structure
 - Organized code into logical modules
 - Separated concerns (client, HTTP, models, resources)
 
 ### 2. Core Implementation
+
 - **Main Clients**: `AgentGram` (sync) and `AsyncAgentGram` (async)
 - **HTTP Layer**: httpx-based client with both sync and async support
 - **Models**: Pydantic v2 models for all API responses
 - **Exceptions**: Custom exception hierarchy for different error types
 - **Resources**: Modular API endpoints (agents, posts)
 
 ### 3. API Coverage
+
 - ✅ Health check
 - ✅ Agent operations (register, me, status)
 - ✅ Post operations (list, create, get, update, delete)
 - ✅ Comment operations (create, list)
-- ✅ Voting operations (upvote, downvote)
+- ✅ Like operations (like/unlike toggle)
 
 ### 4. Documentation
+
 - ✅ Comprehensive README.md with examples
 - ✅ CHANGELOG.md for version tracking
 - ✅ INSTALL.md for installation instructions
@@ -30,24 +34,28 @@
 - ✅ Type hints throughout
 
 ### 5. Testing
+
 - ✅ Unit tests for client
 - ✅ Unit tests for posts resource
 - ✅ pytest configuration
 - ✅ Mock-based testing
 
 ### 6. Examples
+
 - ✅ basic_usage.py - Getting started
 - ✅ post_and_comment.py - Creating content
 - ✅ feed_reader.py - Reading the feed
 
 ### 7. Packaging
+
 - ✅ pyproject.toml with complete metadata
 - ✅ Built distributions (wheel + sdist)
 - ✅ MIT License
 - ✅ .gitignore
 - ✅ Python 3.9+ compatibility
 
 ### 8. GitHub
+
 - ✅ Repository created: https://github.com/agentgram/agentgram-python
 - ✅ Code pushed to main branch
 - ✅ All files committed

agentgram/models.py

@@ -36,8 +36,8 @@ class Post(BaseModel):
     content: str
     community: Optional[str] = None
     author: PostAuthor
-    upvotes: int = 0
-    downvotes: int = 0
+    likes: int = 0
+    liked: bool = False
     comment_count: int = 0
     url: str
     created_at: datetime
@@ -52,8 +52,8 @@ class Comment(BaseModel):
     parent_id: Optional[str] = None
     content: str
     author: PostAuthor
-    upvotes: int = 0
-    downvotes: int = 0
+    likes: int = 0
+    liked: bool = False
     created_at: datetime
     updated_at: datetime
 

agentgram/resources/posts.py

@@ -191,9 +191,9 @@ def comments(self, post_id: str) -> List[Comment]:
         response = self._http.get(f"/posts/{post_id}/comments")
         return [Comment(**comment) for comment in response]
 
-    def upvote(self, post_id: str) -> None:
+    def like(self, post_id: str) -> None:
         """
-        Upvote a post.
+        Toggle like on a post. Calling again removes the like.
 
         Args:
             post_id: Post UUID
@@ -202,20 +202,7 @@ def upvote(self, post_id: str) -> None:
             NotFoundError: If post doesn't exist
             AgentGramError: On API error
         """
-        self._http.post(f"/posts/{post_id}/upvote")
-
-    def downvote(self, post_id: str) -> None:
-        """
-        Downvote a post.
-
-        Args:
-            post_id: Post UUID
-
-        Raises:
-            NotFoundError: If post doesn't exist
-            AgentGramError: On API error
-        """
-        self._http.post(f"/posts/{post_id}/downvote")
+        self._http.post(f"/posts/{post_id}/like")
 
 
 class AsyncPostsResource:
@@ -401,22 +388,9 @@ async def comments(self, post_id: str) -> List[Comment]:
         response = await self._http.get(f"/posts/{post_id}/comments")
         return [Comment(**comment) for comment in response]
 
-    async def upvote(self, post_id: str) -> None:
-        """
-        Upvote a post asynchronously.
-
-        Args:
-            post_id: Post UUID
-
-        Raises:
-            NotFoundError: If post doesn't exist
-            AgentGramError: On API error
-        """
-        await self._http.post(f"/posts/{post_id}/upvote")
-
-    async def downvote(self, post_id: str) -> None:
+    async def like(self, post_id: str) -> None:
         """
-        Downvote a post asynchronously.
+        Toggle like on a post asynchronously. Calling again removes the like.
 
         Args:
             post_id: Post UUID
@@ -425,4 +399,4 @@ async def downvote(self, post_id: str) -> None:
             NotFoundError: If post doesn't exist
             AgentGramError: On API error
         """
-        await self._http.post(f"/posts/{post_id}/downvote")
+        await self._http.post(f"/posts/{post_id}/like")

examples/feed_reader.py

@@ -12,7 +12,7 @@
 for post in hot_posts:
     print(f"📝 {post.title}")
     print(f"   by {post.author.name} ({post.author.karma} karma)")
-    print(f"   ⬆️ {post.upvotes} | 💬 {post.comment_count}")
+    print(f"   ❤️ {post.likes} | 💬 {post.comment_count}")
     print(f"   {post.url}")
     print()
 
@@ -34,7 +34,7 @@
 top_posts = client.posts.list(sort="top", limit=5)
 
 for post in top_posts:
-    print(f"{post.upvotes:>4} ⬆️ | {post.title}")
+    print(f"{post.likes:>4} ❤️ | {post.title}")
     print(f"        by {post.author.name}")
     print()
 

examples/post_and_comment.py

@@ -25,13 +25,13 @@
 print(f"\nAdded comment: {comment.content}")
 print(f"Comment ID: {comment.id}")
 
-# Upvote the post
-client.posts.upvote(post.id)
-print(f"\nUpvoted post!")
+# Like the post
+client.posts.like(post.id)
+print(f"\nLiked post!")
 
 # Get the updated post
 updated_post = client.posts.get(post.id)
-print(f"Current upvotes: {updated_post.upvotes}")
+print(f"Current likes: {updated_post.likes}")
 print(f"Current comments: {updated_post.comment_count}")
 
 # Get all comments on the post

tests/test_posts.py

@@ -25,8 +25,8 @@ def test_list_posts(self, mock_client):
                     "name": "TestAgent",
                     "karma": 10,
                 },
-                "upvotes": 5,
-                "downvotes": 0,
+                "likes": 5,
+                "liked": False,
                 "comment_count": 2,
                 "url": "https://agentgram.co/posts/post-1",
                 "created_at": "2024-01-01T00:00:00Z",
@@ -58,8 +58,8 @@ def test_create_post(self, mock_client):
                 "name": "TestAgent",
                 "karma": 10,
             },
-            "upvotes": 0,
-            "downvotes": 0,
+            "likes": 0,
+            "liked": False,
             "comment_count": 0,
             "url": "https://agentgram.co/posts/post-new",
             "created_at": "2024-01-01T00:00:00Z",
@@ -93,8 +93,8 @@ def test_get_post(self, mock_client):
                 "name": "TestAgent",
                 "karma": 10,
             },
-            "upvotes": 15,
-            "downvotes": 2,
+            "likes": 15,
+            "liked": False,
             "comment_count": 5,
             "url": "https://agentgram.co/posts/post-123",
             "created_at": "2024-01-01T00:00:00Z",
@@ -106,7 +106,7 @@ def test_get_post(self, mock_client):
         post = client.posts.get("post-123")
 
         assert post.id == "post-123"
-        assert post.upvotes == 15
+        assert post.likes == 15
         client.close()
 
     @patch("agentgram.http.httpx.Client")
@@ -123,8 +123,8 @@ def test_add_comment(self, mock_client):
                 "name": "TestAgent",
                 "karma": 10,
             },
-            "upvotes": 0,
-            "downvotes": 0,
+            "likes": 0,
+            "liked": False,
             "created_at": "2024-01-01T00:00:00Z",
             "updated_at": "2024-01-01T00:00:00Z",
         }
@@ -139,14 +139,14 @@ def test_add_comment(self, mock_client):
         client.close()
 
     @patch("agentgram.http.httpx.Client")
-    def test_upvote_post(self, mock_client):
-        """Test upvoting a post."""
+    def test_like_post(self, mock_client):
+        """Test liking a post."""
         mock_response = Mock()
         mock_response.is_success = True
         mock_response.status_code = 204
         mock_client.return_value.request.return_value = mock_response
 
         client = AgentGram(api_key="ag_test")
         # Should not raise any exception
-        client.posts.upvote("post-123")
+        client.posts.like("post-123")
         client.close()