stem-agent 0.1.0__py3-none-any.whl

stem_agent-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: stem-agent
+Version: 0.1.0
+Summary: One complete scientific toolkit for coding agents, with verifiable workflows.
+Author: Exergy Lab
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://exergy-lab.com
+Project-URL: Product, https://exergy-lab.com/products
+Project-URL: Support, https://exergy-lab.com/contact
+Keywords: science,engineering,mathematics,mcp,coding-agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+License-File: THIRD_PARTY_NOTICES.txt
+Dynamic: license-file
+
+# STEM Agent Free
+
+STEM Agent gives the coding agent you already use one complete scientific
+toolkit, checked workflows, and a simple way to add specialized tools later.
+The Free Alpha installs 40 standard scientific components and keeps calculated
+results separate from independent verifier receipts.
+
+STEM Agent is free to download and use. It remains proprietary software and is
+not open source.
+
+## Install
+
+You need Python 3.12 and `pipx`. Then run:
+
+```text
+pipx run stem-agent
+```
+
+The installer verifies its embedded release bundle, creates separate worker
+and verifier environments, checks all 40 components, runs a verified demo, and
+creates a tested connection for each of the 15 coding agents listed on the
+Exergy Lab home page.
+
+Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, Qwen Code, Prime-Agent,
+Grok Build, Kimi Code, and Hermes Agent connect automatically when their CLI is
+installed. OpenCode, DeepSeek Harness, MiniMax Code, and NAC receive exact
+native configuration files without overwriting existing settings. Apodex Agent
+Harness and Exoharness use the same installed tools through the stable local
+command line because their current releases do not expose MCP clients.
+
+The release workflow tests Windows 11 x64, Ubuntu 24.04 x64, and macOS 12 or
+newer on both Apple Silicon and Intel before the package can publish.
+
+No telemetry is sent. Use the local support and feedback commands to create an
+inspectable, privacy-safe report that you choose whether to share.
+
+Support: https://exergy-lab.com/contact

stem_agent-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+stem_agent-0.1.0.dist-info/licenses/LICENSE.txt,sha256=5padhjtfEtqGR0fq5Y33448N6gR_160IhoeYy6UIOpo,1346
+stem_agent-0.1.0.dist-info/licenses/THIRD_PARTY_NOTICES.txt,sha256=vZ0pMLVAsX7IaCke9saIPpYGUtfCvGhr38G-QtdpGis,884
+stem_agent_installer/__init__.py,sha256=qBsM-405d36VSWUvn0irWSlAKbGwYc17YIW3EvnaVns,72
+stem_agent_installer/__main__.py,sha256=PSQ4rpL0dG6f-qH4N7H-gD9igQkdHzH4yVZDcW8lfZo,80
+stem_agent_installer/cli.py,sha256=AT3mIzdiwdbVmi_6TWicTkuEzXJ83iQfTTMUItGFc5E,8975
+stem_agent_installer/payload/payload.json,sha256=hA1AxL5x1kEG97-VbDCrIK0-QbAX83MD4tpytul2UXI,462
+stem_agent_installer/payload/stem-agent-0.1.0-free-alpha.zip,sha256=-RsEjW8D81EDnQ0ls5IGRV8DhG4tvGnio9dBHHmTZxU,196192
+stem_agent-0.1.0.dist-info/METADATA,sha256=k4lS0OKyn0igm5EXd1yGEzB58xJdHnLfsrZxB8EOtMU,2562
+stem_agent-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+stem_agent-0.1.0.dist-info/entry_points.txt,sha256=30QpUE4BxwW0Yhm9LRBMjne0qPaSk3l1zkWmptqQs6U,112
+stem_agent-0.1.0.dist-info/top_level.txt,sha256=GNdXKc_nMm3W4J6hGID7n7q_AoB9_HVN0LRq7LX0Wuo,21
+stem_agent-0.1.0.dist-info/RECORD,,

stem_agent-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

