rete-graph 0.2.2__tar.gz → 0.3.0__tar.gz

{rete_graph-0.2.2 → rete_graph-0.3.0}/Cargo.toml

@@ -14,10 +14,10 @@ members = [
 # release gates (--locked checks, feature matrix, coverage floors) stay
 # untouched by binding-only changes. Future clients (R, Go) follow the same
 # pattern — clients/ consumes crates/, never the other way around.
-exclude = ["fuzz", "clients/python", "clients/r/src/rust"]
+exclude = ["fuzz", "clients/python", "clients/r/src/rust", "clients/java/ffi"]
 
 [workspace.package]
-version = "1.0.0-rc.1"
+version = "0.3.0"
 edition = "2021"
 license = "Apache-2.0"
 repository = "https://github.com/caviri/rete"

{rete_graph-0.2.2 → rete_graph-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rete-graph
-Version: 0.2.2
+Version: 0.3.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -49,7 +49,9 @@ Wheels cover Linux (x86_64/aarch64), macOS, Windows — and, from 0.2.0,
 graphs are queried over sync-XHR range requests, no server anywhere.
 
 A runnable tour with captured outputs lives in
-[`examples/tutorial.ipynb`](examples/tutorial.ipynb).
+[`examples/tutorial.ipynb`](examples/tutorial.ipynb), and
+[`examples/agents/`](examples/agents) turns a graph into agent tools for
+LangChain and Pydantic AI.
 
 ## Use
 

{rete_graph-0.2.2/clients/python → rete_graph-0.3.0}/README.md

@@ -21,7 +21,9 @@ Wheels cover Linux (x86_64/aarch64), macOS, Windows — and, from 0.2.0,
 graphs are queried over sync-XHR range requests, no server anywhere.
 
 A runnable tour with captured outputs lives in
-[`examples/tutorial.ipynb`](examples/tutorial.ipynb).
+[`examples/tutorial.ipynb`](examples/tutorial.ipynb), and
+[`examples/agents/`](examples/agents) turns a graph into agent tools for
+LangChain and Pydantic AI.
 
 ## Use
 

{rete_graph-0.2.2 → rete_graph-0.3.0}/clients/python/Cargo.lock

@@ -49,12 +49,6 @@ dependencies = [
  "generic-array",
 ]
 
-[[package]]
-name = "bumpalo"
-version = "3.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
-
 [[package]]
 name = "cc"
 version = "1.2.67"
@@ -143,30 +137,6 @@ dependencies = [
  "percent-encoding",
 ]
 
-[[package]]
-name = "futures-core"
-version = "0.3.32"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e3450815272ef58cec6d564423f6e755e25379b217b0bc688e295ba24df6b1d"
-
-[[package]]
-name = "futures-task"
-version = "0.3.32"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "037711b3d59c33004d3856fbdc83b99d4ff37a24768fa1be9ce3538a1cde4393"
-
-[[package]]
-name = "futures-util"
-version = "0.3.32"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "389ca41296e6190b48053de0321d02a77f32f8a5d2461dd38762c0593805c6d6"
-dependencies = [
- "futures-core",
- "futures-task",
- "pin-project-lite",
- "slab",
-]
-
 [[package]]
 name = "generic-array"
 version = "0.14.7"
@@ -184,10 +154,8 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
 dependencies = [
  "cfg-if",
- "js-sys",
  "libc",
  "wasi",
- "wasm-bindgen",
 ]
 
 [[package]]
@@ -335,17 +303,6 @@ dependencies = [
  "libc",
 ]
 
-[[package]]
-name = "js-sys"
-version = "0.3.103"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
-dependencies = [
- "cfg-if",
- "futures-util",
- "wasm-bindgen",
-]
-
 [[package]]
 name = "libc"
 version = "0.2.186"
@@ -481,12 +438,6 @@ version = "2.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
 
-[[package]]
-name = "pin-project-lite"
-version = "0.2.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
-
 [[package]]
 name = "pkg-config"
 version = "0.3.33"
@@ -651,7 +602,7 @@ checksum = "cab834c73d247e67f4fae452806d17d3c7501756d98c8808d7c9c7aa7d18f973"
 
 [[package]]
 name = "rete-core"
-version = "1.0.0-rc.1"
+version = "0.3.0"
 dependencies = [
  "blake3",
  "getrandom 0.2.17",
@@ -671,7 +622,7 @@ dependencies = [
 
 [[package]]
 name = "rete-python"
-version = "0.2.1"
+version = "0.3.0"
 dependencies = [
  "pyo3",
  "rete-core",
@@ -813,12 +764,6 @@ version = "2.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
 
-[[package]]
-name = "slab"
-version = "0.4.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
-
 [[package]]
 name = "smallvec"
 version = "1.15.2"
@@ -994,51 +939,6 @@ version = "0.11.1+wasi-snapshot-preview1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
 
-[[package]]
-name = "wasm-bindgen"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
-dependencies = [
- "cfg-if",
- "once_cell",
- "rustversion",
- "wasm-bindgen-macro",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-macro"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
-dependencies = [
- "quote",
- "wasm-bindgen-macro-support",
-]
-
-[[package]]
-name = "wasm-bindgen-macro-support"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
-dependencies = [
- "bumpalo",
- "proc-macro2",
- "quote",
- "syn",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-shared"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
-dependencies = [
- "unicode-ident",
-]
-
 [[package]]
 name = "webpki-roots"
 version = "0.26.11"

{rete_graph-0.2.2 → rete_graph-0.3.0}/clients/python/Cargo.toml

@@ -3,9 +3,10 @@
 # maturin (pyproject.toml), and is published to PyPI, never to crates.io.
 [package]
 name = "rete-python"
-# Keep in lockstep with pyproject.toml's [project] version — __version__
-# comes from here (CARGO_PKG_VERSION), the wheel metadata from pyproject.
-version = "0.2.1"
+# Kept in lockstep with pyproject.toml's [project] version, and with the engine's
+# major.minor, by scripts/sync_versions.py (--check runs in CI). __version__ comes
+# from here (CARGO_PKG_VERSION), the wheel metadata from pyproject.
+version = "0.3.0"
 edition = "2021"
 license = "Apache-2.0"
 repository = "https://github.com/caviri/rete"

{rete_graph-0.2.2 → rete_graph-0.3.0/clients/python}/README.md

@@ -21,7 +21,9 @@ Wheels cover Linux (x86_64/aarch64), macOS, Windows — and, from 0.2.0,
 graphs are queried over sync-XHR range requests, no server anywhere.
 
 A runnable tour with captured outputs lives in
-[`examples/tutorial.ipynb`](examples/tutorial.ipynb).
+[`examples/tutorial.ipynb`](examples/tutorial.ipynb), and
+[`examples/agents/`](examples/agents) turns a graph into agent tools for
+LangChain and Pydantic AI.
 
 ## Use
 

rete_graph-0.3.0/clients/python/examples/agents/README.md

@@ -0,0 +1,54 @@
+# Agent frameworks over a `.rete` graph
+
+Runnable companions to the
+[LangChain & Pydantic AI tutorial](https://caviri.github.io/rete/agent-frameworks.html).
+Each script gives a model five tools over **one** `.rete` file — card, schema,
+examples, entity lookup, SPARQL — and lets it answer questions by querying.
+The file is read by byte range, local or remote, with no server in between.
+
+| File | What it is |
+| --- | --- |
+| `rete_tools.py` | The tool layer. Framework-agnostic: five methods returning JSON, plus the system prompt that teaches the loop. |
+| `pydantic_ai_agent.py` | [Pydantic AI](https://ai.pydantic.dev) agent — bound methods passed straight to `Agent(tools=[...])`. |
+| `langchain_agent.py` | [LangChain](https://python.langchain.com) agent — the same methods via `StructuredTool.from_function` and `create_agent`. |
+
+## Run
+
+```sh
+pip install rete-graph "pydantic-ai-slim[anthropic]"     # ... or
+pip install rete-graph langchain langchain-anthropic
+
+export ANTHROPIC_API_KEY=...
+python pydantic_ai_agent.py "How many laws are here? Show me three with their titles."
+python langchain_agent.py   "Which three laws are the oldest?"
+```
+
+Both default to the published Spanish-legislation graph
+(`https://data.graphplaza.com/boe/boe.rete`, 7 MB on a CDN). Point them
+anywhere — including a private file that never leaves the machine:
+
+```sh
+RETE_GRAPH=/path/to/my-graph.rete python langchain_agent.py "What is in this graph?"
+```
+
+Any OpenAI-compatible endpoint works instead of Anthropic (`pip install
+langchain-openai` for the LangChain script):
+
+```sh
+export OPENAI_BASE_URL=https://your-endpoint/v1 OPENAI_API_KEY=... MODEL=...
+```
+
+Each run prints the bytes and requests actually fetched, so the cost of the
+agent's exploration stays visible:
+
+```
+[graph reads: {'fileLength': 6958628, 'bytes': 3065519, 'requests': 18}]
+```
+
+## Verified
+
+Both scripts were run end to end against a live tool-calling model and the
+remote `boe` graph: the agent reads the schema, copies the ELI IRIs out of it,
+writes its own SPARQL, and answers from the rows. The MCP alternative —
+pointing either framework at the hosted rete MCP server instead — is in the
+same tutorial.

rete_graph-0.3.0/clients/python/examples/agents/langchain_agent.py

@@ -0,0 +1,66 @@
+"""A LangChain agent that answers questions from one `.rete` graph.
+
+    pip install rete-graph langchain langchain-anthropic
+    export ANTHROPIC_API_KEY=...
+    python langchain_agent.py "How many laws are in this graph, and which are the oldest?"
+
+Defaults to the published Spanish-legislation graph (7 MB on a CDN, read by
+byte range). Point it anywhere with RETE_GRAPH=/path/to/your.rete.
+
+Any OpenAI-compatible endpoint works instead of Anthropic:
+
+    pip install langchain-openai
+    export OPENAI_BASE_URL=https://your-endpoint/v1 OPENAI_API_KEY=... MODEL=...
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from langchain.agents import create_agent
+from langchain_core.tools import StructuredTool
+
+from rete_tools import SYSTEM_PROMPT, ReteGraphTools
+
+GRAPH = os.environ.get("RETE_GRAPH", "https://data.graphplaza.com/boe/boe.rete")
+
+
+def build_model():
+    """An Anthropic model by default; an OpenAI-compatible endpoint if configured."""
+    model = os.environ.get("MODEL", "claude-sonnet-5")
+    base_url = os.environ.get("OPENAI_BASE_URL")
+    if not base_url:
+        from langchain.chat_models import init_chat_model
+
+        return init_chat_model(model, model_provider="anthropic")
+
+    from langchain_openai import ChatOpenAI
+
+    return ChatOpenAI(model=model, base_url=base_url, api_key=os.environ["OPENAI_API_KEY"])
+
+
+def rete_toolkit(source: str) -> tuple[ReteGraphTools, list[StructuredTool]]:
+    """Bound methods → LangChain tools; name and description come from the method."""
+    tools = ReteGraphTools(source)
+    methods = [
+        tools.dataset_card,
+        tools.dataset_schema,
+        tools.example_queries,
+        tools.find_entities,
+        tools.sparql_query,
+    ]
+    return tools, [StructuredTool.from_function(m, name=m.__name__) for m in methods]
+
+
+def main(question: str) -> None:
+    tools, toolkit = rete_toolkit(GRAPH)
+    agent = create_agent(build_model(), toolkit, system_prompt=SYSTEM_PROMPT)
+
+    result = agent.invoke({"messages": [{"role": "user", "content": question}]})
+    print(result["messages"][-1].content)
+    print(f"\n[graph reads: {tools.read_stats()}]")
+
+
+if __name__ == "__main__":
+    main(" ".join(sys.argv[1:]) or "What is in this graph? Show me five example entities.")

rete_graph-0.3.0/clients/python/examples/agents/pydantic_ai_agent.py

@@ -0,0 +1,68 @@
+"""A Pydantic AI agent that answers questions from one `.rete` graph.
+
+    pip install rete-graph "pydantic-ai-slim[anthropic]"
+    export ANTHROPIC_API_KEY=...
+    python pydantic_ai_agent.py "How many laws are in this graph, and which are the oldest?"
+
+Defaults to the published Spanish-legislation graph (7 MB on a CDN, read by
+byte range). Point it anywhere with RETE_GRAPH=/path/to/your.rete.
+
+Any OpenAI-compatible endpoint works instead of Anthropic:
+
+    export OPENAI_BASE_URL=https://your-endpoint/v1 OPENAI_API_KEY=... MODEL=...
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import sys
+
+from pydantic_ai import Agent
+
+from rete_tools import SYSTEM_PROMPT, ReteGraphTools
+
+GRAPH = os.environ.get("RETE_GRAPH", "https://data.graphplaza.com/boe/boe.rete")
+
+
+def build_model():
+    """An Anthropic model by default; an OpenAI-compatible endpoint if configured."""
+    model = os.environ.get("MODEL", "anthropic:claude-sonnet-5")
+    base_url = os.environ.get("OPENAI_BASE_URL")
+    if not base_url:
+        return model
+
+    from pydantic_ai.models.openai import OpenAIChatModel
+    from pydantic_ai.providers.openai import OpenAIProvider
+
+    return OpenAIChatModel(
+        model,
+        provider=OpenAIProvider(base_url=base_url, api_key=os.environ["OPENAI_API_KEY"]),
+    )
+
+
+async def main(question: str) -> None:
+    tools = ReteGraphTools(GRAPH)
+
+    # Bound methods: pydantic-ai reads the signature for the schema and the
+    # docstring for the description, so the tools need no extra declaration.
+    agent = Agent(
+        build_model(),
+        system_prompt=SYSTEM_PROMPT,
+        tools=[
+            tools.dataset_card,
+            tools.dataset_schema,
+            tools.example_queries,
+            tools.find_entities,
+            tools.sparql_query,
+        ],
+    )
+
+    result = await agent.run(question)
+    print(result.output)
+    print(f"\n[graph reads: {tools.read_stats()}]")
+
+
+if __name__ == "__main__":
+    question = " ".join(sys.argv[1:]) or "What is in this graph? Show me five example entities."
+    asyncio.run(main(question))

rete_graph-0.3.0/clients/python/examples/agents/rete_tools.py

@@ -0,0 +1,161 @@
+"""A framework-agnostic tool surface over one `.rete` graph.
+
+Five tools mirror the read loop the rete MCP server exposes — card → schema →
+examples → find_entities → sparql_query — but run **in process**, against a
+local path or an `https://` URL, with no server between the agent and the file.
+
+Each method returns a JSON string, because that is what every agent framework
+wants to hand a model. Results are trimmed: a real schema is hundreds of
+kilobytes, which would swamp the context window without telling the model
+anything it can act on.
+
+Reads are byte ranges, so the cost of a tool call is bounded by the *query*,
+not the file: `tools.read_stats()` reports the bytes and requests actually
+fetched so far.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List
+
+import rete_graph as rete
+
+MAX_ROWS = 100  # rows handed back to the model
+MAX_CLASSES = 40  # schema trimming — the full profile is far too big to prompt with
+MAX_RELATIONS = 60
+MAX_EXAMPLES = 8
+
+
+def _json(obj: Any) -> str:
+    return json.dumps(obj, ensure_ascii=False, default=str)
+
+
+def _value(term: Any) -> Any:
+    """A `Term` as a plain JSON value: typed literals become int/float/bool."""
+    try:
+        return term.to_python()
+    except Exception:  # unusual datatype — keep the lexical form
+        return term.value
+
+
+class ReteGraphTools:
+    """The five tools, bound to one graph.
+
+    >>> tools = ReteGraphTools("https://data.graphplaza.com/boe/boe.rete")
+    >>> tools.dataset_card()[:40]
+    '{"title": "BOE — Spanish consolidated l'
+    """
+
+    def __init__(self, source: str, *, max_rows: int = MAX_ROWS, **open_kwargs: Any):
+        self.source = source
+        self.max_rows = max_rows
+        self.graph = rete.open(source, **open_kwargs)
+
+    # -- discovery ---------------------------------------------------------
+
+    def dataset_card(self) -> str:
+        """What this graph is: title, description, licence, size, vocabularies."""
+        card = self.graph.card() or {}
+        keep = (
+            "title",
+            "description",
+            "license",
+            "source",
+            "created",
+            "triple_count",
+            "quad_count",
+            "term_count",
+            "vocabularies",
+            "languages",
+        )
+        out: Dict[str, Any] = {k: card[k] for k in keep if card.get(k)}
+        out["info"] = self.graph.info()
+        return _json(out)
+
+    def dataset_schema(self) -> str:
+        """The classes and subject→predicate→object relations actually present.
+
+        Copy these IRIs verbatim into queries; do not invent namespaces.
+        """
+        schema = self.graph.schema()
+        classes = sorted(schema.get("classes", []), key=lambda c: -c[1])[:MAX_CLASSES]
+        relations = sorted(schema.get("relations", []), key=lambda r: -r[3])[:MAX_RELATIONS]
+        return _json(
+            {
+                "classes": [{"class": c[0], "instances": c[1]} for c in classes],
+                "relations": [
+                    {"subject_class": r[0], "predicate": r[1], "object_class": r[2], "count": r[3]}
+                    for r in relations
+                ],
+                "note": (
+                    f"top {len(classes)}/{len(schema.get('classes', []))} classes and "
+                    f"{len(relations)}/{len(schema.get('relations', []))} relations, by count"
+                ),
+            }
+        )
+
+    def example_queries(self) -> str:
+        """Runnable SPARQL the dataset ships with — the graph's own idioms."""
+        examples = self.graph.examples() or []
+        return _json(
+            [
+                {"question": e.get("question") or e.get("title"), "sparql": e.get("sparql")}
+                for e in examples[:MAX_EXAMPLES]
+            ]
+        )
+
+    # -- lookup ------------------------------------------------------------
+
+    def find_entities(self, text: str) -> str:
+        """Resolve a name to entity IRIs. Use before querying for a named thing."""
+        hits: List[List[str]] = list(self.graph.prefix_search(text) or [])
+        if not hits:
+            # only present when the file was built with --text-index; [] otherwise
+            hits = list(self.graph.text_search(text) or [])
+        return _json([{"label": h[0], "iri": h[1]} for h in hits[:20]])
+
+    # -- query -------------------------------------------------------------
+
+    def sparql_query(self, query: str) -> str:
+        """Run SPARQL 1.1 (SELECT / ASK / CONSTRUCT / DESCRIBE) over the graph.
+
+        A syntax or vocabulary mistake comes back as `{"error": ...}` with the
+        parser's message — read it and retry rather than giving up.
+        """
+        try:
+            result = self.graph.query(query)
+        except (ValueError, RuntimeError) as exc:
+            return _json({"error": str(exc)})
+
+        if isinstance(result, bool):
+            return _json({"kind": "ask", "boolean": result})
+        if result and isinstance(result[0], tuple):
+            triples = [[_value(t) for t in row] for row in result[: self.max_rows]]
+            return _json(
+                {"kind": "graph", "triples": triples, "truncated": len(result) > self.max_rows}
+            )
+        rows = [{k: _value(v) for k, v in row.items()} for row in result[: self.max_rows]]
+        return _json({"kind": "table", "rows": rows, "truncated": len(result) > self.max_rows})
+
+    # -- observability -----------------------------------------------------
+
+    def read_stats(self) -> Dict[str, Any]:
+        """Bytes and requests physically fetched so far — laziness, measured."""
+        return self.graph.stats()
+
+
+SYSTEM_PROMPT = """\
+You answer questions about ONE RDF knowledge graph by writing and running
+SPARQL. Ground every answer in query results — never guess.
+
+Method:
+1. dataset_card, then dataset_schema. Copy class and predicate IRIs exactly
+   from the schema; never invent a namespace or a prefix.
+2. example_queries shows how this particular graph is meant to be queried.
+3. If the question names a specific thing, resolve it with find_entities first.
+4. sparql_query, then read the rows and refine. Always use LIMIT (<= 200).
+   If a query errors, fix it from the message and try again.
+
+Answer in prose, and state the SPARQL you ran.
+"""

{rete_graph-0.2.2 → rete_graph-0.3.0}/clients/python/src/lib.rs

@@ -127,6 +127,15 @@ impl Graph {
         }
         Ok(())
     }
+
+    /// The incompleteness verdict is PER CALL on this resident handle: reset
+    /// the sticky failure flags before evaluating, so one transient network
+    /// failure fails only the call it happened in — failed tiles/chunks are
+    /// never cached, so the next call simply retries them. (Same shape as the
+    /// browser engine's RemoteGraph entry points.)
+    fn fresh_verdict(&self) {
+        self.rete.reset_load_failures();
+    }
 }
 
 #[pymethods]
@@ -143,6 +152,7 @@ impl Graph {
         graph: Option<&str>,
         format: &str,
     ) -> PyResult<String> {
+        self.fresh_verdict();
         let out = py
             .allow_threads(|| -> Result<String, String> {
                 let shapes =
@@ -169,6 +179,7 @@ impl Graph {
     /// QL entailment by query rewriting.
     #[pyo3(signature = (query, *, reason=false))]
     fn query(&self, py: Python<'_>, query: &str, reason: bool) -> PyResult<String> {
+        self.fresh_verdict();
         let out = py
             .allow_threads(|| {
                 if reason {
@@ -474,5 +485,8 @@ fn _rete(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_function(wrap_pyfunction!(build, m)?)?;
     m.add_function(wrap_pyfunction!(build_dataset, m)?)?;
     m.add("__version__", env!("CARGO_PKG_VERSION"))?;
+    // The binding's version tracks the binding; this reports the engine actually
+    // compiled into the wheel, which is what "does my install support X?" means.
+    m.add("__engine_version__", rete_core::VERSION)?;
     Ok(())
 }

{rete_graph-0.2.2 → rete_graph-0.3.0}/crates/rete-core/Cargo.toml

@@ -14,6 +14,12 @@ categories = ["database", "data-structures", "web-programming"]
 publish = ["crates-io"]
 include = ["src/**", "tests/**", "examples/**", "Cargo.toml", "README.md", "LICENSE"]
 
+# docs.rs builds default features only, which would hide the `parallel` module.
+# The builder is native Linux with a C toolchain, so `compression` + `rayon`
+# both build there.
+[package.metadata.docs.rs]
+all-features = true
+
 [dependencies]
 thiserror.workspace = true
 oxrdf.workspace = true
@@ -33,8 +39,11 @@ regex-lite = "0.1"
 md-5 = "0.10"
 sha1 = "0.10"
 sha2 = "0.10"
-# Randomness for the SPARQL RAND/UUID/STRUUID/BNODE built-ins. On wasm the
-# browser backend is enabled via the `js` feature in the wasm-target block below.
+# Randomness for the SPARQL RAND/UUID/STRUUID/BNODE built-ins. On
+# wasm32-unknown-unknown getrandom has no default backend: a *browser* consumer
+# turns on the `wasm-js` feature below (crypto.getRandomValues); a non-browser
+# wasm host (Chicory/WASI/Wasmtime) must supply its own via getrandom's `custom`
+# backend. Native targets use the OS backend and need neither.
 getrandom = "0.2"
 zstd = { workspace = true, optional = true }
 # Data-parallel query evaluator (prototype). Behind the `parallel` feature so it
@@ -54,6 +63,11 @@ compression = ["dep:zstd"]
 # Prototype data-parallel query evaluator. NOT default; wasm must never enable it
 # (wasm has no threads). Enables the `parallel` module + `rayon`.
 parallel = ["dep:rayon"]
+# getrandom's browser backend (crypto.getRandomValues, via js-sys/wasm-bindgen).
+# Enable ONLY for a wasm build that runs in a browser — it makes the module
+# import wasm-bindgen JS glue, which a non-browser wasm host (Chicory on the JVM,
+# WASI) cannot link. Those hosts leave this off and register a `custom` backend.
+wasm-js = ["getrandom/js"]
 
 # The parallel benchmark only compiles with the `parallel` feature (it uses
 # rayon + the feature-gated `parallel` module). Without the gate, a default
@@ -61,7 +75,3 @@ parallel = ["dep:rayon"]
 [[example]]
 name = "parallel_bench"
 required-features = ["parallel"]
-
-# On wasm, getrandom (pulled transitively via oxrdf) needs its browser backend.
-[target.'cfg(target_arch = "wasm32")'.dependencies]
-getrandom = { version = "0.2", features = ["js"] }