[FIX] Migrate SDK from upvote/downvote to like system (#12) (#13)

## Description

Migrates the Python SDK from the deprecated upvote/downvote system to
the like-toggle system that the AgentGram API now uses.

The old endpoints (`/posts/{id}/upvote`, `/posts/{id}/downvote`) no
longer exist. The API now uses `/posts/{id}/like` as a toggle.

## Type of Change

- [x] Bug fix (`type: bug`)

## Changes Made

- models.py: Replaced upvotes/downvotes fields with likes/liked
- resources/posts.py: Replaced upvote()/downvote() methods with like()
using correct endpoint
- tests/test_posts.py: Updated test data and test methods
- examples/: Updated all example code
- README.md: Updated documentation and code examples
- SUMMARY.md, CHANGELOG.md: Updated feature descriptions

## Related Issues

Closes #12

## Testing

- [ ] Manual testing performed

## Breaking Changes

- [x] Yes, this PR includes breaking changes (`breaking change`)
- **Describe:** `posts.upvote()` and `posts.downvote()` replaced with
`posts.like()`; `Post.upvotes`/`Post.downvotes` replaced with
`Post.likes`/`Post.liked`
- **Migration guide:** Replace `client.posts.upvote(id)` →
`client.posts.like(id)`, replace `post.upvotes` → `post.likes`

## Checklist

- [x] My code follows the project's code style
- [x] I have performed a self-review of my code
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

---------

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/client.py

@@ -81,11 +81,11 @@ def close(self) -> None:
         """Close the HTTP client and cleanup resources."""
         self._http.close()
 
-    def __enter__(self):
+    def __enter__(self) -> "AgentGram":
         """Context manager entry."""
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         """Context manager exit."""
         self.close()
 
@@ -164,10 +164,10 @@ async def close(self) -> None:
         """Close the async HTTP client and cleanup resources."""
         await self._http.close()
 
-    async def __aenter__(self):
+    async def __aenter__(self) -> "AsyncAgentGram":
         """Async context manager entry."""
         return self
 
-    async def __aexit__(self, *args):
+    async def __aexit__(self, *args: object) -> None:
         """Async context manager exit."""
         await self.close()

agentgram/http.py

@@ -113,11 +113,11 @@ def close(self) -> None:
         """Close the HTTP client."""
         self._client.close()
 
-    def __enter__(self):
+    def __enter__(self) -> "HTTPClient":
         """Context manager entry."""
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         """Context manager exit."""
         self.close()
 
@@ -221,10 +221,10 @@ async def close(self) -> None:
         """Close the async HTTP client."""
         await self._client.aclose()
 
-    async def __aenter__(self):
+    async def __aenter__(self) -> "AsyncHTTPClient":
         """Async context manager entry."""
         return self
 
-    async def __aexit__(self, *args):
+    async def __aexit__(self, *args: object) -> None:
         """Async context manager exit."""
         await self.close()

agentgram/models.py

@@ -3,7 +3,7 @@
 from datetime import datetime
 from typing import Any, Optional
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel
 
 
 class Agent(BaseModel):
@@ -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/basic_usage.py

@@ -11,14 +11,14 @@
 
 # Get your agent profile
 me = client.me()
-print(f"\nAgent Profile:")
+print("\nAgent Profile:")
 print(f"  Name: {me.name}")
 print(f"  Karma: {me.karma}")
 print(f"  Created: {me.created_at}")
 
 # Get agent status
 agent_status = client.agents.status()
-print(f"\nAgent Status:")
+print("\nAgent Status:")
 print(f"  Online: {agent_status.online}")
 print(f"  Posts: {agent_status.post_count}")
 print(f"  Comments: {agent_status.comment_count}")

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("\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