stem_agent-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+stem-agent = stem_agent_installer.cli:main
+stem-agent-install = stem_agent_installer.cli:main

stem_agent-0.1.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,26 @@
+STEM Agent Free Alpha Proprietary License
+
+Copyright (c) 2026 Exergy Lab. All rights reserved.
+
+STEM Agent is proprietary software. It is free to download and use under this
+license, but it is not open source.
+
+Exergy Lab grants each person or organization that obtains STEM Agent from an
+authorized Exergy Lab distribution channel a non-exclusive, non-transferable,
+revocable license to install and use the Free Alpha for personal, research,
+educational, and internal business purposes at no charge.
+
+You may not redistribute, sublicense, sell, rent, host for third parties,
+publish, or create derivative works from STEM Agent, except with prior written
+permission from Exergy Lab. You may not remove proprietary notices. Where a
+restriction is prohibited by applicable law, it applies only to the maximum
+extent permitted by that law.
+
+STEM Agent is pre-release software. It is provided "as is", without warranties
+or fitness guarantees. Outputs and verifier receipts are evidence about the
+checks that were actually run; they are not a warranty of scientific truth or
+authorization to rely on the software as the sole authority for safety-critical,
+regulated, or consequential decisions.
+
+Third-party software installed for use with STEM Agent remains subject to its
+own license terms. This license neither replaces nor restricts those terms.

stem_agent-0.1.0.dist-info/licenses/THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,16 @@
+Third-party software notice
+
+The STEM Agent bootstrap wheel contains Exergy Lab software and an Exergy Lab
+release bundle. It does not embed the third-party scientific distribution
+archives. During setup, the installer downloads a hash-locked dependency set
+from the Python Package Index and installs it into the local worker runtime.
+
+Each third-party component remains subject to its own license. The installed
+license and notice files are retained in that component's Python distribution
+metadata. The complete, versioned dependency set is recorded in the release
+bundle's requirements lock and in the installation doctor report.
+
+The 40 direct scientific components and the MCP runtime are declared in the
+embedded STEM Agent product wheel. Transitive components are included in the
+hash-locked requirements file. Exergy Lab does not claim ownership of any
+third-party component.

stem_agent-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+stem_agent_installer

stem_agent_installer/__init__.py

@@ -0,0 +1,3 @@
+"""Public PyPI bootstrap for STEM Agent Free."""
+
+__version__ = "0.1.0"

stem_agent_installer/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

stem_agent_installer/cli.py

