synapsekit 1.4.2__tar.gz → 1.4.6__tar.gz

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

@@ -7,6 +7,66 @@ SynapseKit uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [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.2 → synapsekit-1.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapsekit
-Version: 1.4.2
+Version: 1.4.6
 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
@@ -33,24 +33,30 @@ 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'
@@ -58,6 +64,7 @@ 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: wolframalpha>=5.0; extra == 'all'
 Requires-Dist: youtube-search-python>=1.6; extra == 'all'
 Provides-Extra: anthropic
@@ -74,6 +81,8 @@ Provides-Extra: cloudflare
 Requires-Dist: httpx>=0.27; extra == 'cloudflare'
 Provides-Extra: cohere
 Requires-Dist: cohere>=5.0; extra == 'cohere'
+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 +95,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,12 +111,16 @@ 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
@@ -115,6 +131,9 @@ 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
@@ -138,6 +157,8 @@ 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'
@@ -155,12 +176,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-1433%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 +214,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 5 vector stores<br/>behind the same API.<br/>Swap without rewriting.
 </td>
 <td align="center" width="33%">
 <h3>🧩 Composable</h3>
@@ -235,7 +257,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). 41 built-in tools including calculator, Python REPL, web search, SQL, HTTP, shell, arxiv, pubmed, wolfram, wikipedia, and more. Fully extensible.
 
 </td>
 </tr>
@@ -249,7 +271,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 +331,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 |
 
 ---

{synapsekit-1.4.2 → synapsekit-1.4.6}/README.md

@@ -4,12 +4,13 @@
 
 <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-1433%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)**
 
@@ -41,7 +42,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 5 vector stores<br/>behind the same API.<br/>Swap without rewriting.
 </td>
 <td align="center" width="33%">
 <h3>🧩 Composable</h3>
@@ -84,7 +85,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). 41 built-in tools including calculator, Python REPL, web search, SQL, HTTP, shell, arxiv, pubmed, wolfram, wikipedia, and more. Fully extensible.
 
 </td>
 </tr>
@@ -98,7 +99,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>
@@ -158,7 +159,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 |
 
 ---

synapsekit-1.4.6/assets/banner.svg

@@ -0,0 +1,54 @@
+<svg width="900" height="200" viewBox="0 0 900 200" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="nodegrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#22c55e"/>
+      <stop offset="100%" style="stop-color:#15803d"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Background: clean off-white -->
+  <rect width="900" height="200" fill="#f8fafc" rx="12"/>
+
+  <!-- Left green accent bar -->
+  <rect x="0" y="0" width="5" height="200" fill="#22c55e"/>
+
+  <!-- Subtle dot grid -->
+  <pattern id="dots" x="0" y="0" width="20" height="20" patternUnits="userSpaceOnUse">
+    <circle cx="10" cy="10" r="1" fill="#e2e8f0"/>
+  </pattern>
+  <rect x="5" y="0" width="895" height="200" fill="url(#dots)" opacity="0.9"/>
+  <rect x="5" y="0" width="895" height="200" fill="#f8fafc" opacity="0.7"/>
+
+  <!-- Graph node logo mark -->
+  <circle cx="55" cy="100" r="10" fill="url(#nodegrad)"/>
+  <circle cx="88" cy="76"  r="7"  fill="#16a34a" opacity="0.85"/>
+  <circle cx="88" cy="124" r="7"  fill="#16a34a" opacity="0.85"/>
+  <line x1="64" y1="95"  x2="82" y2="80"  stroke="url(#nodegrad)" stroke-width="2.2" stroke-linecap="round"/>
+  <line x1="64" y1="105" x2="82" y2="120" stroke="url(#nodegrad)" stroke-width="2.2" stroke-linecap="round"/>
+
+  <!-- Vertical divider -->
+  <line x1="113" y1="68" x2="113" y2="132" stroke="#cbd5e1" stroke-width="1.5"/>
+
+  <!-- SynapseKit wordmark -->
+  <text x="130" y="119" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif" font-size="50" font-weight="800" fill="#0f172a" letter-spacing="-2">SynapseKit</text>
+
+  <!-- Tagline -->
+  <text x="132" y="146" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="12.5" fill="#64748b" letter-spacing="0.2">async-native Python · RAG pipelines · agents · graph workflows · 2 hard deps</text>
+
+  <!-- Stat pills -->
+  <rect x="132" y="159" width="90"  height="22" rx="11" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1.5"/>
+  <text x="177" y="174" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="10" fill="#15803d" text-anchor="middle">27 providers</text>
+
+  <rect x="230" y="159" width="68"  height="22" rx="11" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1.5"/>
+  <text x="264" y="174" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="10" fill="#15803d" text-anchor="middle">41 tools</text>
+
+  <rect x="306" y="159" width="76"  height="22" rx="11" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1.5"/>
+  <text x="344" y="174" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="10" fill="#15803d" text-anchor="middle">18 loaders</text>
+
+  <rect x="390" y="159" width="100" height="22" rx="11" fill="#f1f5f9" stroke="#e2e8f0" stroke-width="1.5"/>
+  <text x="440" y="174" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="10" fill="#64748b" text-anchor="middle">9 vector stores</text>
+
+  <rect x="498" y="159" width="88"  height="22" rx="11" fill="#f1f5f9" stroke="#e2e8f0" stroke-width="1.5"/>
+  <text x="542" y="174" font-family="'SF Mono','Fira Code','Consolas',monospace" font-size="10" fill="#64748b" text-anchor="middle">async-native</text>
+
+</svg>

