synapsekit 1.4.2__tar.gz → 1.4.7__tar.gz

synapsekit-1.4.7/.github/discord-members.json

@@ -0,0 +1 @@
+{}

synapsekit-1.4.7/.github/workflows/discord-contributor.yml

@@ -0,0 +1,45 @@
+name: Assign Discord Contributor Role
+
+on:
+  pull_request:
+    types: [closed]
+
+permissions:
+  contents: read
+
+jobs:
+  assign-role:
+    if: github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Look up Discord ID for PR author
+        id: lookup
+        shell: bash
+        run: |
+          set -euo pipefail
+          GH_USER="${{ github.event.pull_request.user.login }}"
+          if [ ! -f .github/discord-members.json ]; then
+            echo "discord_id=" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          DISCORD_ID=$(jq -r --arg user "$GH_USER" '.[$user] // empty' .github/discord-members.json)
+          echo "discord_id=$DISCORD_ID" >> "$GITHUB_OUTPUT"
+
+      - name: Assign Contributor role
+        if: steps.lookup.outputs.discord_id != ''
+        env:
+          DISCORD_BOT_TOKEN: ${{ secrets.DISCORD_BOT_TOKEN }}
+          DISCORD_GUILD_ID: ${{ secrets.DISCORD_GUILD_ID }}
+          DISCORD_CONTRIBUTOR_ROLE_ID: ${{ secrets.DISCORD_CONTRIBUTOR_ROLE_ID }}
+        run: |
+          set -euo pipefail
+          if [ -z "$DISCORD_BOT_TOKEN" ] || [ -z "$DISCORD_GUILD_ID" ] || [ -z "$DISCORD_CONTRIBUTOR_ROLE_ID" ]; then
+            echo "Missing DISCORD_* secrets; skipping role assignment."
+            exit 0
+          fi
+          curl -sS -X PUT \
+            -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
+            -H "Content-Type: application/json" \
+            "https://discord.com/api/v10/guilds/$DISCORD_GUILD_ID/members/${{ steps.lookup.outputs.discord_id }}/roles/$DISCORD_CONTRIBUTOR_ROLE_ID"

synapsekit-1.4.7/.github/workflows/discord-issues.yml

@@ -0,0 +1,30 @@
+name: Post good-first-issues to Discord
+
+on:
+  issues:
+    types: [labeled]
+
+permissions:
+  issues: read
+
+jobs:
+  notify:
+    if: |
+      github.event.label.name == 'good first issue' ||
+      github.event.label.name == 'help wanted'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Post to Discord
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_GOOD_FIRST_ISSUES_WEBHOOK }}
+          TITLE: ${{ github.event.issue.title }}
+          URL: ${{ github.event.issue.html_url }}
+        run: |
+          set -euo pipefail
+          if [ -z "$DISCORD_WEBHOOK" ]; then
+            echo "Missing DISCORD_GOOD_FIRST_ISSUES_WEBHOOK; skipping."
+            exit 0
+          fi
+          curl -sS -H "Content-Type: application/json" \
+            -d "{\"content\": \"👋 **New issue open for contribution:**\\n$TITLE\\n$URL\"}" \
+            "$DISCORD_WEBHOOK"

{synapsekit-1.4.2 → synapsekit-1.4.7}/.gitignore

@@ -63,6 +63,8 @@ Thumbs.db
 .claude/
 CLAUDE.md
 
+#QWEN
+.qwen/
 
 # Internal docs (not published)
 docs/

{synapsekit-1.4.2 → synapsekit-1.4.7}/CHANGELOG.md