@@ -0,0 +1,217 @@
+"""Verify and install the public STEM Agent Free Alpha bundle."""
+
+from __future__ import annotations
+
+import argparse
+from hashlib import sha256
+from importlib import resources
+import json
+import os
+from pathlib import Path, PurePosixPath
+import shutil
+import subprocess
+import sys
+import tempfile
+from typing import Any
+import zipfile
+
+
+PAYLOAD_SCHEMA = "stem-agent-public-pypi-installer-payload/1"
+BUNDLE_SCHEMA = "stem-agent-product-bundle-manifest/2"
+DISTRIBUTION_CHANNEL = "PUBLIC_FREE_ALPHA"
+
+
+def _file_sha256(path: Path) -> str:
+    digest = sha256()
+    with path.open("rb") as handle:
+        while chunk := handle.read(1024 * 1024):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def _safe_members(archive: zipfile.ZipFile, destination: Path) -> None:
+    resolved_destination = destination.resolve()
+    for member in archive.infolist():
+        normalized = member.filename.replace("\\", "/")
+        relative = PurePosixPath(normalized)
+        if (
+            relative.is_absolute()
+            or ".." in relative.parts
+            or not relative.parts
+            or relative.parts[0].endswith(":")
+        ):
+            raise RuntimeError("the embedded STEM Agent bundle contains an unsafe path")
+        target = resolved_destination.joinpath(*relative.parts).resolve()
+        if target != resolved_destination and resolved_destination not in target.parents:
+            raise RuntimeError("the embedded STEM Agent bundle contains an unsafe path")
+
+
+def _verify_and_extract(
+    archive_path: Path, record: dict[str, Any], destination: Path
+) -> dict[str, Any]:
+    if record.get("schema_version") != PAYLOAD_SCHEMA:
+        raise RuntimeError("the PyPI installer payload record is not recognized")
+    expected_name = record.get("bundle_filename")
+    if archive_path.name != expected_name:
+        raise RuntimeError("the embedded STEM Agent bundle name does not match its record")
+    observed_hash = _file_sha256(archive_path)
+    if observed_hash != record.get("bundle_sha256"):
+        raise RuntimeError("the embedded STEM Agent bundle failed its SHA-256 check")
+    if record.get("distribution_channel") != DISTRIBUTION_CHANNEL:
+        raise RuntimeError("the public Free Alpha distribution channel is missing")
+    if record.get("public_pypi_upload_allowed") is not True:
+        raise RuntimeError("the owner-authorized public PyPI boundary is missing")
+    if record.get("owner_authorized_public_distribution") is not True:
+        raise RuntimeError("public distribution has not been authorized")
+    if record.get("release_promoted") is not False:
+        raise RuntimeError("an unrecognized release state was supplied")
+
+    destination.mkdir(parents=True, exist_ok=False)
+    with zipfile.ZipFile(archive_path) as archive:
+        _safe_members(archive, destination)
+        archive.extractall(destination)
+
+    manifest_path = destination / "manifest.json"
+    if not manifest_path.is_file():
+        raise RuntimeError("the embedded STEM Agent bundle has no manifest")
+    manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
+    if (
+        manifest.get("schema_version") != BUNDLE_SCHEMA
+        or manifest.get("product") != "STEM Agent"
+        or manifest.get("distribution_channel") != DISTRIBUTION_CHANNEL
+        or manifest.get("license") != "PROPRIETARY_FREE_ALPHA"
+        or manifest.get("supported_harness_count") != 15
+        or manifest.get("redistribution_authorized") is not True
+        or manifest.get("release_promoted") is not False
+    ):
+        raise RuntimeError("the embedded bundle is not the public STEM Agent Free Alpha")
+
+    verified_artifacts = 0
+    for artifact in manifest.get("artifacts", []):
+        relative = PurePosixPath(str(artifact.get("relative_path", "")))
+        if relative.is_absolute() or ".." in relative.parts or not relative.parts:
+            raise RuntimeError("the embedded bundle manifest contains an unsafe artifact path")
+        artifact_path = destination.joinpath(*relative.parts)
+        if not artifact_path.is_file():
+            raise RuntimeError("the embedded STEM Agent bundle is incomplete")
+        if artifact_path.stat().st_size != artifact.get("size_bytes"):
+            raise RuntimeError("an embedded STEM Agent artifact has the wrong size")
+        if _file_sha256(artifact_path) != artifact.get("sha256"):
+            raise RuntimeError("an embedded STEM Agent artifact failed its SHA-256 check")
+        verified_artifacts += 1
+
+    if verified_artifacts == 0:
+        raise RuntimeError("the embedded STEM Agent bundle contains no recorded artifacts")
+    return {
+        "schema_version": "stem-agent-public-pypi-installer-verification/1",
+        "outcome": "VERIFIED",
+        "product": "STEM Agent",
+        "product_version": manifest["version"],
+        "distribution_channel": DISTRIBUTION_CHANNEL,
+        "bundle_sha256": observed_hash,
+        "manifest_sha256": _file_sha256(manifest_path),
+        "verified_artifact_count": verified_artifacts,
+        "supported_harness_count": 15,
+        "public_pypi_upload_allowed": True,
+        "owner_authorized_public_distribution": True,
+        "release_promoted": False,
+        "local_paths_included": False,
+        "credential_material_included": False,
+    }
+
+
+def _python_312_command() -> list[str]:
+    configured = os.environ.get("STEM_AGENT_PYTHON")
+    candidates: list[list[str]] = []
+    if configured:
+        candidates.append([configured])
+    if sys.version_info[:2] == (3, 12):
+        candidates.append([sys.executable])
+    if os.name == "nt":
+        launcher = shutil.which("py")
+        if launcher:
+            candidates.append([launcher, "-3.12"])
+    else:
+        executable = shutil.which("python3.12")
+        if executable:
+            candidates.append([executable])
+
+    for candidate in candidates:
+        completed = subprocess.run(
+            [
+                *candidate,
+                "-c",
+                "import sys; raise SystemExit(0 if sys.version_info[:2] == (3, 12) else 1)",
+            ],
+            check=False,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+        if completed.returncode == 0:
+            return candidate
+    raise RuntimeError(
+        "Python 3.12 is required. Install it, then run this command again."
+    )
+
+
+def _installer_command(bundle_root: Path, arguments: argparse.Namespace) -> list[str]:
+    command = [*_python_312_command(), str(bundle_root / "install.py")]
+    if arguments.install_root is not None:
+        command.extend(["--install-root", str(arguments.install_root)])
+    for option in (
+        "skip_agent_registration",
+        "skip_codex_registration",
+        "skip_claude_registration",
+    ):
+        if getattr(arguments, option):
+            command.append("--" + option.replace("_", "-"))
+    return command
+
+
+def _parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="stem-agent",
+        description=(
+            "Install STEM Agent Free and connect it to supported coding agents."
+        ),
+    )
+    parser.add_argument("--install-root", type=Path)
+    parser.add_argument("--skip-agent-registration", action="store_true")
+    parser.add_argument("--skip-codex-registration", action="store_true")
+    parser.add_argument("--skip-claude-registration", action="store_true")
+    parser.add_argument(
+        "--verify-only",
+        action="store_true",
+        help="verify the embedded public release bundle without installing it",
+    )
+    parser.add_argument("--version", action="version", version="STEM Agent Free 0.1.0")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    arguments = _parser().parse_args(argv)
+    package_root = resources.files("stem_agent_installer")
+    payload_root = package_root.joinpath("payload")
+    record = json.loads(payload_root.joinpath("payload.json").read_text(encoding="utf-8"))
+    archive_resource = payload_root.joinpath(str(record.get("bundle_filename", "")))
+
+    try:
+        with resources.as_file(archive_resource) as archive_path:
+            with tempfile.TemporaryDirectory(prefix="stem-agent-install-") as temporary:
+                bundle_root = Path(temporary) / "bundle"
+                verification = _verify_and_extract(Path(archive_path), record, bundle_root)
+                if arguments.verify_only:
+                    print(json.dumps(verification, indent=2, sort_keys=True))
+                    return 0
+                print("Verified the STEM Agent Free package.")
+                completed = subprocess.run(
+                    _installer_command(bundle_root, arguments),
+                    check=False,
+                )
+                return completed.returncode
+    except (OSError, RuntimeError, ValueError, zipfile.BadZipFile) as error:
+        raise SystemExit(f"STEM Agent installation stopped safely: {error}") from error
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

stem_agent_installer/payload/payload.json

@@ -0,0 +1,12 @@
+{
+  "bundle_filename": "stem-agent-0.1.0-free-alpha.zip",
+  "bundle_sha256": "f91b048d6f03f351039d0d25b39206455f03846e2dbc69e2a3d7411c79936715",
+  "bundle_size_bytes": 196192,
+  "distribution_channel": "PUBLIC_FREE_ALPHA",
+  "owner_authorized_public_distribution": true,
+  "product": "STEM Agent",
+  "product_version": "0.1.0",
+  "public_pypi_upload_allowed": true,
+  "release_promoted": false,
+  "schema_version": "stem-agent-public-pypi-installer-payload/1"
+}