release: v1.2.92 - add zernio-mcp executable

.dockerignore

@@ -0,0 +1,63 @@
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Documentation (keep README.md for hatchling build)
+docs/
+examples/
+
+# Tests
+tests/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Type checking
+.mypy_cache/
+.pytype/
+.pyre/
+.dmypy.json
+
+# Linting
+.ruff_cache/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Misc
+*.log
+.DS_Store

.env.example

@@ -1,6 +1,11 @@
-# Late API Configuration
+# Late API Configuration (for STDIO mode with Claude Desktop)
+# For HTTP/SSE mode, users provide their API key via request headers
 LATE_API_KEY=your_api_key_here
 
+# Server Configuration (optional, has defaults)
+HOST=0.0.0.0
+PORT=8080
+
 # AI Provider (optional - for content generation)
 OPENAI_API_KEY=sk-your_openai_key_here
 # ANTHROPIC_API_KEY=sk-ant-your_anthropic_key_here

.github/workflows/generate.yml

@@ -0,0 +1,180 @@
+name: Regenerate
+
+on:
+  # Triggered by the API repository when OpenAPI spec changes
+  repository_dispatch:
+    types: [openapi-updated]
+
+  # Allow manual trigger
+  workflow_dispatch:
+
+jobs:
+  generate:
+    name: Regenerate from OpenAPI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Fetch latest OpenAPI spec
+        run: |
+          curl -f -o openapi.yaml https://zernio.com/openapi.yaml
+          echo "Fetched OpenAPI spec:"
+          head -20 openapi.yaml
+
+      - name: Generate resources
+        run: |
+          echo "Starting resource generation..."
+          uv run python scripts/generate_resources.py
+          echo "Resource generation complete."
+
+      - name: Generate models
+        run: |
+          echo "Starting model generation..."
+          uv run python scripts/generate_models.py || echo "Model generation skipped (requires local docs repo)"
+          echo "Model generation complete."
+
+      - name: Generate MCP tools
+        run: |
+          echo "Starting MCP tool generation..."
+          uv run --with pyyaml python scripts/generate_mcp_tools.py
+          echo "MCP tool generation complete."
+
+      - name: Generate README SDK Reference
+        run: |
+          echo "Starting README SDK Reference generation..."
+          uv run python scripts/generate_readme_reference.py
+          echo "README SDK Reference generation complete."
+
+      - name: Run linter (fix formatting)
+        run: |
+          uv run ruff check --fix src/late/resources/_generated/ || true
+          uv run ruff format src/late/resources/_generated/ || true
+          uv run ruff check --fix src/late/mcp/generated_tools.py || true
+          uv run ruff format src/late/mcp/generated_tools.py || true
+
+      - name: Run tests
+        run: uv run pytest tests -v --tb=short
+
+      - name: Check for changes
+        id: changes
+        run: |
+          git add -A
+          if git diff --staged --quiet; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "Changes detected:"
+            git diff --staged --name-only
+          fi
+
+      - name: Bump version and commit
+        if: steps.changes.outputs.has_changes == 'true'
+        id: version
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Get current version
+          CURRENT_VERSION=$(uv run python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          echo "Current version: $CURRENT_VERSION"
+
+          # Bump patch version
+          IFS='.' read -ra VERSION_PARTS <<< "$CURRENT_VERSION"
+          MAJOR="${VERSION_PARTS[0]}"
+          MINOR="${VERSION_PARTS[1]}"
+          PATCH="${VERSION_PARTS[2]}"
+          NEW_PATCH=$((PATCH + 1))
+          NEW_VERSION="$MAJOR.$MINOR.$NEW_PATCH"
+          echo "New version: $NEW_VERSION"
+
+          # Update version in pyproject.toml
+          sed -i "s/version = \"$CURRENT_VERSION\"/version = \"$NEW_VERSION\"/" pyproject.toml
+
+          # Also update __init__.py if it has a version
+          sed -i "s/__version__ = \".*\"/__version__ = \"$NEW_VERSION\"/" src/late/__init__.py || true
+
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+
+          # Stage all changes
+          git add -A
+
+          # Commit
+          git commit -m "chore: regenerate from OpenAPI spec
+
+          - Auto-generated SDK updates
+          - Version: $NEW_VERSION"
+          git push
+
+      - name: Build package
+        if: steps.changes.outputs.has_changes == 'true'
+        run: uv build
+
+      - name: Create GitHub Release
+        if: steps.changes.outputs.has_changes == 'true'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.version.outputs.new_version }}
+          name: v${{ steps.version.outputs.new_version }}
+          files: dist/*
+          generate_release_notes: true
+          body: |
+            ## Auto-generated SDK Update
+
+            This release was automatically generated from the latest OpenAPI spec.
+
+            This package is published under two names:
+
+            ```bash
+            pip install late-sdk==${{ steps.version.outputs.new_version }}
+            # or
+            pip install zernio-sdk==${{ steps.version.outputs.new_version }}
+            ```
+
+      - name: Publish late-sdk to PyPI
+        if: steps.changes.outputs.has_changes == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Swap package name to zernio-sdk
+        if: steps.changes.outputs.has_changes == 'true'
+        run: |
+          python3 -c "
+          import re
+          with open('pyproject.toml', 'r') as f:
+              content = f.read()
+          content = re.sub(r'name = \"late-sdk\"', 'name = \"zernio-sdk\"', content)
+          with open('pyproject.toml', 'w') as f:
+              f.write(content)
+          "
+
+      - name: Build as zernio-sdk
+        if: steps.changes.outputs.has_changes == 'true'
+        run: |
+          rm -rf dist/
+          uv build
+
+      - name: Publish zernio-sdk to PyPI
+        if: steps.changes.outputs.has_changes == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/release.yml

@@ -94,8 +94,42 @@ jobs:
           name: v${{ steps.version.outputs.version }}
           files: dist/*
           generate_release_notes: true
+          body: |
+            ## Install
 
-      - name: Publish to PyPI
+            This package is published under two names:
+
+            ```bash
+            pip install late-sdk==${{ steps.version.outputs.version }}
+            # or
+            pip install zernio-sdk==${{ steps.version.outputs.version }}
+            ```
+
+      - name: Publish late-sdk to PyPI
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Swap package name to zernio-sdk
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          python3 -c "
+          import re
+          with open('pyproject.toml', 'r') as f:
+              content = f.read()
+          content = re.sub(r'name = \"late-sdk\"', 'name = \"zernio-sdk\"', content)
+          with open('pyproject.toml', 'w') as f:
+              f.write(content)
+          "
+
+      - name: Build as zernio-sdk
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          rm -rf dist/
+          uv build
+
+      - name: Publish zernio-sdk to PyPI
         if: steps.check_tag.outputs.exists == 'false'
         uses: pypa/gh-action-pypi-publish@release/v1
         with:

CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to the Late Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.0] - 2025-01-16
+
+### Added
+- MCP (Model Context Protocol) server support for Claude Desktop integration
+- HTTP server mode for MCP (`late-mcp-http`)
+- AI content generation module with OpenAI and Anthropic support
+- Pipelines for common workflows (CSV scheduler, cross-poster)
+- Large file upload support via Vercel Blob
+- Progress callbacks for file uploads
+- Comprehensive test suite with pytest
+
+### Changed
+- Improved error handling with specialized exception classes
+- Better async support throughout the SDK
+
+## [1.1.0] - 2025-01-10
+
+### Added
+- Upload module with `SmartUploader` for automatic upload strategy selection
+- Direct upload for files under 4MB
+- Multipart upload support for large files
+- `upload_bytes()` and `upload_large_bytes()` methods
+
+## [1.0.0] - 2025-01-01
+
+### Added
+- Initial public release
+- Full coverage of Late API endpoints
+- Support for all 13 social media platforms: Instagram, TikTok, YouTube, LinkedIn, X/Twitter, Facebook, Pinterest, Threads, Bluesky, Reddit, Snapchat, Telegram, and Google Business Profile
+- Async support with `alist()`, `acreate()`, etc.
+- Type hints and Pydantic models
+- Error handling with `LateAPIError`, `LateRateLimitError`, `LateValidationError`
+
+### API Coverage
+- Posts: create, list, get, update, delete, retry, bulk upload
+- Accounts: list, get, follower stats
+- Profiles: create, list, get, update, delete
+- Analytics: get metrics, usage stats
+- Account Groups: create, list, update, delete
+- Queue: slots management, preview
+- Webhooks: settings management, logs, testing
+- API Keys: create, list, delete
+- Media: upload, generate upload token
+- Tools: downloads, hashtag checking, transcripts, AI caption generation
+- Users: list, get
+- Usage: stats
+- Logs: list, get
+- Connect: OAuth flows for all platforms
+- Reddit: feed, search
+- Invites: platform invites management

Dockerfile

@@ -0,0 +1,21 @@
+# Late MCP HTTP Server - Railway Deployment
+# Uses uv for fast, reliable dependency management
+
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim
+
+WORKDIR /app
+
+# Copy dependency files
+COPY pyproject.toml uv.lock README.md ./
+COPY src ./src
+
+# Install dependencies (no dev dependencies in production)
+RUN uv sync --frozen --no-dev --extra mcp
+
+# Expose port (Railway will set PORT env var)
+EXPOSE 8080
+
+# Health check for Railway monitoring (Railway will use /health endpoint)
+
+# Run HTTP server (Railway sets PORT env var automatically)
+CMD ["sh", "-c", "uv run late-mcp-http --host 0.0.0.0 --port ${PORT:-8080}"]