synapsekit 0.6.3__tar.gz → 0.6.4__tar.gz

{synapsekit-0.6.3 → synapsekit-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapsekit
-Version: 0.6.3
+Version: 0.6.4
 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
@@ -43,6 +43,8 @@ Provides-Extra: chroma
 Requires-Dist: chromadb>=0.5; extra == 'chroma'
 Provides-Extra: cohere
 Requires-Dist: cohere>=5.0; extra == 'cohere'
+Provides-Extra: docx
+Requires-Dist: python-docx>=1.0; extra == 'docx'
 Provides-Extra: excel
 Requires-Dist: openpyxl>=3.1; extra == 'excel'
 Provides-Extra: faiss
@@ -88,7 +90,8 @@ Description-Content-Type: text/markdown
 [![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.14%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-22c55e)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-332%20passing-22c55e?logo=pytest&logoColor=white)]()
+[![Tests](https://img.shields.io/badge/tests-540%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/)
 
 **[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)**
@@ -121,7 +124,7 @@ Token-level streaming is the default,<br/>not an afterthought.<br/>Works across
 <tr>
 <td align="center" width="33%">
 <h3>🔌 One interface</h3>
-9 LLM providers and 4 vector stores<br/>behind the same API.<br/>Swap without rewriting.
+13 LLM providers and 5 vector stores<br/>behind the same API.<br/>Swap without rewriting.
 </td>
 <td align="center" width="33%">
 <h3>🧩 Composable</h3>
@@ -164,7 +167,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). Built-in tools for calculator, Python REPL, file read, web search, and SQL. Fully extensible.
+ReAct loop (any LLM) and native function calling (OpenAI / Anthropic / Gemini / Mistral). 16 built-in tools including calculator, Python REPL, web search, SQL, HTTP, summarization, sentiment analysis, and translation. Fully extensible.
 
 </td>
 </tr>
@@ -172,13 +175,13 @@ ReAct loop (any LLM) and native function calling (OpenAI / Anthropic). Built-in
 <td width="50%">
 
 **🔀 Graph Workflows**<br/>
-DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurrently. Conditional routing, compile-time validation, cycle detection, and Mermaid export.
+DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurrently. Conditional routing, typed state with reducers, fan-out/fan-in, SSE streaming, event callbacks, human-in-the-loop, checkpointing, and Mermaid export.
 
 </td>
 <td width="50%">
 
 **🧠 LLM Providers**<br/>
-OpenAI, Anthropic, Ollama, Gemini, Cohere, Mistral, Bedrock — 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 — all behind one interface. Auto-detected from the model name. Swap without rewriting.
 
 </td>
 </tr>
@@ -238,7 +241,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 9 providers with examples |
+| 🧠 [LLM Providers](https://synapsekit.github.io/synapsekit-docs/docs/llms/overview) | All 13 providers with examples |
 | 📖 [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) | Full class and method reference |
 
 ---

{synapsekit-0.6.3 → synapsekit-0.6.4}/README.md

@@ -7,7 +7,8 @@
 [![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.14%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-22c55e)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-332%20passing-22c55e?logo=pytest&logoColor=white)]()
+[![Tests](https://img.shields.io/badge/tests-540%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/)
 
 **[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)**
@@ -40,7 +41,7 @@ Token-level streaming is the default,<br/>not an afterthought.<br/>Works across
 <tr>
 <td align="center" width="33%">
 <h3>🔌 One interface</h3>
-9 LLM providers and 4 vector stores<br/>behind the same API.<br/>Swap without rewriting.
+13 LLM providers and 5 vector stores<br/>behind the same API.<br/>Swap without rewriting.
 </td>
 <td align="center" width="33%">
 <h3>🧩 Composable</h3>
@@ -83,7 +84,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). Built-in tools for calculator, Python REPL, file read, web search, and SQL. Fully extensible.
+ReAct loop (any LLM) and native function calling (OpenAI / Anthropic / Gemini / Mistral). 16 built-in tools including calculator, Python REPL, web search, SQL, HTTP, summarization, sentiment analysis, and translation. Fully extensible.
 
 </td>
 </tr>
@@ -91,13 +92,13 @@ ReAct loop (any LLM) and native function calling (OpenAI / Anthropic). Built-in
 <td width="50%">
 
 **🔀 Graph Workflows**<br/>
-DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurrently. Conditional routing, compile-time validation, cycle detection, and Mermaid export.
+DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurrently. Conditional routing, typed state with reducers, fan-out/fan-in, SSE streaming, event callbacks, human-in-the-loop, checkpointing, and Mermaid export.
 
 </td>
 <td width="50%">
 
 **🧠 LLM Providers**<br/>
-OpenAI, Anthropic, Ollama, Gemini, Cohere, Mistral, Bedrock — 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 — all behind one interface. Auto-detected from the model name. Swap without rewriting.
 
 </td>
 </tr>
@@ -157,7 +158,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 9 providers with examples |
+| 🧠 [LLM Providers](https://synapsekit.github.io/synapsekit-docs/docs/llms/overview) | All 13 providers with examples |
 | 📖 [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) | Full class and method reference |
 
 ---

{synapsekit-0.6.3 → synapsekit-0.6.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "synapsekit"
-version = "0.6.3"
+version = "0.6.4"
 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 = "MIT" }
@@ -48,6 +48,7 @@ bedrock = ["boto3>=1.34"]
 groq = ["groq>=0.9"]
 excel = ["openpyxl>=3.1"]
 pptx = ["python-pptx>=0.6"]
+docx = ["python-docx>=1.0"]
 http = ["aiohttp>=3.9"]
 search = ["duckduckgo-search>=6.0"]
 all = [
@@ -157,6 +158,7 @@ google-generativeai = "google"
 beautifulsoup4 = "bs4"
 faiss-cpu = "faiss"
 python-pptx = "pptx"
+python-docx = "docx"
 
 [tool.deptry.per_rule_ignores]
 DEP001 = ["sqlalchemy", "pydantic", "aiohttp"]

{synapsekit-0.6.3 → synapsekit-0.6.4}/src/synapsekit/__init__.py

@@ -33,11 +33,14 @@ from .agents import (
     ReActAgent,
     RegexTool,
     SentimentAnalysisTool,
+    ShellTool,
     SQLQueryTool,
+    SQLSchemaInspectionTool,
     SummarizationTool,
     ToolRegistry,
     ToolResult,
     TranslationTool,
+    WebScraperTool,
     WebSearchTool,
     WikipediaTool,
     tool,
@@ -58,6 +61,7 @@ from .graph import (
     GraphState,
     InMemoryCheckpointer,
     InterruptState,
+    JSONFileCheckpointer,
     Node,
     NodeFn,
     SQLiteCheckpointer,
@@ -78,6 +82,7 @@ from .loaders.csv import CSVLoader
 from .loaders.directory import DirectoryLoader
 from .loaders.html import HTMLLoader
 from .loaders.json_loader import JSONLoader
+from .loaders.markdown import MarkdownLoader
 from .loaders.pdf import PDFLoader
 from .loaders.text import StringLoader, TextLoader
 from .loaders.web import WebLoader
@@ -98,6 +103,7 @@ from .retrieval.contextual_compression import ContextualCompressionRetriever
 from .retrieval.crag import CRAGRetriever
 from .retrieval.cross_encoder import CrossEncoderReranker
 from .retrieval.ensemble import EnsembleRetriever
+from .retrieval.hyde import HyDERetriever
 from .retrieval.parent_document import ParentDocumentRetriever
 from .retrieval.query_decomposition import QueryDecompositionRetriever
 from .retrieval.rag_fusion import RAGFusionRetriever
@@ -113,7 +119,7 @@ from .text_splitters import (
     TokenAwareSplitter,
 )
 
-__version__ = "0.6.3"
+__version__ = "0.6.4"
 __all__ = [
     # Facade
     "RAG",
@@ -146,6 +152,7 @@ __all__ = [
     "CRAGRetriever",
     "CrossEncoderReranker",
     "EnsembleRetriever",
+    "HyDERetriever",
     "ParentDocumentRetriever",
     "QueryDecompositionRetriever",
     "SelfQueryRetriever",
@@ -165,6 +172,8 @@ __all__ = [
     "CSVLoader",
     "JSONLoader",
     "DirectoryLoader",
+    "DocxLoader",
+    "MarkdownLoader",
     "WebLoader",
     "ExcelLoader",
     "PowerPointLoader",
@@ -200,9 +209,12 @@ __all__ = [
     "PythonREPLTool",
     "RegexTool",
     "SentimentAnalysisTool",
+    "ShellTool",
     "SQLQueryTool",
+    "SQLSchemaInspectionTool",
     "SummarizationTool",
     "TranslationTool",
+    "WebScraperTool",
     "WebSearchTool",
     "WikipediaTool",
     # Text splitters
@@ -238,6 +250,7 @@ __all__ = [
     # Checkpointers
     "BaseCheckpointer",
     "InMemoryCheckpointer",
+    "JSONFileCheckpointer",
     "SQLiteCheckpointer",
     # Structured output
     "generate_structured",
@@ -258,6 +271,7 @@ _LAZY_IMPORTS = {
     "OpenRouterLLM": "llm.openrouter",
     "TogetherLLM": "llm.together",
     # Loaders
+    "DocxLoader": "loaders.docx",
     "ExcelLoader": "loaders.excel",
     "PowerPointLoader": "loaders.pptx",
 }

{synapsekit-0.6.3 → synapsekit-0.6.4}/src/synapsekit/agents/__init__.py

@@ -17,9 +17,12 @@ from .tools import (
     PythonREPLTool,
     RegexTool,
     SentimentAnalysisTool,
+    ShellTool,
     SQLQueryTool,
+    SQLSchemaInspectionTool,
     SummarizationTool,
     TranslationTool,
+    WebScraperTool,
     WebSearchTool,
     WikipediaTool,
 )
@@ -50,9 +53,12 @@ __all__ = [
     "PythonREPLTool",
     "RegexTool",
     "SentimentAnalysisTool",
+    "ShellTool",
     "SQLQueryTool",
+    "SQLSchemaInspectionTool",
     "SummarizationTool",
     "TranslationTool",
+    "WebScraperTool",
     "WebSearchTool",
     "WikipediaTool",
 ]

{synapsekit-0.6.3 → synapsekit-0.6.4}/src/synapsekit/agents/tools/__init__.py

@@ -9,9 +9,12 @@ from .json_query import JSONQueryTool
 from .python_repl import PythonREPLTool
 from .regex_tool import RegexTool
 from .sentiment import SentimentAnalysisTool
+from .shell import ShellTool
 from .sql_query import SQLQueryTool
+from .sql_schema import SQLSchemaInspectionTool
 from .summarization import SummarizationTool
 from .translation import TranslationTool
+from .web_scraper import WebScraperTool
 from .web_search import WebSearchTool
 from .wikipedia import WikipediaTool
 
@@ -27,9 +30,12 @@ __all__ = [
     "PythonREPLTool",
     "RegexTool",
     "SentimentAnalysisTool",
+    "ShellTool",
     "SQLQueryTool",
+    "SQLSchemaInspectionTool",
     "SummarizationTool",
     "TranslationTool",
+    "WebScraperTool",
     "WebSearchTool",
     "WikipediaTool",
 ]

synapsekit-0.6.4/src/synapsekit/agents/tools/shell.py

@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+from ..base import BaseTool, ToolResult
+
+
+class ShellTool(BaseTool):
+    """Execute shell commands and return their output."""
+
+    name = "shell"
+    description = (
+        "Execute a shell command and return stdout/stderr. "
+        "Input: a command string. "
+        "Optional: allowed_commands to restrict which commands can be run."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "command": {
+                "type": "string",
+                "description": "The shell command to execute",
+            },
+        },
+        "required": ["command"],
+    }
+
+    def __init__(
+        self,
+        timeout: int = 30,
+        allowed_commands: list[str] | None = None,
+    ) -> None:
+        self.timeout = timeout
+        self.allowed_commands = allowed_commands
+
+    async def run(self, command: str = "", **kwargs: Any) -> ToolResult:
+        """Execute the shell command."""
+        target = command or kwargs.get("input", "")
+        if not target:
+            return ToolResult(output="", error="No command provided.")
+
+        if self.allowed_commands is not None:
+            base_cmd = target.split()[0]
+            if base_cmd not in self.allowed_commands:
+                return ToolResult(
+                    output="",
+                    error=f"Command {base_cmd!r} is not in the allowed list.",
+                )
+
+        try:
+            proc = await asyncio.create_subprocess_shell(
+                target,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE,
+            )
+            stdout, stderr = await asyncio.wait_for(proc.communicate(), timeout=self.timeout)
+            output = stdout.decode() if stdout else ""
+            err = stderr.decode() if stderr else ""
+
+            if proc.returncode != 0:
+                return ToolResult(
+                    output=output,
+                    error=f"Exit code {proc.returncode}: {err}".strip(),
+                )
+            return ToolResult(output=output + err)
+        except TimeoutError:
+            return ToolResult(output="", error=f"Command timed out after {self.timeout}s.")
+        except Exception as e:
+            return ToolResult(output="", error=f"Shell error: {e}")

synapsekit-0.6.4/src/synapsekit/agents/tools/sql_schema.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+import sqlite3
+from typing import Any
+
+from ..base import BaseTool, ToolResult
+
+
+class SQLSchemaInspectionTool(BaseTool):
+    """Inspect database schema: list tables and describe columns."""
+
+    name = "sql_schema"
+    description = (
+        "Inspect the schema of a SQL database. "
+        "Actions: 'list_tables' returns all table names, "
+        "'describe_table' returns column details for a given table. "
+        "Input: action (required), table_name (optional, for describe_table)."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "action": {
+                "type": "string",
+                "description": "The action to perform: 'list_tables' or 'describe_table'",
+                "enum": ["list_tables", "describe_table"],
+            },
+            "table_name": {
+                "type": "string",
+                "description": "Table name (required for describe_table)",
+            },
+        },
+        "required": ["action"],
+    }
+
+    def __init__(self, connection_string: str) -> None:
+        self._connection_string = connection_string
+
+    def _is_sqlite(self) -> bool:
+        return self._connection_string.endswith(".db") or self._connection_string == ":memory:"
+
+    def _list_tables_sqlite(self) -> list[str]:
+        conn = sqlite3.connect(self._connection_string)
+        try:
+            rows = conn.execute(
+                "SELECT name FROM sqlite_master WHERE type='table' ORDER BY name"
+            ).fetchall()
+            return [r[0] for r in rows]
+        finally:
+            conn.close()
+
+    def _describe_table_sqlite(self, table_name: str) -> list[dict[str, Any]]:
+        conn = sqlite3.connect(self._connection_string)
+        try:
+            rows = conn.execute(f"PRAGMA table_info({table_name})").fetchall()
+            return [
+                {
+                    "name": r[1],
+                    "type": r[2],
+                    "nullable": not r[3],
+                    "pk": bool(r[5]),
+                }
+                for r in rows
+            ]
+        finally:
+            conn.close()
+
+    def _list_tables_sqlalchemy(self) -> list[str]:
+        try:
+            from sqlalchemy import create_engine, inspect
+        except ImportError:
+            raise ImportError(
+                "sqlalchemy required for non-SQLite databases: pip install sqlalchemy"
+            ) from None
+        engine = create_engine(self._connection_string)
+        inspector = inspect(engine)
+        return sorted(inspector.get_table_names())
+
+    def _describe_table_sqlalchemy(self, table_name: str) -> list[dict[str, Any]]:
+        try:
+            from sqlalchemy import create_engine, inspect
+        except ImportError:
+            raise ImportError(
+                "sqlalchemy required for non-SQLite databases: pip install sqlalchemy"
+            ) from None
+        engine = create_engine(self._connection_string)
+        inspector = inspect(engine)
+        columns = inspector.get_columns(table_name)
+        pk_cols = {
+            c for c in (inspector.get_pk_constraint(table_name).get("constrained_columns") or [])
+        }
+        return [
+            {
+                "name": col["name"],
+                "type": str(col["type"]),
+                "nullable": col.get("nullable", True),
+                "pk": col["name"] in pk_cols,
+            }
+            for col in columns
+        ]
+
+    async def run(self, action: str = "", table_name: str = "", **kwargs: Any) -> ToolResult:
+        if not action:
+            return ToolResult(output="", error="action is required.")
+
+        try:
+            if action == "list_tables":
+                if self._is_sqlite():
+                    tables = self._list_tables_sqlite()
+                else:
+                    tables = self._list_tables_sqlalchemy()
+                return ToolResult(output=", ".join(tables) if tables else "(no tables)")
+
+            if action == "describe_table":
+                if not table_name:
+                    return ToolResult(output="", error="table_name is required for describe_table.")
+                if self._is_sqlite():
+                    cols = self._describe_table_sqlite(table_name)
+                else:
+                    cols = self._describe_table_sqlalchemy(table_name)
+                if not cols:
+                    return ToolResult(
+                        output="", error=f"Table {table_name!r} not found or has no columns."
+                    )
+                lines = [
+                    f"{c['name']} ({c['type']}, nullable={c['nullable']}, pk={c['pk']})"
+                    for c in cols
+                ]
+                return ToolResult(output="\n".join(lines))
+
+            return ToolResult(output="", error=f"Unknown action: {action!r}")
+        except Exception as e:
+            return ToolResult(output="", error=f"SQL schema error: {e}")

synapsekit-0.6.4/src/synapsekit/agents/tools/web_scraper.py

@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ..base import BaseTool, ToolResult
+
+
+class WebScraperTool(BaseTool):
+    """Fetch a URL and extract clean text content from the webpage."""
+
+    name = "web_scraper"
+    description = (
+        "Fetch a webpage URL and return clean text content. "
+        "Input: a URL string, e.g. 'https://example.com/article'. "
+        "Optional: css_selector to extract specific content. "
+        "Removes scripts, styles, nav, header, footer elements."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "url": {
+                "type": "string",
+                "description": "The URL of the webpage to scrape",
+            },
+            "css_selector": {
+                "type": "string",
+                "description": "Optional CSS selector to extract specific content (e.g. 'article', '.content')",
+            },
+        },
+        "required": ["url"],
+    }
+
+    def __init__(self, timeout: int = 30):
+        self.timeout = timeout
+
+    def _clean_html(self, html: str, css_selector: str | None = None) -> str:
+        """Parse HTML and extract clean text."""
+        try:
+            from bs4 import BeautifulSoup
+        except ImportError:
+            raise ImportError("beautifulsoup4 required: pip install synapsekit[web]") from None
+
+        soup = BeautifulSoup(html, "html.parser")
+
+        for element in soup(["script", "style", "nav", "header", "footer", "aside"]):
+            element.decompose()
+
+        if css_selector:
+            elements = soup.select(css_selector)
+            if not elements:
+                return ""
+            content = "\n\n".join(elem.get_text(separator="\n", strip=True) for elem in elements)
+        else:
+            content = soup.get_text(separator="\n", strip=True)
+
+        return content
+
+    async def run(
+        self, url: str = "", css_selector: str | None = None, **kwargs: Any
+    ) -> ToolResult:
+        """Fetch URL and return clean text."""
+        try:
+            import httpx
+        except ImportError:
+            raise ImportError("httpx required: pip install synapsekit[web]") from None
+
+        target_url = url or kwargs.get("input", "")
+        if not target_url:
+            return ToolResult(output="", error="No URL provided.")
+
+        try:
+            async with httpx.AsyncClient() as client:
+                response = await client.get(target_url, timeout=self.timeout)
+                response.raise_for_status()
+                text = self._clean_html(response.text, css_selector)
+                return ToolResult(output=text)
+        except httpx.HTTPError as e:
+            return ToolResult(output="", error=f"HTTP error: {e}")
+        except Exception as e:
+            return ToolResult(output="", error=f"Scraping failed: {e}")

{synapsekit-0.6.3 → synapsekit-0.6.4}/src/synapsekit/graph/__init__.py

@@ -1,4 +1,9 @@
-from .checkpointers import BaseCheckpointer, InMemoryCheckpointer, SQLiteCheckpointer
+from .checkpointers import (
+    BaseCheckpointer,
+    InMemoryCheckpointer,
+    JSONFileCheckpointer,
+    SQLiteCheckpointer,
+)
 from .compiled import CompiledGraph
 from .edge import ConditionalEdge, ConditionFn, Edge
 from .errors import GraphConfigError, GraphRuntimeError
@@ -25,6 +30,7 @@ __all__ = [
     "GraphState",
     "InMemoryCheckpointer",
     "InterruptState",
+    "JSONFileCheckpointer",
     "Node",
     "NodeFn",
     "SQLiteCheckpointer",

{synapsekit-0.6.3 → synapsekit-0.6.4}/src/synapsekit/graph/checkpointers/__init__.py

@@ -1,9 +1,11 @@
 from .base import BaseCheckpointer
+from .json_file import JSONFileCheckpointer
 from .memory import InMemoryCheckpointer
 from .sqlite import SQLiteCheckpointer
 
 __all__ = [
     "BaseCheckpointer",
     "InMemoryCheckpointer",
+    "JSONFileCheckpointer",
     "SQLiteCheckpointer",
 ]

synapsekit-0.6.4/src/synapsekit/graph/checkpointers/json_file.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import json
+import os
+from typing import Any
+
+from .base import BaseCheckpointer
+
+
+class JSONFileCheckpointer(BaseCheckpointer):
+    """File-based checkpointer using JSON files.
+
+    Each graph checkpoint is stored as a separate JSON file named
+    ``{graph_id}.json`` in the given directory.
+    """
+
+    def __init__(self, directory: str = ".") -> None:
+        self._directory = directory
+        os.makedirs(directory, exist_ok=True)
+
+    def _path_for(self, graph_id: str) -> str:
+        return os.path.join(self._directory, f"{graph_id}.json")
+
+    def save(self, graph_id: str, step: int, state: dict[str, Any]) -> None:
+        path = self._path_for(graph_id)
+        with open(path, "w", encoding="utf-8") as f:
+            json.dump({"step": step, "state": state}, f)
+
+    def load(self, graph_id: str) -> tuple[int, dict[str, Any]] | None:
+        path = self._path_for(graph_id)
+        if not os.path.exists(path):
+            return None
+        with open(path, encoding="utf-8") as f:
+            data = json.load(f)
+        return data["step"], data["state"]
+
+    def delete(self, graph_id: str) -> None:
+        path = self._path_for(graph_id)
+        if os.path.exists(path):
+            os.remove(path)