Upgrade to version 1.1.1 (#3)

* chore: Update repository URLs to getlatedev/late-python-sdk

* fix: Resolve lint errors and update MCP test imports

* fix: Resolve mypy errors and add params to HTTP methods

* ci: Improve release workflow with better visibility and PyPI check

- Add release summary in GitHub Actions
- Check if version exists on PyPI before publishing
- Show clear notices for skip/release decisions
- Bump version to 1.0.1

* ci: Add release preview comment on PRs to main

Shows version info and release status before merging:
- Version from pyproject.toml
- Whether git tag exists
- Whether version exists on PyPI
- Clear indication if release will happen or be skipped

* chore: trigger workflow re-run

* fix: Add explicit permissions for checkout in private repo

* fix: Add explicit token and permissions to all workflows for private repo

* feat: Add typed responses with Pydantic models (v1.1.0)

- All resource methods now return typed Pydantic models instead of dicts
- Generate proper Enum classes instead of Literal types
- Add response models: PostsListResponse, ProfileGetResponse, etc.
- Add upload module with direct and Vercel Blob support
- Update tests to use attribute access syntax
- Sync version to 1.1.0 across pyproject.toml and __init__.py

* feat(mcp): Add is_draft parameter and centralized tool definitions

- Add is_draft parameter to posts_create and posts_cross_post
- Create tool_definitions.py as single source of truth for MCP params
- Add script to generate MDX docs from definitions

* fix: Move Callable imports to TYPE_CHECKING block and fix trailing whitespace

* fix: Fix mypy errors and format code

* feat(ai): Add model property to OpenAI provider

* Refactor MCP server to use typed models and tool docs

Refactors MCP server to use typed model attributes instead of dicts for accounts, profiles, and posts, improving type safety and code clarity. Adds the @use_tool_def decorator to all MCP tool functions, automatically applying centralized docstrings from tool_definitions.py. Updates tool_definitions.py to expand tool documentation, add summaries, and improve MDX generation. Updates README examples to use enums and new tool names. Bumps version to 1.1.1 and regenerates models for improved type annotations.

* Update lint config and import Any in server.py

Added per-file ignores for generated models in Ruff config to allow old-style annotations and trailing whitespace. Also imported 'Any' from typing in src/late/mcp/server.py.

---------

Co-authored-by: Carlos Martínez <carlimvg02@gmail.com>

Author: getlatedev

README.md

@@ -17,19 +17,18 @@ pip install late-sdk
 ## Quick Start
 
 ```python
-from late import Late
+from datetime import datetime, timedelta
+from late import Late, Platform
 
 client = Late(api_key="your_api_key")
 
 # List connected accounts
 accounts = client.accounts.list()
 
 # Create a scheduled post
-from datetime import datetime, timedelta
-
 post = client.posts.create(
     content="Hello from Late!",
-    platforms=[{"platform": "twitter", "accountId": "your_account_id"}],
+    platforms=[{"platform": Platform.TWITTER, "accountId": "your_account_id"}],
     scheduled_for=datetime.now() + timedelta(hours=1),
 )
 ```
@@ -119,13 +118,13 @@ Since Claude can't access local files, use the browser upload flow:
 
 | Command | What it does |
 |---------|--------------|
-| `list_accounts` | Show connected social accounts |
-| `create_post` | Create scheduled or immediate post |
-| `publish_now` | Publish immediately |
-| `cross_post` | Post to multiple platforms |
-| `list_posts` | Show your posts |
-| `retry_post` | Retry a failed post |
-| `generate_upload_link` | Get link to upload media |
+| `accounts_list` | Show connected social accounts |
+| `posts_create` | Create scheduled, immediate, or draft post |
+| `posts_publish_now` | Publish immediately |
+| `posts_cross_post` | Post to multiple platforms |
+| `posts_list` | Show your posts |
+| `posts_retry` | Retry a failed post |
+| `media_generate_upload_link` | Get link to upload media |
 
 ---
 
@@ -144,22 +143,27 @@ async def main():
 asyncio.run(main())
 ```
 
-### AI Content Generation
+### AI Content Generation (Experimental)
 
 ```bash
 pip install late-sdk[ai]
 ```
 
 ```python
+from late import Platform, CaptionTone
 from late.ai import ContentGenerator, GenerateRequest
 
-generator = ContentGenerator(provider="openai", api_key="sk-...")
+generator = ContentGenerator(
+    provider="openai",
+    api_key="sk-...",
+    model="gpt-4o-mini",  # or gpt-4o, gpt-4-turbo, etc.
+)
 
 response = generator.generate(
     GenerateRequest(
         prompt="Write a tweet about Python",
-        platform="twitter",
-        tone="casual",
+        platform=Platform.TWITTER,
+        tone=CaptionTone.CASUAL,
     )
 )
 
@@ -185,15 +189,16 @@ results = pipeline.schedule("posts.csv")
 ### Cross-Posting
 
 ```python
+from late import Platform
 from late.pipelines import CrossPosterPipeline, PlatformConfig
 
 cross_poster = CrossPosterPipeline(client)
 
 results = await cross_poster.post(
     content="Big announcement!",
     platforms=[
-        PlatformConfig("twitter", "tw_123"),
-        PlatformConfig("linkedin", "li_456", delay_minutes=5),
+        PlatformConfig(Platform.TWITTER, "tw_123"),
+        PlatformConfig(Platform.LINKEDIN, "li_456", delay_minutes=5),
     ],
 )
 ```

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "late-sdk"
-version = "1.1.0"
+version = "1.1.1"
 description = "Python SDK for Late API - Social Media Scheduling"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -113,6 +113,10 @@ ignore = [
     "B008",   # do not perform function calls in argument defaults
 ]
 
+[tool.ruff.lint.per-file-ignores]
+"**/models/_generated/*" = ["UP006", "UP007", "UP035", "W291"]  # Allow old-style annotations and trailing whitespace in generated code
+"**/models/_generated/**" = ["UP006", "UP007", "UP035", "W291"]
+
 [tool.ruff.lint.isort]
 known-first-party = ["late"]
 

scripts/generate_mcp_docs.py

@@ -7,6 +7,8 @@
 
 This script generates MDX documentation from the centralized tool definitions
 in src/late/mcp/tool_definitions.py
+
+The generated output can be copied into the docs site.
 """
 
 import sys
@@ -15,18 +17,19 @@
 # Add src to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
 
-from late.mcp.tool_definitions import generate_mdx_docs, TOOL_DEFINITIONS
+from late.mcp.tool_definitions import TOOL_DEFINITIONS, generate_mdx_tools_reference
 
 
-def main():
+def main() -> None:
     """Generate and print MDX documentation."""
     print("=" * 60)
     print("MCP Tool Documentation (generated from tool_definitions.py)")
     print("=" * 60)
     print()
-    print(generate_mdx_docs())
+    print(generate_mdx_tools_reference())
     print()
     print("=" * 60)
+    print(f"Total tools: {len(TOOL_DEFINITIONS)}")
     print("Copy the above into claude-mcp.mdx under '## Tool Reference'")
     print("=" * 60)
 

src/late/__init__.py

@@ -31,7 +31,7 @@
     Visibility,
 )
 
-__version__ = "1.1.0"
+__version__ = "1.1.1"
 
 __all__ = [
     # Client