synapsekit-1.4.6/assets/logo.svg

@@ -0,0 +1,13 @@
+<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="g" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#22c55e"/>
+      <stop offset="100%" style="stop-color:#15803d"/>
+    </linearGradient>
+  </defs>
+  <circle cx="8" cy="16" r="4.5" fill="url(#g)"/>
+  <circle cx="25" cy="7"  r="3.5" fill="#16a34a" opacity="0.9"/>
+  <circle cx="25" cy="25" r="3.5" fill="#16a34a" opacity="0.9"/>
+  <line x1="12" y1="13.5" x2="22" y2="9"   stroke="url(#g)" stroke-width="1.8" stroke-linecap="round"/>
+  <line x1="12" y1="18.5" x2="22" y2="23"  stroke="url(#g)" stroke-width="1.8" stroke-linecap="round"/>
+</svg>

{synapsekit-1.4.2 → synapsekit-1.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "synapsekit"
-version = "1.4.2"
+version = "1.4.6"
 description = "Async-native Python framework for building production-grade LLM applications. Streaming-first, 2 dependencies, fully transparent."
 authors = [{ name = "Amit", email = "de.amit.nautiyal@gmail.com" }]
 license = { text = "Apache-2.0" }
@@ -47,6 +47,9 @@ chroma = ["chromadb>=0.5"]
 faiss = ["faiss-cpu>=1.7"]
 qdrant = ["qdrant-client>=1.9"]
 pinecone = ["pinecone>=3.0"]
+weaviate = ["weaviate-client>=4.0"]
+milvus = ["pymilvus>=2.4"]
+lancedb = ["lancedb>=0.5"]
 ollama = ["ollama>=0.2"]
 ai21 = ["ai21>=2.0"]
 cohere = ["cohere>=5.0"]
@@ -79,8 +82,11 @@ ernie = ["erniebot>=0.5"]
 minimax = ["httpx>=0.27"]
 serve = ["fastapi>=0.110", "uvicorn[standard]>=0.29"]
 postgres = ["psycopg[binary]>=3.1"]
+pgvector = ["psycopg[binary]>=3.1", "pgvector>=0.2"]
 wolfram = ["wolframalpha>=5.0"]
 dynamodb = ["boto3>=1.34"]
+discord = ["discord.py>=2.0"]
+gdrive = ["google-api-python-client>=2.0", "google-auth>=2.0"]
 all = [
     "openai>=1.0",
     "anthropic>=0.25",
@@ -93,6 +99,10 @@ all = [
     "faiss-cpu>=1.7",
     "qdrant-client>=1.9",
     "pinecone>=3.0",
+    "weaviate-client>=4.0",
+    "pymilvus>=2.4",
+    "lancedb>=0.5",
+    "pgvector>=0.2",
     "ollama>=0.2",
     "ai21>=2.0",
     "cohere>=5.0",
@@ -116,6 +126,9 @@ all = [
     "llama-cpp-python>=0.2",
     "erniebot>=0.5",
     "wolframalpha>=5.0",
+    "discord.py>=2.0",
+    "google-api-python-client>=2.0",
+    "google-auth>=2.0",
 ]
 
 [dependency-groups]
@@ -182,8 +195,12 @@ module = [
     "synapsekit.embeddings.backend",
     "synapsekit.retrieval.chroma",
     "synapsekit.retrieval.faiss",
+    "synapsekit.retrieval.lancedb",
+    "synapsekit.retrieval.milvus",
+    "synapsekit.retrieval.pgvector",
     "synapsekit.retrieval.qdrant",
     "synapsekit.retrieval.pinecone",
+    "synapsekit.retrieval.weaviate",
     "synapsekit.llm.groq",
     "synapsekit.llm.azure_openai",
     "synapsekit.llm.deepseek",
@@ -215,6 +232,7 @@ pep621_dev_dependency_groups = ["dev"]
 [tool.deptry.package_module_name_map]
 google-generativeai = "google"
 google-api-python-client = "googleapiclient"
+google-auth = "google"
 beautifulsoup4 = "bs4"
 faiss-cpu = "faiss"
 python-pptx = "pptx"
@@ -223,8 +241,10 @@ tavily-python = "tavily"
 youtube-search-python = "youtubesearchpython"
 google-cloud-aiplatform = "vertexai"
 llama-cpp-python = "llama_cpp"
+"discord.py" = "discord"
 
 [tool.deptry.per_rule_ignores]
 DEP001 = ["sqlalchemy", "pydantic", "aiohttp", "opentelemetry", "whisper", "botocore", "aiomcache", "nest_asyncio", "huggingface_hub", "serpapi"]
-DEP002 = ["numpy", "rank-bm25", "beautifulsoup4", "lxml", "faiss-cpu", "google-generativeai", "tavily-python", "youtube-search-python", "psycopg", "google-search-results"]
+DEP002 = ["numpy", "rank-bm25", "beautifulsoup4", "lxml", "faiss-cpu", "google-generativeai", "tavily-python", "youtube-search-python", "psycopg", "google-search-results", "discord.py", "google-auth", "weaviate-client", "pymilvus", "lancedb", "pgvector"]
+DEP003 = ["sqlalchemy", "botocore", "nest_asyncio"]
 DEP004 = ["pydantic"]

{synapsekit-1.4.2 → synapsekit-1.4.6}/src/synapsekit/__init__.py

@@ -251,6 +251,7 @@ __all__ = [
     "MoonshotLLM",
     "OpenRouterLLM",
     "PerplexityLLM",
+    "SambaNovaLLM",
     "TogetherLLM",
     "VertexAILLM",
     "ZhipuLLM",
@@ -261,8 +262,12 @@ __all__ = [
     "InMemoryVectorStore",
     "ChromaVectorStore",
     "FAISSVectorStore",
+    "LanceDBVectorStore",
+    "MilvusVectorStore",
+    "PGVectorStore",
     "QdrantVectorStore",
     "PineconeVectorStore",
+    "WeaviateVectorStore",
     # Retrieval
     "Retriever",
     "AdaptiveRAGRetriever",
@@ -490,6 +495,9 @@ __all__ = [
     "VideoLoader",
     "ImageLoader",
     "YAMLLoader",
+    "DiscordLoader",
+    "XMLLoader",
+    "GoogleDriveLoader",
     # Plugins
     "PluginRegistry",
     # API stability markers
@@ -503,8 +511,12 @@ _LAZY_IMPORTS = {
     # Vector stores
     "ChromaVectorStore": "retrieval.chroma",
     "FAISSVectorStore": "retrieval.faiss",
+    "LanceDBVectorStore": "retrieval.lancedb",
+    "MilvusVectorStore": "retrieval.milvus",
+    "PGVectorStore": "retrieval.pgvector",
     "QdrantVectorStore": "retrieval.qdrant",
     "PineconeVectorStore": "retrieval.pinecone",
+    "WeaviateVectorStore": "retrieval.weaviate",
     # LLM providers
     "AsyncLRUCache": "llm._cache",
     "DynamoDBCacheBackend": "llm._cache_dynamodb",
@@ -518,6 +530,7 @@ _LAZY_IMPORTS = {
     "HuggingFaceLLM": "llm.huggingface",
     "OpenRouterLLM": "llm.openrouter",
     "PerplexityLLM": "llm.perplexity",
+    "SambaNovaLLM": "llm.sambanova",
     "TogetherLLM": "llm.together",
     "MinimaxLLM": "llm.minimax",
     "MoonshotLLM": "llm.moonshot",
@@ -534,6 +547,9 @@ _LAZY_IMPORTS = {
     "ExcelLoader": "loaders.excel",
     "PowerPointLoader": "loaders.pptx",
     "YAMLLoader": "loaders.yaml_loader",
+    "DiscordLoader": "loaders.discord",
+    "XMLLoader": "loaders.xml_loader",
+    "GoogleDriveLoader": "loaders.google_drive",
 }
 
 

synapsekit-1.4.6/src/synapsekit/agents/tools/python_repl.py

@@ -0,0 +1,161 @@
+from __future__ import annotations
+
+import contextlib
+import io
+import logging
+import math
+import multiprocessing
+import platform
+import signal
+import sys
+from typing import Any
+
+from ..base import BaseTool, ToolResult
+
+logger = logging.getLogger(__name__)
+
+
+class _CodeTimeoutError(Exception):
+    """Raised when code execution times out."""
+
+
+def _exec_with_capture(code: str, namespace: dict, output_queue: multiprocessing.Queue) -> None:
+    """Execute code in a subprocess and send results back via queue.
+
+    Used for Windows timeout implementation with multiprocessing.
+    """
+    old_stdout = sys.stdout
+    sys.stdout = buf = io.StringIO()
+
+    try:
+        exec(code, namespace)
+        output = buf.getvalue()
+        # Send back (success, output, error, namespace)
+        output_queue.put((True, output, None, namespace))
+    except Exception as e:
+        error_msg = f"{type(e).__name__}: {e}"
+        output_queue.put((False, "", error_msg, namespace))
+    finally:
+        sys.stdout = old_stdout
+
+
+class PythonREPLTool(BaseTool):
+    """
+    Execute arbitrary Python code and capture stdout.
+
+    Timeout behavior:
+    - Unix/Linux: Uses signal.SIGALRM (fast, full namespace persistence)
+    - Windows: Uses multiprocessing.Process (reliable timeout, namespace limited to picklable objects)
+
+    Warning: This executes real Python code. Only use in trusted environments.
+    """
+
+    name = "python_repl"
+    description = (
+        "Execute Python code and return its output. "
+        "Input: a Python code string. Use print() to produce output. "
+        "WARNING: executes real Python — only use in trusted environments."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "code": {
+                "type": "string",
+                "description": "Python code to execute",
+            }
+        },
+        "required": ["code"],
+    }
+
+    def __init__(self, timeout: float = 5.0) -> None:
+        logger.warning(
+            "PythonREPLTool executes arbitrary Python code. "
+            "Only use in trusted environments with controlled input. "
+            "Malicious code can access files, network, and system resources."
+        )
+        self._namespace: dict = {}
+        self.timeout = timeout
+
+    async def run(self, code: str = "", **kwargs: Any) -> ToolResult:
+        src = code or kwargs.get("input", "")
+        if not src:
+            return ToolResult(output="", error="No code provided.")
+
+        is_windows = platform.system() == "Windows"
+
+        if is_windows:
+            return await self._run_windows(src)
+        else:
+            return await self._run_unix(src)
+
+    async def _run_unix(self, code: str) -> ToolResult:
+        """Execute code with signal.SIGALRM timeout (Unix/Linux)."""
+        old_stdout = sys.stdout
+        sys.stdout = buf = io.StringIO()
+
+        def timeout_handler(signum, frame):
+            raise _CodeTimeoutError(f"Code execution timed out after {self.timeout} seconds")
+
+        try:
+            signal.signal(signal.SIGALRM, timeout_handler)
+            signal.alarm(max(1, math.ceil(self.timeout)))
+            try:
+                exec(code, self._namespace)
+            finally:
+                signal.alarm(0)  # Cancel alarm
+
+            output = buf.getvalue()
+            return ToolResult(output=output or "(no output)")
+        except _CodeTimeoutError as e:
+            return ToolResult(output="", error=str(e))
+        except Exception as e:
+            return ToolResult(output="", error=f"{type(e).__name__}: {e}")
+        finally:
+            sys.stdout = old_stdout
+            signal.alarm(0)  # Ensure alarm is cancelled
+
+    async def _run_windows(self, code: str) -> ToolResult:
+        """Execute code with multiprocessing timeout (Windows).
+
+        Note: Namespace persistence limited to picklable objects.
+        """
+        output_queue: multiprocessing.Queue = multiprocessing.Queue()
+
+        # Create process to execute code
+        process = multiprocessing.Process(
+            target=_exec_with_capture, args=(code, self._namespace.copy(), output_queue)
+        )
+
+        process.start()
+        process.join(timeout=self.timeout)
+
+        if process.is_alive():
+            # Timeout occurred
+            process.terminate()
+            process.join(timeout=1.0)  # Wait for graceful termination
+            if process.is_alive():
+                process.kill()  # Force kill if still running
+            return ToolResult(
+                output="", error=f"Code execution timed out after {self.timeout} seconds"
+            )
+
+        # Process completed, get results
+        if not output_queue.empty():
+            success, output, error, updated_namespace = output_queue.get()
+
+            # Update namespace with picklable objects from subprocess
+            # This allows persistence of basic types but not complex objects
+            with contextlib.suppress(Exception):
+                self._namespace.update(updated_namespace)
+
+            if success:
+                return ToolResult(output=output or "(no output)")
+            else:
+                return ToolResult(output="", error=error)
+        else:
+            # Process died without sending results
+            return ToolResult(output="", error="Code execution failed unexpectedly")
+
+    def reset(self) -> None:
+        """Clear the persistent namespace between runs."""
+        self._namespace.clear()