build(demo): update notebook pin to bd8d0dc (correct v0.3.14 submodule)

Author: polaz

demo/notebooks/00_seed_data.ipynb

@@ -50,7 +50,7 @@
    "id": "a1b2c3d4-0000-0000-0000-000000000003",
    "metadata": {},
    "outputs": [],
-   "source": "import os, sys, subprocess\n\nIN_COLAB = \"google.colab\" in sys.modules\n\n# Install coordinode-embedded only when running in Colab AND no gRPC server is configured.\n# If COORDINODE_ADDR is set, a live server is already available — skip the 5-min Rust build.\nif IN_COLAB and not os.environ.get(\"COORDINODE_ADDR\"):\n    # Install Rust toolchain via rustup (https://rustup.rs).\n    # Colab's apt packages ship rustc ≤1.75, which cannot build coordinode-embedded\n    # (requires Rust ≥1.80 for maturin/pyo3). apt-get is not a viable alternative here.\n    # Download the installer to a temp file and execute it explicitly — this avoids\n    # piping remote content directly into a shell while maintaining HTTPS/TLS security\n    # through Python's default ssl context (cert-verified, TLS 1.2+).\n    # SHA256 pinning of rustup-init is intentionally omitted: rustup.rs does not\n    # publish a stable per-release checksum for sh.rustup.rs itself (only for\n    # platform-specific rustup-init binaries), and pinning a hash here would break\n    # silently on every rustup release. The HTTPS/TLS verification + temp-file\n    # execution (not piped to shell) is the rustup team's recommended trust model.\n    # No additional env-var gate (e.g. COORDINODE_ENABLE_RUSTUP) is needed:\n    # the `IN_COLAB and not COORDINODE_ADDR` check above already ensures this block\n    # never runs when a live gRPC server is available, so there is no risk of\n    # unintentional execution in local or server environments.\n    import ssl as _ssl, tempfile as _tmp, urllib.request as _ur\n\n    _ctx = _ssl.create_default_context()\n    with _tmp.NamedTemporaryFile(mode=\"wb\", suffix=\".sh\", delete=False) as _f:\n        with _ur.urlopen(\"https://sh.rustup.rs\", context=_ctx, timeout=30) as _r:\n            _f.write(_r.read())\n        _rustup_path = _f.name\n    try:\n        subprocess.run([\"/bin/sh\", _rustup_path, \"-s\", \"--\", \"-y\", \"-q\"], check=True, timeout=300)\n    finally:\n        os.unlink(_rustup_path)\n    # Add cargo to PATH so maturin/pip can find it.\n    _cargo_bin = os.path.expanduser(\"~/.cargo/bin\")\n    os.environ[\"PATH\"] = f\"{_cargo_bin}{os.pathsep}{os.environ.get('PATH', '')}\"\n    subprocess.run([sys.executable, \"-m\", \"pip\", \"install\", \"-q\", \"maturin\"], check=True, timeout=300)\n    subprocess.run(\n        [\n            sys.executable,\n            \"-m\",\n            \"pip\",\n            \"install\",\n            \"-q\",\n            \"git+https://github.com/structured-world/coordinode-python.git@e3ff279#subdirectory=coordinode-embedded\",\n        ],\n        check=True,\n        timeout=600,\n    )\n\nsubprocess.run(\n    [\n        sys.executable,\n        \"-m\",\n        \"pip\",\n        \"install\",\n        \"-q\",\n        \"coordinode\",\n        \"nest_asyncio\",\n    ],\n    check=True,\n    timeout=300,\n)\n\nimport nest_asyncio\n\nnest_asyncio.apply()\n\nprint(\"Ready\")"
+   "source": "import os, sys, subprocess\n\nIN_COLAB = \"google.colab\" in sys.modules\n\n# Install coordinode-embedded only when running in Colab AND no gRPC server is configured.\n# If COORDINODE_ADDR is set, a live server is already available — skip the 5-min Rust build.\nif IN_COLAB and not os.environ.get(\"COORDINODE_ADDR\"):\n    # Install Rust toolchain via rustup (https://rustup.rs).\n    # Colab's apt packages ship rustc ≤1.75, which cannot build coordinode-embedded\n    # (requires Rust ≥1.80 for maturin/pyo3). apt-get is not a viable alternative here.\n    # Download the installer to a temp file and execute it explicitly — this avoids\n    # piping remote content directly into a shell while maintaining HTTPS/TLS security\n    # through Python's default ssl context (cert-verified, TLS 1.2+).\n    # SHA256 pinning of rustup-init is intentionally omitted: rustup.rs does not\n    # publish a stable per-release checksum for sh.rustup.rs itself (only for\n    # platform-specific rustup-init binaries), and pinning a hash here would break\n    # silently on every rustup release. The HTTPS/TLS verification + temp-file\n    # execution (not piped to shell) is the rustup team's recommended trust model.\n    # No additional env-var gate (e.g. COORDINODE_ENABLE_RUSTUP) is needed:\n    # the `IN_COLAB and not COORDINODE_ADDR` check above already ensures this block\n    # never runs when a live gRPC server is available, so there is no risk of\n    # unintentional execution in local or server environments.\n    import ssl as _ssl, tempfile as _tmp, urllib.request as _ur\n\n    _ctx = _ssl.create_default_context()\n    with _tmp.NamedTemporaryFile(mode=\"wb\", suffix=\".sh\", delete=False) as _f:\n        with _ur.urlopen(\"https://sh.rustup.rs\", context=_ctx, timeout=30) as _r:\n            _f.write(_r.read())\n        _rustup_path = _f.name\n    try:\n        subprocess.run([\"/bin/sh\", _rustup_path, \"-s\", \"--\", \"-y\", \"-q\"], check=True, timeout=300)\n    finally:\n        os.unlink(_rustup_path)\n    # Add cargo to PATH so maturin/pip can find it.\n    _cargo_bin = os.path.expanduser(\"~/.cargo/bin\")\n    os.environ[\"PATH\"] = f\"{_cargo_bin}{os.pathsep}{os.environ.get('PATH', '')}\"\n    subprocess.run([sys.executable, \"-m\", \"pip\", \"install\", \"-q\", \"maturin\"], check=True, timeout=300)\n    subprocess.run(\n        [\n            sys.executable,\n            \"-m\",\n            \"pip\",\n            \"install\",\n            \"-q\",\n            \"git+https://github.com/structured-world/coordinode-python.git@bd8d0dc#subdirectory=coordinode-embedded\",\n        ],\n        check=True,\n        timeout=600,\n    )\n\nsubprocess.run(\n    [\n        sys.executable,\n        \"-m\",\n        \"pip\",\n        \"install\",\n        \"-q\",\n        \"coordinode\",\n        \"nest_asyncio\",\n    ],\n    check=True,\n    timeout=300,\n)\n\nimport nest_asyncio\n\nnest_asyncio.apply()\n\nprint(\"Ready\")"
   },
   {
    "cell_type": "markdown",
@@ -97,7 +97,7 @@
     "    except ImportError as exc:\n",
     "        raise RuntimeError(\n",
     "            \"coordinode-embedded is not installed. \"\n",
-    "            \"Run: pip install git+https://github.com/structured-world/coordinode-python.git@e3ff279#subdirectory=coordinode-embedded\"\n",
+    "            \"Run: pip install git+https://github.com/structured-world/coordinode-python.git@bd8d0dc#subdirectory=coordinode-embedded\"\n",
     "            \" — or start a CoordiNode server and set COORDINODE_ADDR.\"\n",
     "        ) from exc\n",
     "\n",

demo/notebooks/01_llama_index_property_graph.ipynb

@@ -39,7 +39,7 @@
    "id": "b2c3d4e5-0001-0000-0000-000000000003",
    "metadata": {},
    "outputs": [],
-   "source": "import os, sys, subprocess\n\nIN_COLAB = \"google.colab\" in sys.modules\n\n# Install coordinode-embedded in Colab only (requires Rust build).\nif IN_COLAB:\n    # Install Rust toolchain via rustup (https://rustup.rs).\n    # Colab's apt packages ship rustc ≤1.75, which cannot build coordinode-embedded\n    # (requires Rust ≥1.80 for maturin/pyo3). apt-get is not a viable alternative here.\n    # Download the installer to a temp file and execute it explicitly — this avoids\n    # piping remote content directly into a shell while maintaining HTTPS/TLS security\n    # through Python's default ssl context (cert-verified, TLS 1.2+).\n    # SHA256 pinning of rustup-init is intentionally omitted: rustup.rs does not\n    # publish a stable per-release checksum for sh.rustup.rs itself (only for\n    # platform-specific rustup-init binaries), and pinning a hash here would break\n    # silently on every rustup release. The HTTPS/TLS verification + temp-file\n    # execution (not piped to shell) is the rustup team's recommended trust model.\n    # No additional env-var gate (e.g. COORDINODE_ENABLE_RUSTUP) is needed:\n    # the `IN_COLAB` check above already ensures this block never runs outside\n    # Colab sessions, so there is no risk of unintentional execution in local\n    # or server environments.\n    import ssl as _ssl, tempfile as _tmp, urllib.request as _ur\n\n    _ctx = _ssl.create_default_context()\n    with _tmp.NamedTemporaryFile(mode=\"wb\", suffix=\".sh\", delete=False) as _f:\n        with _ur.urlopen(\"https://sh.rustup.rs\", context=_ctx, timeout=30) as _r:\n            _f.write(_r.read())\n        _rustup_path = _f.name\n    try:\n        subprocess.run([\"/bin/sh\", _rustup_path, \"-s\", \"--\", \"-y\", \"-q\"], check=True, timeout=300)\n    finally:\n        os.unlink(_rustup_path)\n    # Add cargo to PATH so maturin/pip can find it.\n    _cargo_bin = os.path.expanduser(\"~/.cargo/bin\")\n    os.environ[\"PATH\"] = f\"{_cargo_bin}{os.pathsep}{os.environ.get('PATH', '')}\"\n    subprocess.run([sys.executable, \"-m\", \"pip\", \"install\", \"-q\", \"maturin\"], check=True, timeout=300)\n    subprocess.run(\n        [\n            sys.executable,\n            \"-m\",\n            \"pip\",\n            \"install\",\n            \"-q\",\n            \"git+https://github.com/structured-world/coordinode-python.git@e3ff279#subdirectory=coordinode-embedded\",\n        ],\n        check=True,\n        timeout=600,\n    )\n\nsubprocess.run(\n    [\n        sys.executable,\n        \"-m\",\n        \"pip\",\n        \"install\",\n        \"-q\",\n        \"coordinode\",\n        \"llama-index-graph-stores-coordinode\",\n        \"llama-index-core\",\n        \"nest_asyncio\",\n    ],\n    check=True,\n    timeout=300,\n)\n\nimport nest_asyncio\n\nnest_asyncio.apply()\n\nprint(\"SDK installed\")"
+   "source": "import os, sys, subprocess\n\nIN_COLAB = \"google.colab\" in sys.modules\n\n# Install coordinode-embedded in Colab only (requires Rust build).\nif IN_COLAB:\n    # Install Rust toolchain via rustup (https://rustup.rs).\n    # Colab's apt packages ship rustc ≤1.75, which cannot build coordinode-embedded\n    # (requires Rust ≥1.80 for maturin/pyo3). apt-get is not a viable alternative here.\n    # Download the installer to a temp file and execute it explicitly — this avoids\n    # piping remote content directly into a shell while maintaining HTTPS/TLS security\n    # through Python's default ssl context (cert-verified, TLS 1.2+).\n    # SHA256 pinning of rustup-init is intentionally omitted: rustup.rs does not\n    # publish a stable per-release checksum for sh.rustup.rs itself (only for\n    # platform-specific rustup-init binaries), and pinning a hash here would break\n    # silently on every rustup release. The HTTPS/TLS verification + temp-file\n    # execution (not piped to shell) is the rustup team's recommended trust model.\n    # No additional env-var gate (e.g. COORDINODE_ENABLE_RUSTUP) is needed:\n    # the `IN_COLAB` check above already ensures this block never runs outside\n    # Colab sessions, so there is no risk of unintentional execution in local\n    # or server environments.\n    import ssl as _ssl, tempfile as _tmp, urllib.request as _ur\n\n    _ctx = _ssl.create_default_context()\n    with _tmp.NamedTemporaryFile(mode=\"wb\", suffix=\".sh\", delete=False) as _f:\n        with _ur.urlopen(\"https://sh.rustup.rs\", context=_ctx, timeout=30) as _r:\n            _f.write(_r.read())\n        _rustup_path = _f.name\n    try:\n        subprocess.run([\"/bin/sh\", _rustup_path, \"-s\", \"--\", \"-y\", \"-q\"], check=True, timeout=300)\n    finally:\n        os.unlink(_rustup_path)\n    # Add cargo to PATH so maturin/pip can find it.\n    _cargo_bin = os.path.expanduser(\"~/.cargo/bin\")\n    os.environ[\"PATH\"] = f\"{_cargo_bin}{os.pathsep}{os.environ.get('PATH', '')}\"\n    subprocess.run([sys.executable, \"-m\", \"pip\", \"install\", \"-q\", \"maturin\"], check=True, timeout=300)\n    subprocess.run(\n        [\n            sys.executable,\n            \"-m\",\n            \"pip\",\n            \"install\",\n            \"-q\",\n            \"git+https://github.com/structured-world/coordinode-python.git@bd8d0dc#subdirectory=coordinode-embedded\",\n        ],\n        check=True,\n        timeout=600,\n    )\n\nsubprocess.run(\n    [\n        sys.executable,\n        \"-m\",\n        \"pip\",\n        \"install\",\n        \"-q\",\n        \"coordinode\",\n        \"llama-index-graph-stores-coordinode\",\n        \"llama-index-core\",\n        \"nest_asyncio\",\n    ],\n    check=True,\n    timeout=300,\n)\n\nimport nest_asyncio\n\nnest_asyncio.apply()\n\nprint(\"SDK installed\")"
   },
   {
    "cell_type": "markdown",
@@ -109,7 +109,7 @@
    "id": "b2c3d4e5-0001-0000-0000-000000000007",
    "metadata": {},
    "outputs": [],
-   "source": "import os, socket\n\n\ndef _port_open(port):\n    try:\n        with socket.create_connection((\"127.0.0.1\", port), timeout=1):\n            return True\n    except OSError:\n        return False\n\n\nGRPC_PORT = int(os.environ.get(\"COORDINODE_PORT\", \"7080\"))\n\nif os.environ.get(\"COORDINODE_ADDR\"):\n    COORDINODE_ADDR = os.environ[\"COORDINODE_ADDR\"]\n    from coordinode import CoordinodeClient\n\n    client = CoordinodeClient(COORDINODE_ADDR)\n    print(f\"Connected to {COORDINODE_ADDR}\")\nelif _port_open(GRPC_PORT):\n    COORDINODE_ADDR = f\"localhost:{GRPC_PORT}\"\n    from coordinode import CoordinodeClient\n\n    client = CoordinodeClient(COORDINODE_ADDR)\n    print(f\"Connected to {COORDINODE_ADDR}\")\nelse:\n    # No server available — use the embedded in-process engine.\n    # Works without Docker or any external service; data is in-memory.\n    try:\n        from coordinode_embedded import LocalClient\n    except ImportError as exc:\n        raise RuntimeError(\n            \"coordinode-embedded is not installed. \"\n            \"Run: pip install git+https://github.com/structured-world/coordinode-python.git@e3ff279#subdirectory=coordinode-embedded\"\n            \" — or start a CoordiNode server and set COORDINODE_ADDR.\"\n        ) from exc\n\n    _lc = LocalClient(\":memory:\")\n    client = _EmbeddedAdapter(_lc)\n    print(\"Using embedded LocalClient (in-process)\")"
+   "source": "import os, socket\n\n\ndef _port_open(port):\n    try:\n        with socket.create_connection((\"127.0.0.1\", port), timeout=1):\n            return True\n    except OSError:\n        return False\n\n\nGRPC_PORT = int(os.environ.get(\"COORDINODE_PORT\", \"7080\"))\n\nif os.environ.get(\"COORDINODE_ADDR\"):\n    COORDINODE_ADDR = os.environ[\"COORDINODE_ADDR\"]\n    from coordinode import CoordinodeClient\n\n    client = CoordinodeClient(COORDINODE_ADDR)\n    print(f\"Connected to {COORDINODE_ADDR}\")\nelif _port_open(GRPC_PORT):\n    COORDINODE_ADDR = f\"localhost:{GRPC_PORT}\"\n    from coordinode import CoordinodeClient\n\n    client = CoordinodeClient(COORDINODE_ADDR)\n    print(f\"Connected to {COORDINODE_ADDR}\")\nelse:\n    # No server available — use the embedded in-process engine.\n    # Works without Docker or any external service; data is in-memory.\n    try:\n        from coordinode_embedded import LocalClient\n    except ImportError as exc:\n        raise RuntimeError(\n            \"coordinode-embedded is not installed. \"\n            \"Run: pip install git+https://github.com/structured-world/coordinode-python.git@bd8d0dc#subdirectory=coordinode-embedded\"\n            \" — or start a CoordiNode server and set COORDINODE_ADDR.\"\n        ) from exc\n\n    _lc = LocalClient(\":memory:\")\n    client = _EmbeddedAdapter(_lc)\n    print(\"Using embedded LocalClient (in-process)\")"
   },
   {
    "cell_type": "markdown",