web-algebra 2.0.0__tar.gz → 2.0.2__tar.gz

{web_algebra-2.0.0 → web_algebra-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: web-algebra
-Version: 2.0.0
+Version: 2.0.2
 Summary: Composable RDF operations in JSON
 Author-email: Martynas Jusevicius <martynas@atomgraph.com>
 License-Expression: Apache-2.0
@@ -33,6 +33,8 @@ Dynamic: license-file
 
 # Web-Algebra
 
+[![Web-Algebra - Listed on Claude AI Directory](https://www.claudeai.directory/badge/web-algebra?theme=dark)](https://www.claudeai.directory/launches/web-algebra)
+
 <!-- mcp-name: io.github.AtomGraph/web-algebra -->
 
 A composable RDF operations system that translates natural language instructions into JSON-formatted domain-specific language operations for loading, querying, and writing RDF Linked Data.
@@ -48,7 +50,7 @@ Instead of agents executing semantic workflows step-by-step through individual M
 
 ## Demo
 
-[![ Agentic Content Management with Web-Algebra MCP](https://img.youtube.com/vi/eRMrSqKc9_E/0.jpg)](https://www.youtube.com/watch?v=eRMrSqKc9_E)
+[![Web-Algebra in action: an AI agent builds Linked Data pages over MCP](https://img.youtube.com/vi/zSbvl5kmKic/maxresdefault.jpg)](https://www.youtube.com/watch?v=zSbvl5kmKic)
 
 *See WebAlgebra in action - translating natural language into RDF operations.*
 
@@ -202,6 +204,8 @@ or with Claude Code:
 claude mcp add web-algebra -e CERT_PEM_PATH=/path/to/LinkedDataHub/ssl/owner/cert.pem -e CERT_PASSWORD=******** -- uvx --from web-algebra web-algebra-mcp
 ```
 
+`uvx web-algebra mcp` runs the same server.
+
 Environment variables:
 
 | Name | Required | Description |

{web_algebra-2.0.0 → web_algebra-2.0.2}/README.md

@@ -1,5 +1,7 @@
 # Web-Algebra
 
+[![Web-Algebra - Listed on Claude AI Directory](https://www.claudeai.directory/badge/web-algebra?theme=dark)](https://www.claudeai.directory/launches/web-algebra)
+
 <!-- mcp-name: io.github.AtomGraph/web-algebra -->
 
 A composable RDF operations system that translates natural language instructions into JSON-formatted domain-specific language operations for loading, querying, and writing RDF Linked Data.
@@ -15,7 +17,7 @@ Instead of agents executing semantic workflows step-by-step through individual M
 
 ## Demo
 
-[![ Agentic Content Management with Web-Algebra MCP](https://img.youtube.com/vi/eRMrSqKc9_E/0.jpg)](https://www.youtube.com/watch?v=eRMrSqKc9_E)
+[![Web-Algebra in action: an AI agent builds Linked Data pages over MCP](https://img.youtube.com/vi/zSbvl5kmKic/maxresdefault.jpg)](https://www.youtube.com/watch?v=zSbvl5kmKic)
 
 *See WebAlgebra in action - translating natural language into RDF operations.*
 
@@ -169,6 +171,8 @@ or with Claude Code:
 claude mcp add web-algebra -e CERT_PEM_PATH=/path/to/LinkedDataHub/ssl/owner/cert.pem -e CERT_PASSWORD=******** -- uvx --from web-algebra web-algebra-mcp
 ```
 
+`uvx web-algebra mcp` runs the same server.
+
 Environment variables:
 
 | Name | Required | Description |

{web_algebra-2.0.0 → web_algebra-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "web-algebra"
-version = "2.0.0"
+version = "2.0.2"
 description = "Composable RDF operations in JSON"
 readme = "README.md"
 license = "Apache-2.0"

{web_algebra-2.0.0 → web_algebra-2.0.2}/src/web_algebra/main.py

@@ -135,6 +135,12 @@ def main(settings: BaseSettings, json_data: Optional[str]):
 
 def cli() -> None:
     parser = argparse.ArgumentParser(description="Run the AI-powered DSL interpreter.")
+    parser.add_argument(
+        "command",
+        nargs="?",
+        choices=["mcp"],
+        help="mcp: run the MCP server on stdio, as web-algebra-mcp does",
+    )
     parser.add_argument(
         "--from-json",
         type=str,
@@ -152,6 +158,12 @@ def cli() -> None:
     )
     args = parser.parse_args()
 
+    if args.command == "mcp":
+        from web_algebra.__main__ import main as serve
+
+        serve()
+        return
+
     # the flags override CERT_PEM_PATH / CERT_PASSWORD, which the settings
     # read from the environment, as the MCP server and the tests do
     overrides = {

{web_algebra-2.0.0 → web_algebra-2.0.2}/src/web_algebra/operations/linkeddatahub/add_result_set_chart.py

@@ -18,9 +18,10 @@ class AddResultSetChart(POST):
         The chart is a resource the document holds, not one of its content blocks: to show it in the content mode,
         place it with ldh-AddObjectBlock, the chart's URI as its value - so give the chart a fragment identifier.
         
-        This tool creates a ResultSetChart that visualizes data from SPARQL SELECT query resources.
-        The chart references an existing sp:Select resource (not a query string) and can display 
-        results using different chart types (bar, line, pie, etc.) with variable mappings.
+        A chart shows values: the query's bindings themselves, as a table or a plot, the way a spreadsheet would.
+        It is the fit for aggregates and measurements - totals, counts, sums per shop or per month. A resource in
+        a chart is a bare cell, with no image, label or links of its own: to show resources themselves (things,
+        people, places), use ldh-AddView, whose modes render each one as itself.
         
         This tool:
         - Creates an ldh:ResultSetChart resource linked to an existing sp:Select query resource

{web_algebra-2.0.0 → web_algebra-2.0.2}/src/web_algebra/operations/linkeddatahub/add_view.py

@@ -18,27 +18,32 @@ class AddView(POST):
         The view is a resource the document holds, not one of its content blocks: to show it in the content mode,
         place it with ldh-AddObjectBlock, the view's URI as its value - so give the view a fragment identifier.
         
-        This tool creates a View that displays data from SPARQL SELECT query resources.
-        The view references an existing sp:Select resource (not a query string) and can display 
-        results using different display modes (list, grid, etc.).
-        
+        A view shows resources - things, people, places, documents - each as itself: its label, its image,
+        its links. LinkedDataHub DESCRIBEs the resources the query's first projected variable binds and renders
+        those descriptions in the view's mode, so that variable must bind resources (SELECT ?thing WHERE { ... }).
+        One that binds values - a name, a price, a computed total - describes nothing. To show values or
+        aggregates (totals, counts, sums by month), use ldh-AddResultSetChart instead.
+
         This tool:
         - Creates an ldh:View resource linked to an existing sp:Select query resource
         - Configures optional display mode for the view
         - Posts the new view resource to the target document
         - Supports optional title, description, fragment identifier, and display mode
-        
-        Possible display modes include:
-        - https://w3id.org/atomgraph/client#ReadMode: Default read mode for displaying resources
-        - https://w3id.org/atomgraph/client#ListMode: List display of results
-        - https://w3id.org/atomgraph/client#GridMode: Grid display of results
-        - https://w3id.org/atomgraph/client#GraphMode: Graph visualization of resources
-        - https://w3id.org/atomgraph/client#MapMode: Map display for geographic data
-
-        IMPORTANT: All variables projected by the SELECT query will be DESCRIBE'd by LinkedDataHub,
-        meaning that the view will fetch complete RDF descriptions for each result resource. This can
-        result in very large graph results and may not be suitable for all SELECT queries, especially
-        those returning many resources or aggregate/computed values.
+
+        Pick the mode by what the resources carry:
+        - https://w3id.org/atomgraph/client#GridMode: a card per resource, led by its image. The fit for resources
+          that have one (foaf:img, foaf:depiction, foaf:logo, schema:image, schema:logo, schema:thumbnailUrl):
+          products, possessions, people, organizations
+        - https://w3id.org/atomgraph/client#MapMode: a pin per resource that has geo:lat and geo:long. The fit for
+          places, addresses, venues, shops
+        - https://w3id.org/atomgraph/client#GraphMode: the resources and the links between them, as a network. The
+          fit for showing how things connect (who owns what, what came from where)
+        - https://w3id.org/atomgraph/client#ListMode: a labelled list; the default, for resources with no image or
+          coordinates
+        - https://w3id.org/atomgraph/client#TableMode: a row per resource, a column per property, for comparing
+          many resources property by property
+        - https://w3id.org/atomgraph/client#ReadMode: each resource's full description, for a few resources
+        - https://w3id.org/atomgraph/client#ChartMode: the resources' properties charted
 
         Note: The query parameter must be a URI of an existing sp:Select resource, not a SPARQL query string."""
 
@@ -66,7 +71,7 @@ class AddView(POST):
                 },
                 "mode": {
                     "type": "string",
-                    "description": "Optional URI of the layout the view shows its results in (a view mode, not an object block's mode). Defaults to ListMode.",
+                    "description": "Optional URI of the layout the view shows its results in (a view mode, not an object block's mode). Defaults to ListMode. Pick it by what the resources carry: GridMode for resources with an image, MapMode for ones with coordinates, GraphMode for how they link (see the tool description).",
                     "enum": [
                         "https://w3id.org/atomgraph/client#ListMode",
                         "https://w3id.org/atomgraph/client#TableMode",

{web_algebra-2.0.0 → web_algebra-2.0.2}/src/web_algebra.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: web-algebra
-Version: 2.0.0
+Version: 2.0.2
 Summary: Composable RDF operations in JSON
 Author-email: Martynas Jusevicius <martynas@atomgraph.com>
 License-Expression: Apache-2.0
@@ -33,6 +33,8 @@ Dynamic: license-file
 
 # Web-Algebra
 
+[![Web-Algebra - Listed on Claude AI Directory](https://www.claudeai.directory/badge/web-algebra?theme=dark)](https://www.claudeai.directory/launches/web-algebra)
+
 <!-- mcp-name: io.github.AtomGraph/web-algebra -->
 
 A composable RDF operations system that translates natural language instructions into JSON-formatted domain-specific language operations for loading, querying, and writing RDF Linked Data.
@@ -48,7 +50,7 @@ Instead of agents executing semantic workflows step-by-step through individual M
 
 ## Demo
 
-[![ Agentic Content Management with Web-Algebra MCP](https://img.youtube.com/vi/eRMrSqKc9_E/0.jpg)](https://www.youtube.com/watch?v=eRMrSqKc9_E)
+[![Web-Algebra in action: an AI agent builds Linked Data pages over MCP](https://img.youtube.com/vi/zSbvl5kmKic/maxresdefault.jpg)](https://www.youtube.com/watch?v=zSbvl5kmKic)
 
 *See WebAlgebra in action - translating natural language into RDF operations.*
 
@@ -202,6 +204,8 @@ or with Claude Code:
 claude mcp add web-algebra -e CERT_PEM_PATH=/path/to/LinkedDataHub/ssl/owner/cert.pem -e CERT_PASSWORD=******** -- uvx --from web-algebra web-algebra-mcp
 ```
 
+`uvx web-algebra mcp` runs the same server.
+
 Environment variables:
 
 | Name | Required | Description |

{web_algebra-2.0.0 → web_algebra-2.0.2}/tests/test_mcp_server.py

@@ -48,9 +48,9 @@ def mcp_tools():
 
 
 class Stdio:
-    def __init__(self):
+    def __init__(self, command=("-m", "web_algebra")):
         self.proc = subprocess.Popen(
-            [sys.executable, "-m", "web_algebra"],
+            [sys.executable, *command],
             stdin=subprocess.PIPE,
             stdout=subprocess.PIPE,
             stderr=subprocess.DEVNULL,
@@ -106,6 +106,16 @@ def test_initialize_names_the_server_and_its_version(stdio):
     assert info["version"] == version("web-algebra")
 
 
+def test_the_cli_mcp_command_is_the_stdio_server():
+    # `web-algebra mcp` is what an MCP Registry client runs (server.json)
+    server = Stdio(("-m", "web_algebra.main", "mcp"))
+    try:
+        answer = server.request("initialize", INITIALIZE, timeout=60)
+    finally:
+        server.close()
+    assert answer["result"]["serverInfo"]["name"] == "web-algebra"
+
+
 def test_initialize_offers_tools(stdio):
     assert "tools" in stdio.initialized["result"]["capabilities"]
 

{web_algebra-2.0.0 → web_algebra-2.0.2}/tests/test_packaging.py

@@ -39,6 +39,11 @@ def test_server_json_names_the_pypi_package():
     assert [p["identifier"] for p in SERVER["packages"] if p["registryType"] == "pypi"] == ["web-algebra"]
 
 
+def test_server_json_runs_the_mcp_command():
+    # `uvx web-algebra` alone would start the planner, not the server
+    assert [p.get("packageArguments") for p in SERVER["packages"]] == [[{"type": "positional", "value": "mcp"}]]
+
+
 def test_readme_carries_the_server_name():
     assert f"mcp-name: {SERVER['name']} " in (ROOT / "README.md").read_text().replace("-->", " -->")