ghostai-connect 0.0.1__tar.gz

ghostai_connect-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dymium, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ghostai_connect-0.0.1/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: ghostai-connect
+Version: 0.0.1
+Summary: Placeholder for the GhostAI Connect client: explains how to get it and checks that the GhostAI relay is reachable. Contains no client code.
+Author-email: GhostAI <support@dymium.io>
+License-Expression: MIT
+Project-URL: Homepage, https://ghostai.dymium.io
+Keywords: ghostai,connector,relay
+Classifier: Development Status :: 1 - Planning
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ghostai-connect (placeholder)
+
+This release holds the `ghostai-connect` name on PyPI for GhostAI. **It is not
+the GhostAI Connect client** and contains none of its code. It cannot open a
+tunnel.
+
+GhostAI Connect is the small client a GhostAI customer runs next to their own
+Ollama or vLLM server. It opens an outbound-only WebSocket connection to the
+GhostAI relay, so no inbound firewall rule is needed.
+
+## Getting the real client
+
+Contact GhostAI at support@dymium.io, or ask your GhostAI administrator. The
+client is provided as either:
+
+- a wheel file: `pip install ./ghostai_connect-<version>-py3-none-any.whl`
+- a signed container image, `ghcr.io/dymium-io/ghostai-connect` (access is
+  granted by GhostAI). Verify it with `cosign verify` before you run it.
+
+Then enroll it with the single-use token from the GhostAI admin console.
+
+When the client is published here, `pip install --upgrade ghostai-connect`
+replaces this placeholder.
+
+## What this package does
+
+```console
+$ pip install ghostai-connect
+$ ghostai-connect
+```
+
+It prints the instructions above, then checks that the GhostAI relay is
+reachable from your network. The check sends one HTTPS request to
+`relay-connector.alpha.dymium.io` with a 5-second timeout. It sends no
+credentials and opens no connector session. It exits `0` when the relay is
+reachable and `1` when it is not. Any other subcommand, such as `run` or
+`enroll`, exits `2`.
+
+| Option | Meaning |
+|---|---|
+| `--relay-url URL` | Check a different relay (default: `$GHOSTAI_CONNECT_RELAY_URL`, else `wss://relay-connector.alpha.dymium.io/connector/ws`) |
+| `--timeout SECONDS` | How long to wait for the relay (default: 5) |
+| `--no-check` | Print the instructions only, with no network access |
+| `--version` | Print the version |
+
+Python 3.8 or later, standard library only, no dependencies.
+
+## License
+
+MIT, for this placeholder's own code only. The license of the GhostAI Connect
+client is set by that client's own releases.

ghostai_connect-0.0.1/README.md

@@ -0,0 +1,51 @@
+# ghostai-connect (placeholder)
+
+This release holds the `ghostai-connect` name on PyPI for GhostAI. **It is not
+the GhostAI Connect client** and contains none of its code. It cannot open a
+tunnel.
+
+GhostAI Connect is the small client a GhostAI customer runs next to their own
+Ollama or vLLM server. It opens an outbound-only WebSocket connection to the
+GhostAI relay, so no inbound firewall rule is needed.
+
+## Getting the real client
+
+Contact GhostAI at support@dymium.io, or ask your GhostAI administrator. The
+client is provided as either:
+
+- a wheel file: `pip install ./ghostai_connect-<version>-py3-none-any.whl`
+- a signed container image, `ghcr.io/dymium-io/ghostai-connect` (access is
+  granted by GhostAI). Verify it with `cosign verify` before you run it.
+
+Then enroll it with the single-use token from the GhostAI admin console.
+
+When the client is published here, `pip install --upgrade ghostai-connect`
+replaces this placeholder.
+
+## What this package does
+
+```console
+$ pip install ghostai-connect
+$ ghostai-connect
+```
+
+It prints the instructions above, then checks that the GhostAI relay is
+reachable from your network. The check sends one HTTPS request to
+`relay-connector.alpha.dymium.io` with a 5-second timeout. It sends no
+credentials and opens no connector session. It exits `0` when the relay is
+reachable and `1` when it is not. Any other subcommand, such as `run` or
+`enroll`, exits `2`.
+
+| Option | Meaning |
+|---|---|
+| `--relay-url URL` | Check a different relay (default: `$GHOSTAI_CONNECT_RELAY_URL`, else `wss://relay-connector.alpha.dymium.io/connector/ws`) |
+| `--timeout SECONDS` | How long to wait for the relay (default: 5) |
+| `--no-check` | Print the instructions only, with no network access |
+| `--version` | Print the version |
+
+Python 3.8 or later, standard library only, no dependencies.
+
+## License
+
+MIT, for this placeholder's own code only. The license of the GhostAI Connect
+client is set by that client's own releases.