@@ -7,6 +7,90 @@ SynapseKit uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.4.8] — 2026-04-03
+
+### Added
+
+- **WikipediaLoader** — load Wikipedia articles as Documents via `wikipedia-api`; pipe-delimited multi-title support; async `aload()`; `pip install synapsekit[wikipedia]`
+- **ArXivLoader** — search arXiv and load papers as Documents (downloads PDFs); uses arxiv v2 `Client` API; async `aload()`; `pip install synapsekit[arxiv,pdf]`
+- **EmailLoader** — load emails from IMAP mailboxes (Gmail, Outlook, etc.) as Documents; stdlib-only, no extra deps; configurable folder and IMAP search; async `aload()`
+- **ColBERTRetriever** — late-interaction ColBERT retrieval via RAGatouille; `add()`, `retrieve()`, `retrieve_with_scores()`; lazy-loads ragatouille on first use; `pip install synapsekit[colbert]`
+- 50 new tests (1500 total)
+
+---
+
+## [1.4.7] — 2026-04-02
+
+### Added
+
+- **SlackLoader** — load messages from Slack channels via Bot API; sync `load()` and async `aload()`; configurable `limit`; per-message metadata; `pip install synapsekit[slack]`
+- **NotionLoader** — load pages or full databases from Notion via the Notion API; sync `load()` and async `aload()`; configurable retry/timeout; `pip install synapsekit[notion]`
+- **NotionTool** — agent tool for Notion: `search`, `get_page`, `create_page`, `append_block`; built-in retry with exponential back-off; `pip install synapsekit[notion]`
+- **Subgraph error handling** — `subgraph_node()` gains `on_error` (`"raise"` / `"retry"` / `"fallback"` / `"skip"`), `max_retries`, and `fallback` parameters
+- 17 new tests (1467 total)
+
+---
+
+## [1.4.6] — 2026-04-01
+
+### Added
+
+- **Subgraph error handling** — `subgraph_node()` gains four keyword-only parameters: `on_error` (`"raise"` / `"retry"` / `"fallback"` / `"skip"`), `max_retries` (default 3), and `fallback` (a secondary `CompiledGraph`). On any handled failure the parent state receives `"__subgraph_error__"` with `"type"`, `"message"`, and `"attempts"` keys. Backward-compatible: default behaviour (`on_error="raise"`) is unchanged. (#378)
+- 17 new tests (1450 total)
+
+---
+
+## [1.4.5] — 2026-03-31
+
+### Added
+
+- **WeaviateVectorStore** — Weaviate v4 client; lazy collection creation; cosine vector search via `query.near_vector`; metadata filtering; `pip install synapsekit[weaviate]`
+- **PGVectorStore** — PostgreSQL + pgvector; async psycopg3; cosine / L2 / inner-product distance; SQL-injection-safe via `psycopg.sql.Identifier`; metadata JSONB; `pip install synapsekit[pgvector]`
+- **MilvusVectorStore** — IVF_FLAT and HNSW index types; `MilvusIndexType` enum; metadata filtering via Milvus expressions; Zilliz Cloud support; `pip install synapsekit[milvus]`
+- **LanceDBVectorStore** — embedded, serverless; local and cloud (S3/GCS) storage; automatic FTS index; metadata filtering; `pip install synapsekit[lancedb]`
+
+All four backends follow the existing lazy-import `_BACKENDS` pattern and are included in `synapsekit[all]`.
+
+- 0 new tests (1433 total)
+
+---
+
+## [1.4.4] — 2026-03-30
+
+### Added
+
+- **SambaNova provider** — fast inference on Meta Llama, Qwen, and other open models via SambaNova Cloud's OpenAI-compatible API; requires `pip install synapsekit[openai]`; always set `provider="sambanova"`
+- **GoogleDriveLoader** — load files and folders from Google Drive via service-account credentials; supports Google Docs (text export), Sheets (CSV export), PDFs, and text files; `pip install synapsekit[gdrive]`
+- **`split_with_metadata()`** — new method on `BaseSplitter`; returns `list[dict]` with `text` and `metadata` keys; automatically injects `chunk_index`; all splitters inherit it
+
+### Fixed
+
+- `asyncio.get_event_loop()` → `asyncio.get_running_loop()` in `GoogleDriveLoader` (deprecated in Python 3.10+)
+- `build()` in `GoogleDriveLoader.aload()` wrapped in executor (was blocking the event loop)
+- Failed file downloads in `GoogleDriveLoader._load_folder` now log a warning instead of silently skipping
+
+- 49 new tests (1452 total)
+
+---
+
+## [1.4.3] — 2026-03-29
+
+### Added
+
+- **XMLLoader** — load XML files via stdlib `xml.etree.ElementTree`; optional `tags` filter; no new dependencies
+- **DiscordLoader** — load messages from Discord channels via bot token; `before_message_id` / `after_message_id` pagination; rich metadata (author, timestamp, attachments); `pip install synapsekit[discord]`
+- **PythonREPLTool timeout** — `timeout: float = 5.0` parameter; Unix uses `signal.SIGALRM`, Windows uses `multiprocessing.Process`; security warning logged on instantiation
+
+### Improved
+
+- **Mermaid conditional edges** — render as dashed arrows (`-.->`) to distinguish from deterministic edges; branch labels prefixed with condition function name (e.g. `route:approve`)
+- **SQLiteCheckpointer** — supports `async with` for automatic connection cleanup
+- **Windows compatibility** — `audio/x-wav` MIME normalised to `audio/wav`; shell timeout test uses portable Python sleep; graph tracer uses `time.perf_counter()` for sub-millisecond resolution
+
+- 35 new tests (1403 total)
+
+---
+
 ## [1.4.2] — 2026-03-28
 
 ### Added

synapsekit-1.4.7/DISCORD_AUTOMOD.md

@@ -0,0 +1,41 @@
+# SynapseKit Discord Automod & Spam Protection
+
+Draft for issue #394.
+
+## Tool
+Use **Carl-bot** (Automod) — free, no code.
+
+Carl-bot dashboard: https://carl.gg
+
+---
+
+## Automod rules to configure
+
+| Rule | Action | Target |
+|---|---|---|
+| New account < 7 days old | Kick + DM warning | @everyone |
+| Posting links in first 10 minutes | Delete + warn | New members |
+| More than 5 messages in 5 seconds | Mute 10 min + log | @everyone |
+| Discord invite links | Delete + warn | @everyone (except Moderator+) |
+| Spam caps (ALL CAPS > 70%) | Delete | @everyone |
+| Known phishing domains | Ban + log | @everyone |
+
+---
+
+## Logging
+
+Create a private **#mod-log** channel (Admin + Moderator only) and point Carl-bot automod logs there.
+
+---
+
+## Slowmode
+
+- **#general** — 5s slowmode
+- **#introductions** — 10s slowmode
+- **Help channels** — no slowmode
+
+---
+
+## Setup path
+
+Carl-bot dashboard → Automod → enable each rule. Takes about 10 minutes.

synapsekit-1.4.7/DISCORD_COMMANDS.md

@@ -0,0 +1,33 @@
+# SynapseKit Discord Custom Commands
+
+Draft for issue #396.
+
+## Tool
+Use **Carl-bot** (Custom Commands).
+
+Carl-bot dashboard: https://carl.gg
+
+---
+
+## Commands to set up
+
+| Command | Response |
+|---|---|
+| `/docs` | https://synapsekit.github.io/synapsekit-docs/ |
+| `/docs rag` | https://synapsekit.github.io/synapsekit-docs/docs/rag/pipeline |
+| `/docs agents` | https://synapsekit.github.io/synapsekit-docs/docs/agents/overview |
+| `/docs graph` | https://synapsekit.github.io/synapsekit-docs/docs/graph/overview |
+| `/docs providers` | https://synapsekit.github.io/synapsekit-docs/docs/llms/overview |
+| `/docs install` | https://synapsekit.github.io/synapsekit-docs/docs/getting-started/installation |
+| `/docs quickstart` | https://synapsekit.github.io/synapsekit-docs/docs/getting-started/quickstart |
+| `/changelog` | https://synapsekit.github.io/synapsekit-docs/docs/changelog |
+| `/pypi` | https://pypi.org/project/synapsekit/ |
+| `/github` | https://github.com/SynapseKit/SynapseKit |
+
+---
+
+## Setup path
+
+Carl-bot dashboard → Custom Commands → create each command above. Takes ~15 mins.
+
+These work in all channels so anyone can type `/docs rag` and get the link instantly.

synapsekit-1.4.7/DISCORD_INTEREST_ROLES.md

@@ -0,0 +1,39 @@
+# SynapseKit Discord Interest Roles (Buttons in #roles)
+
+Draft for issue #393.
+
+## Tool
+Use **Carl-bot** (Reaction Roles / Button Roles).
+
+Carl-bot dashboard: https://carl.gg
+
+---
+
+## Message to pin in #roles
+
+```
+Pick what you're building with SynapseKit.
+You can select multiple.
+
+🗂  RAG Builder        — pipelines, loaders, retrievers
+🤖  Agent Builder      — tools, ReAct, function calling
+🔀  Graph Builder      — StateGraph, workflows, HITL
+🧠  LLM Explorer       — providers, caching, cost routing
+📖  Docs / Writer      — docs improvements, examples
+```
+
+---
+
+## Setup steps
+
+1. Carl-bot dashboard → Reaction Roles → Create new.
+2. Paste the message above, add emoji → role mappings.
+3. Set mode to **Toggle** (click once to add, again to remove).
+4. Post in `#roles` with **send-as-bot** enabled.
+5. Lock `#roles` so only the bot can post (members interact via buttons only).
+
+---
+
+## Why this matters
+
+Lets us @-mention specific groups (e.g., **@RAG Builder**) instead of @everyone.

synapsekit-1.4.7/DISCORD_RELEASE_WEBHOOKS.md

@@ -0,0 +1,31 @@
+# SynapseKit Discord Release Webhooks
+
+Draft for issue #390.
+
+## What this does
+
+Automatically posts new GitHub releases to Discord so `#changelog` stays up to date without manual copy-pasting.
+
+## Setup
+
+1. In GitHub, go to the repo → Settings → Webhooks → Add webhook.
+2. Set the payload URL to the Discord channel webhook URL.
+3. Use content type `application/json`.
+4. Select individual events and enable only `Releases`.
+5. Save the webhook.
+
+## Discord result
+
+A published release should show something like:
+
+> 🚀 **New release: v1.4.6**
+> Subgraph error handling — retry, fallback, skip
+> [View release](https://github.com/SynapseKit/SynapseKit/releases/tag/v1.4.6)
+
+## Optional extra
+
+If you want a wider announcement, point the same GitHub release webhook at `#announcements` too.
+
+## Channel target
+
+`#changelog` is the main target for this automation.

synapsekit-1.4.7/DISCORD_ROLES.md

@@ -0,0 +1,37 @@
+# SynapseKit Discord Roles & Permissions
+
+Draft for issue #389.
+
+## Role hierarchy
+
+| Role | Color | Who gets it | How |
+|---|---|---|---|
+| Admin | Red | Amit, Abhay | Manual |
+| Moderator | Orange | Trusted members later | Manual |
+| Contributor | Green | Anyone with a merged PR | Manual for now; see #391 for automation |
+| Member | Blue/grey | Everyone on join | Auto via Carl-bot welcome |
+| Bot | Dark grey | All bots | Manual |
+
+## Interest roles
+
+These are self-assign in `#roles` and do not unlock channels:
+
+- 🗂 RAG Builder
+- 🤖 Agent Builder
+- 🔀 Graph Builder
+- 🧠 LLM Explorer
+- 📖 Docs / Writer
+
+## Setup steps
+
+1. Create the roles in Server Settings → Roles.
+2. Set the role colors.
+3. Order them as: Admin > Moderator > Contributor > Member > @everyone.
+4. Lock `#contributors-chat` to Contributor+ only.
+5. Lock `#announcements` and `#changelog` to admin-only posting.
+
+## Permissions
+
+- `#contributors-chat` — visible to Contributor, Moderator, and Admin.
+- `#announcements` — visible to everyone, posting restricted to Admin only.
+- `#changelog` — visible to everyone, posting restricted to Admin only.

synapsekit-1.4.7/DISCORD_WELCOME.md

@@ -0,0 +1,58 @@
+# SynapseKit Discord Welcome & Onboarding
+
+Draft for issue #392.
+
+## Tool
+Use **Carl-bot** (free, no code needed).
+
+Carl-bot dashboard: https://carl.gg
+
+---
+
+## 1) Welcome DM (Welcomer → DM)
+
+```
+Hey, welcome to the SynapseKit community! 👋
+
+A few things to get started:
+• Head to #roles and pick what you're building
+• Introduce yourself in #introductions
+• If you need help, drop a message in the relevant #*-help channel
+
+Docs: https://synapsekit.github.io/synapsekit-docs/
+GitHub: https://github.com/SynapseKit/SynapseKit
+
+Glad to have you here.
+```
+
+---
+
+## 2) Auto-assign Member role (Autoroles)
+
+- Role: **Member**
+- Trigger: on join
+
+---
+
+## 3) Welcome message in #introductions (Welcomer → Channel)
+
+```
+Welcome {user}! Tell us what you're building 🛠
+```
+
+---
+
+## 4) #rules pinned message (keep it short)
+
+- Be respectful
+- Keep questions in the right help channel
+- No spam or self-promo without context
+- English preferred (or include a translation)
+- No DM-ing members without permission
+
+---
+
+## Notes
+
+- Set up channel structure first (see COMMUNITY.md / DISCORD_ROLES.md).
+- If you change channel names, update the DM text accordingly.

{synapsekit-1.4.2 → synapsekit-1.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapsekit
-Version: 1.4.2
+Version: 1.4.7
 Summary: Async-native Python framework for building production-grade LLM applications. Streaming-first, 2 dependencies, fully transparent.
 Project-URL: Homepage, https://github.com/SynapseKit/SynapseKit
 Project-URL: Repository, https://github.com/SynapseKit/SynapseKit
@@ -29,39 +29,51 @@ Provides-Extra: all
 Requires-Dist: ai21>=2.0; extra == 'all'
 Requires-Dist: aiomcache>=0.8; extra == 'all'
 Requires-Dist: anthropic>=0.25; extra == 'all'
+Requires-Dist: arxiv>=2.0; extra == 'all'
 Requires-Dist: beautifulsoup4>=4.12; extra == 'all'
 Requires-Dist: boto3>=1.34; extra == 'all'
 Requires-Dist: chromadb>=0.5; extra == 'all'
 Requires-Dist: cohere>=5.0; extra == 'all'
+Requires-Dist: discord-py>=2.0; extra == 'all'
 Requires-Dist: duckduckgo-search>=6.0; extra == 'all'
 Requires-Dist: erniebot>=0.5; extra == 'all'
 Requires-Dist: faiss-cpu>=1.7; extra == 'all'
 Requires-Dist: fastapi>=0.110; extra == 'all'
+Requires-Dist: google-api-python-client>=2.0; extra == 'all'
+Requires-Dist: google-auth>=2.0; extra == 'all'
 Requires-Dist: google-cloud-aiplatform>=1.38; extra == 'all'
 Requires-Dist: google-generativeai>=0.7; extra == 'all'
 Requires-Dist: google-search-results>=2.4; extra == 'all'
 Requires-Dist: groq>=0.9; extra == 'all'
 Requires-Dist: httpx>=0.27; extra == 'all'
 Requires-Dist: huggingface-hub>=0.20; extra == 'all'
+Requires-Dist: lancedb>=0.5; extra == 'all'
 Requires-Dist: llama-cpp-python>=0.2; extra == 'all'
 Requires-Dist: lxml>=5.0; extra == 'all'
 Requires-Dist: mcp>=1.0; extra == 'all'
 Requires-Dist: mistralai>=1.0; extra == 'all'
 Requires-Dist: ollama>=0.2; extra == 'all'
 Requires-Dist: openai>=1.0; extra == 'all'
+Requires-Dist: pgvector>=0.2; extra == 'all'
 Requires-Dist: pinecone>=3.0; extra == 'all'
 Requires-Dist: psycopg[binary]>=3.1; extra == 'all'
+Requires-Dist: pymilvus>=2.4; extra == 'all'
 Requires-Dist: pypdf>=4.0; extra == 'all'
 Requires-Dist: pyyaml>=6.0; extra == 'all'
 Requires-Dist: qdrant-client>=1.9; extra == 'all'
+Requires-Dist: ragatouille; extra == 'all'
 Requires-Dist: redis>=5.0; extra == 'all'
 Requires-Dist: sentence-transformers>=2.7; extra == 'all'
 Requires-Dist: tavily-python>=0.3; extra == 'all'
 Requires-Dist: uvicorn[standard]>=0.29; extra == 'all'
+Requires-Dist: weaviate-client>=4.0; extra == 'all'
+Requires-Dist: wikipedia-api>=0.6; extra == 'all'
 Requires-Dist: wolframalpha>=5.0; extra == 'all'
 Requires-Dist: youtube-search-python>=1.6; extra == 'all'
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.25; extra == 'anthropic'
+Provides-Extra: arxiv
+Requires-Dist: arxiv>=2.0; extra == 'arxiv'
 Provides-Extra: audio
 Requires-Dist: openai>=1.0; extra == 'audio'
 Provides-Extra: aws-lambda
@@ -74,6 +86,10 @@ Provides-Extra: cloudflare
 Requires-Dist: httpx>=0.27; extra == 'cloudflare'
 Provides-Extra: cohere
 Requires-Dist: cohere>=5.0; extra == 'cohere'
+Provides-Extra: colbert
+Requires-Dist: ragatouille; extra == 'colbert'
+Provides-Extra: discord
+Requires-Dist: discord-py>=2.0; extra == 'discord'
 Provides-Extra: docx
 Requires-Dist: python-docx>=1.0; extra == 'docx'
 Provides-Extra: dynamodb
@@ -86,6 +102,9 @@ Provides-Extra: faiss
 Requires-Dist: faiss-cpu>=1.7; extra == 'faiss'
 Provides-Extra: gcal-tool
 Requires-Dist: google-api-python-client>=2.0; extra == 'gcal-tool'
+Provides-Extra: gdrive
+Requires-Dist: google-api-python-client>=2.0; extra == 'gdrive'
+Requires-Dist: google-auth>=2.0; extra == 'gdrive'
 Provides-Extra: gemini
 Requires-Dist: google-generativeai>=0.7; extra == 'gemini'
 Provides-Extra: google-search
@@ -99,22 +118,31 @@ Provides-Extra: http
 Requires-Dist: aiohttp>=3.9; extra == 'http'
 Provides-Extra: huggingface
 Requires-Dist: huggingface-hub>=0.20; extra == 'huggingface'
+Provides-Extra: lancedb
+Requires-Dist: lancedb>=0.5; extra == 'lancedb'
 Provides-Extra: llamacpp
 Requires-Dist: llama-cpp-python>=0.2; extra == 'llamacpp'
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0; extra == 'mcp'
 Provides-Extra: memcached
 Requires-Dist: aiomcache>=0.8; extra == 'memcached'
+Provides-Extra: milvus
+Requires-Dist: pymilvus>=2.4; extra == 'milvus'
 Provides-Extra: minimax
 Requires-Dist: httpx>=0.27; extra == 'minimax'
 Provides-Extra: mistral
 Requires-Dist: mistralai>=1.0; extra == 'mistral'
+Provides-Extra: notion
+Requires-Dist: httpx>=0.27; extra == 'notion'
 Provides-Extra: ollama
 Requires-Dist: ollama>=0.2; extra == 'ollama'
 Provides-Extra: openai
 Requires-Dist: openai>=1.0; extra == 'openai'
 Provides-Extra: pdf
 Requires-Dist: pypdf>=4.0; extra == 'pdf'
+Provides-Extra: pgvector
+Requires-Dist: pgvector>=0.2; extra == 'pgvector'
+Requires-Dist: psycopg[binary]>=3.1; extra == 'pgvector'
 Provides-Extra: pinecone
 Requires-Dist: pinecone>=3.0; extra == 'pinecone'
 Provides-Extra: postgres
@@ -132,15 +160,21 @@ Requires-Dist: sentence-transformers>=2.7; extra == 'semantic'
 Provides-Extra: serve
 Requires-Dist: fastapi>=0.110; extra == 'serve'
 Requires-Dist: uvicorn[standard]>=0.29; extra == 'serve'
+Provides-Extra: slack
+Requires-Dist: slack-sdk>=3.0; extra == 'slack'
 Provides-Extra: tavily
 Requires-Dist: tavily-python>=0.3; extra == 'tavily'
 Provides-Extra: vertex
 Requires-Dist: google-cloud-aiplatform>=1.38; extra == 'vertex'
 Provides-Extra: video
 Requires-Dist: openai>=1.0; extra == 'video'
+Provides-Extra: weaviate
+Requires-Dist: weaviate-client>=4.0; extra == 'weaviate'
 Provides-Extra: web
 Requires-Dist: beautifulsoup4>=4.12; extra == 'web'
 Requires-Dist: httpx>=0.27; extra == 'web'
+Provides-Extra: wikipedia
+Requires-Dist: wikipedia-api>=0.6; extra == 'wikipedia'
 Provides-Extra: wolfram
 Requires-Dist: wolframalpha>=5.0; extra == 'wolfram'
 Provides-Extra: yaml
@@ -155,12 +189,13 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-[![PyPI version](https://img.shields.io/pypi/v/synapsekit?color=0a7bbd&label=pypi&logo=pypi&logoColor=white)](https://pypi.org/project/synapsekit/)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![PyPI version](https://img.shields.io/pypi/v/synapsekit?color=22c55e&label=pypi&logo=pypi&logoColor=white)](https://pypi.org/project/synapsekit/)
+[![Python](https://img.shields.io/badge/python-3.10%2B-22c55e?logo=python&logoColor=white)](https://www.python.org/)
 [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-22c55e)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-1305%20passing-22c55e?logo=pytest&logoColor=white)]()
-[![Downloads](https://img.shields.io/pypi/dm/synapsekit?color=0a7bbd&logo=pypi&logoColor=white)](https://pypistats.org/packages/synapsekit)
-[![Docs](https://img.shields.io/badge/docs-online-0a7bbd?logo=readthedocs&logoColor=white)](https://synapsekit.github.io/synapsekit-docs/)
+[![Tests](https://img.shields.io/badge/tests-1500%20passing-22c55e?logo=pytest&logoColor=white)]()
+[![Downloads](https://img.shields.io/pypi/dm/synapsekit?color=22c55e&logo=pypi&logoColor=white)](https://pypistats.org/packages/synapsekit)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/synapsekit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/synapsekit)
+[![Docs](https://img.shields.io/badge/docs-online-22c55e?logo=readthedocs&logoColor=white)](https://synapsekit.github.io/synapsekit-docs/)
 
 **[Documentation](https://synapsekit.github.io/synapsekit-docs/) · [Quickstart](https://synapsekit.github.io/synapsekit-docs/docs/getting-started/quickstart) · [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) · [Changelog](CHANGELOG.md) · [Report a Bug](https://github.com/SynapseKit/SynapseKit/issues/new?template=bug_report.yml)**
 
@@ -192,7 +227,7 @@ Token-level streaming is the default,<br/>not an afterthought.<br/>Works across
 <tr>
 <td align="center" width="33%">
 <h3>🔌 One interface</h3>
-19 LLM providers and 5 vector stores<br/>behind the same API.<br/>Swap without rewriting.
+27 LLM providers and 9 vector stores<br/>behind the same API.<br/>Swap without rewriting.
 </td>
 <td align="center" width="33%">
 <h3>🧩 Composable</h3>
@@ -235,7 +270,7 @@ Retrieval-augmented generation with streaming, BM25 reranking, conversation memo
 <td width="50%">
 
 **🤖 Agents**<br/>
-ReAct loop (any LLM) and native function calling (OpenAI / Anthropic / Gemini / Mistral). 35 built-in tools including calculator, Python REPL, web search, SQL, HTTP, shell, summarization, sentiment analysis, and translation. Fully extensible.
+ReAct loop (any LLM) and native function calling (OpenAI / Anthropic / Gemini / Mistral). 42 built-in tools including calculator, Python REPL, web search, SQL, HTTP, shell, arxiv, pubmed, wolfram, wikipedia, and more. Fully extensible.
 
 </td>
 </tr>
@@ -249,7 +284,7 @@ DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurr
 <td width="50%">
 
 **🧠 LLM Providers**<br/>
-OpenAI, Anthropic, Ollama, Gemini, Cohere, Mistral, Bedrock, Azure OpenAI, Groq, DeepSeek, OpenRouter, Together, Fireworks, Cerebras, Cloudflare, Moonshot, Perplexity, Vertex AI, Zhipu — all behind one interface. Auto-detected from the model name. Swap without rewriting.
+OpenAI, Anthropic, Ollama, Gemini, Cohere, Mistral, Bedrock, Azure OpenAI, Groq, DeepSeek, OpenRouter, Together, Fireworks, Cerebras, Cloudflare, Moonshot, Perplexity, Vertex AI, Zhipu, AI21 Labs, Databricks, Baidu ERNIE, llama.cpp, Minimax, Aleph Alpha, Hugging Face, SambaNova — all behind one interface. Auto-detected from the model name. Swap without rewriting.
 
 </td>
 </tr>
@@ -309,7 +344,7 @@ Everything you need to get started and go deep is in the docs.
 | 🗂 [RAG](https://synapsekit.github.io/synapsekit-docs/docs/rag/pipeline) | Pipelines, loaders, retrieval, vector stores |
 | 🤖 [Agents](https://synapsekit.github.io/synapsekit-docs/docs/agents/overview) | ReAct, function calling, tools, executor |
 | 🔀 [Graph Workflows](https://synapsekit.github.io/synapsekit-docs/docs/graph/overview) | DAG pipelines, conditional routing, parallel execution |
-| 🧠 [LLM Providers](https://synapsekit.github.io/synapsekit-docs/docs/llms/overview) | All 13 providers with examples |
+| 🧠 [LLM Providers](https://synapsekit.github.io/synapsekit-docs/docs/llms/overview) | All 27 providers with examples |
 | 📖 [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) | Full class and method reference |
 
 ---
@@ -336,6 +371,8 @@ Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started. Look for issues tagged [
 ## Community
 
 - 💬 [Discussions](https://github.com/SynapseKit/SynapseKit/discussions) — ask questions, share ideas
+- 🧭 [Discord roles draft](DISCORD_ROLES.md) — proposed roles and permissions for issue #389
+- 🧭 [Discord release webhook draft](DISCORD_RELEASE_WEBHOOKS.md) — automate release announcements for issue #390
 - 🐛 [Bug reports](https://github.com/SynapseKit/SynapseKit/issues/new?template=bug_report.yml)
 - 💡 [Feature requests](https://github.com/SynapseKit/SynapseKit/issues/new?template=feature_request.yml)
 - 🔒 [Security policy](SECURITY.md)