ghostai_connect-0.0.1/ghostai_connect.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: ghostai-connect
+Version: 0.0.1
+Summary: Placeholder for the GhostAI Connect client: explains how to get it and checks that the GhostAI relay is reachable. Contains no client code.
+Author-email: GhostAI <support@dymium.io>
+License-Expression: MIT
+Project-URL: Homepage, https://ghostai.dymium.io
+Keywords: ghostai,connector,relay
+Classifier: Development Status :: 1 - Planning
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ghostai-connect (placeholder)
+
+This release holds the `ghostai-connect` name on PyPI for GhostAI. **It is not
+the GhostAI Connect client** and contains none of its code. It cannot open a
+tunnel.
+
+GhostAI Connect is the small client a GhostAI customer runs next to their own
+Ollama or vLLM server. It opens an outbound-only WebSocket connection to the
+GhostAI relay, so no inbound firewall rule is needed.
+
+## Getting the real client
+
+Contact GhostAI at support@dymium.io, or ask your GhostAI administrator. The
+client is provided as either:
+
+- a wheel file: `pip install ./ghostai_connect-<version>-py3-none-any.whl`
+- a signed container image, `ghcr.io/dymium-io/ghostai-connect` (access is
+  granted by GhostAI). Verify it with `cosign verify` before you run it.
+
+Then enroll it with the single-use token from the GhostAI admin console.
+
+When the client is published here, `pip install --upgrade ghostai-connect`
+replaces this placeholder.
+
+## What this package does
+
+```console
+$ pip install ghostai-connect
+$ ghostai-connect
+```
+
+It prints the instructions above, then checks that the GhostAI relay is
+reachable from your network. The check sends one HTTPS request to
+`relay-connector.alpha.dymium.io` with a 5-second timeout. It sends no
+credentials and opens no connector session. It exits `0` when the relay is
+reachable and `1` when it is not. Any other subcommand, such as `run` or
+`enroll`, exits `2`.
+
+| Option | Meaning |
+|---|---|
+| `--relay-url URL` | Check a different relay (default: `$GHOSTAI_CONNECT_RELAY_URL`, else `wss://relay-connector.alpha.dymium.io/connector/ws`) |
+| `--timeout SECONDS` | How long to wait for the relay (default: 5) |
+| `--no-check` | Print the instructions only, with no network access |
+| `--version` | Print the version |
+
+Python 3.8 or later, standard library only, no dependencies.
+
+## License
+
+MIT, for this placeholder's own code only. The license of the GhostAI Connect
+client is set by that client's own releases.

ghostai_connect-0.0.1/ghostai_connect.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+ghostai_connect_stub.py
+pyproject.toml
+ghostai_connect.egg-info/PKG-INFO
+ghostai_connect.egg-info/SOURCES.txt
+ghostai_connect.egg-info/dependency_links.txt
+ghostai_connect.egg-info/entry_points.txt
+ghostai_connect.egg-info/top_level.txt

ghostai_connect-0.0.1/ghostai_connect.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ghostai_connect-0.0.1/ghostai_connect.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ghostai-connect = ghostai_connect_stub:main

ghostai_connect-0.0.1/ghostai_connect.egg-info/top_level.txt

@@ -0,0 +1 @@
+ghostai_connect_stub

ghostai_connect-0.0.1/ghostai_connect_stub.py

@@ -0,0 +1,101 @@
+"""Placeholder for the GhostAI Connect client.
+
+This distribution holds the ``ghostai-connect`` name on PyPI. It contains none
+of the connector's code: it prints how to get the real client and checks that
+the GhostAI relay is reachable from this network. Standard library only.
+"""
+
+from __future__ import annotations
+
+import argparse
+import http.client
+import os
+import ssl
+import sys
+from urllib.parse import urlsplit
+
+__version__ = "0.0.1"
+
+DEFAULT_RELAY_URL = "wss://relay-connector.alpha.dymium.io/connector/ws"
+
+HOW_TO_GET = """\
+ghostai-connect {version} is a placeholder that holds this name on PyPI.
+It is not the GhostAI Connect client and cannot open a tunnel.
+
+To get the real client, contact GhostAI (support@dymium.io) or your GhostAI
+administrator. It is provided as either:
+  - a wheel file:  pip install ./ghostai_connect-<version>-py3-none-any.whl
+  - a signed container image, ghcr.io/dymium-io/ghostai-connect (access is
+    granted by GhostAI; verify it with cosign before you run it)
+Then enroll it with the single-use token from the GhostAI admin console.
+"""
+
+
+def check_relay(url: str, timeout: float) -> tuple[bool, str]:
+    """Send one unauthenticated HTTPS GET to the relay's connector endpoint.
+
+    A plain GET (no WebSocket upgrade) is answered with a 404 by the relay
+    process itself, which proves DNS, outbound 443, TLS and the load balancer
+    without opening a connector session or presenting any credential.
+    """
+    try:
+        parts = urlsplit(url)
+        scheme = {"wss": "https", "ws": "http"}.get(parts.scheme, parts.scheme)
+        if scheme not in ("https", "http") or not parts.hostname:
+            return False, "not a ws://, wss://, http:// or https:// URL"
+        if scheme == "https":
+            conn: http.client.HTTPConnection = http.client.HTTPSConnection(
+                parts.hostname, parts.port, timeout=timeout,
+                context=ssl.create_default_context(),
+            )
+        else:
+            conn = http.client.HTTPConnection(parts.hostname, parts.port, timeout=timeout)
+        try:
+            conn.request("GET", parts.path or "/",
+                         headers={"User-Agent": f"ghostai-connect-stub/{__version__}"})
+            status = conn.getresponse().status
+        finally:
+            conn.close()
+    except (OSError, ValueError, http.client.HTTPException) as exc:
+        return False, f"unreachable ({type(exc).__name__}: {exc})"
+    if status >= 500:
+        return False, f"the load balancer answered HTTP {status}; the relay is unavailable right now"
+    return True, (f"reachable (HTTP {status}; a plain HTTPS request to the "
+                  "WebSocket endpoint is expected to be refused)")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="ghostai-connect",
+        description="Placeholder for the GhostAI Connect client: explains how to "
+                    "get the real client and checks that the GhostAI relay is reachable.",
+    )
+    parser.add_argument(
+        "--version", action="version",
+        version=f"%(prog)s {__version__} (placeholder, not the GhostAI Connect client)",
+    )
+    parser.add_argument(
+        "--relay-url", default=os.environ.get("GHOSTAI_CONNECT_RELAY_URL", DEFAULT_RELAY_URL),
+        help="relay endpoint to check (default: $GHOSTAI_CONNECT_RELAY_URL or %(default)s)",
+    )
+    parser.add_argument("--timeout", type=float, default=5.0,
+                        help="seconds to wait for the relay (default: %(default)s)")
+    parser.add_argument("--no-check", action="store_true",
+                        help="skip the relay reachability check")
+    args, unsupported = parser.parse_known_args(argv)
+
+    print(HOW_TO_GET.format(version=__version__))
+    ok = True
+    if not args.no_check:
+        ok, detail = check_relay(args.relay_url, args.timeout)
+        print(f"Relay check: {args.relay_url}\n  {detail}")
+
+    if unsupported:
+        print(f"\n'ghostai-connect {' '.join(unsupported)}' is not available in this "
+              "placeholder. Install the real client (see above).", file=sys.stderr)
+        return 2
+    return 0 if ok else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

ghostai_connect-0.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+# Name-holding placeholder for the GhostAI Connect client. Contains none of the
+# client's code (ghostai_connect/), so the license below covers only
+# ghostai_connect_stub.py. The version stays 0.0.x so any real release
+# supersedes it; .github/workflows/publish-pypi-stub.yml refuses to upload
+# anything else.
+[project]
+name = "ghostai-connect"
+dynamic = ["version"]
+description = "Placeholder for the GhostAI Connect client: explains how to get it and checks that the GhostAI relay is reachable. Contains no client code."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.8"
+authors = [{ name = "GhostAI", email = "support@dymium.io" }]
+keywords = ["ghostai", "connector", "relay"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://ghostai.dymium.io"
+
+[project.scripts]
+ghostai-connect = "ghostai_connect_stub:main"
+
+[tool.setuptools]
+py-modules = ["ghostai_connect_stub"]
+
+[tool.setuptools.dynamic]
+version = { attr = "ghostai_connect_stub.__version__" }

ghostai_connect-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+