ohamlab-harness 0.1.0b1__tar.gz

ohamlab_harness-0.1.0b1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: ohamlab-harness
+Version: 0.1.0b1
+Summary: Installer and launcher for OhamLab DeepSeek Harness
+Author: OhamLab
+License: Proprietary - verify repository license before publication
+Keywords: agent,mcp,harness
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# OhamLab Harness CLI (beta)
+
+This Python package bootstraps the Node-based Harness and the OhamLab vendor integration from GitHub. Node.js 22, Git and pnpm are required. Install and run:
+
+```sh
+pip install -e packages/python
+# from any directory
+ohamlab-harness doctor
+ohamlab-harness install
+ohamlab-harness start
+```
+
+By default `install` clones the Harness `1.0` branch and overlays `vendor/ohamlab` from `main` of the same repository. Override the refs with `--harness-ref` and `--vendor-ref`; pin immutable commit SHAs for reproducible production installs. For a local vendor checkout, pass `--vendor-path /path/to/vendor/ohamlab`. The installer creates a separate Python virtual environment for gateway dependencies and uses a persistent data directory.
+
+The default Harness startup command is `pnpm dsh web`; confirm this against the selected Harness release. Override with `--start-command 'pnpm ...'` if needed. The launcher does not assert MCP registration automatically; use `doctor` and test actual tool calls in Harness.
+
+`start` serves the upstream web UI locally; it is not a cloud-hosted service or browser extension. Use `--open-browser` to open the local URL. Do not expose the UI to the public Internet without authentication and TLS.

ohamlab_harness-0.1.0b1/README.md

@@ -0,0 +1,17 @@
+# OhamLab Harness CLI (beta)
+
+This Python package bootstraps the Node-based Harness and the OhamLab vendor integration from GitHub. Node.js 22, Git and pnpm are required. Install and run:
+
+```sh
+pip install -e packages/python
+# from any directory
+ohamlab-harness doctor
+ohamlab-harness install
+ohamlab-harness start
+```
+
+By default `install` clones the Harness `1.0` branch and overlays `vendor/ohamlab` from `main` of the same repository. Override the refs with `--harness-ref` and `--vendor-ref`; pin immutable commit SHAs for reproducible production installs. For a local vendor checkout, pass `--vendor-path /path/to/vendor/ohamlab`. The installer creates a separate Python virtual environment for gateway dependencies and uses a persistent data directory.
+
+The default Harness startup command is `pnpm dsh web`; confirm this against the selected Harness release. Override with `--start-command 'pnpm ...'` if needed. The launcher does not assert MCP registration automatically; use `doctor` and test actual tool calls in Harness.
+
+`start` serves the upstream web UI locally; it is not a cloud-hosted service or browser extension. Use `--open-browser` to open the local URL. Do not expose the UI to the public Internet without authentication and TLS.

ohamlab_harness-0.1.0b1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ohamlab-harness"
+version = "0.1.0b1"
+description = "Installer and launcher for OhamLab DeepSeek Harness"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "Proprietary - verify repository license before publication"}
+authors = [{name = "OhamLab"}]
+keywords = ["agent", "mcp", "harness"]
+classifiers = ["Development Status :: 4 - Beta", "Programming Language :: Python :: 3", "Operating System :: OS Independent"]
+
+[project.scripts]
+ohamlab-harness = "ohamlab_harness.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

ohamlab_harness-0.1.0b1/setup.cfg

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

ohamlab_harness-0.1.0b1/src/ohamlab_harness/__init__.py

@@ -0,0 +1,2 @@
+"""OhamLab Harness launcher."""
+__version__ = "0.1.0b1"

ohamlab_harness-0.1.0b1/src/ohamlab_harness/cli.py

@@ -0,0 +1,72 @@
+"""User-facing OhamLab Harness CLI."""
+from __future__ import annotations
+import argparse
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+from . import __version__
+from .installer import REPO_URL, InstallError, install, SKILLS
+from .runtime import start
+
+def default_home():
+    return Path(os.environ.get("OHAMLAB_HARNESS_HOME",str(Path.home()/".ohamlab-harness")))
+
+def doctor(home: Path):
+    print(f"OhamLab Harness {__version__}")
+    missing=[]
+    for exe in ("git","node","pnpm"):
+        path=shutil.which(exe)
+        print(f"{exe}: {path or 'MISSING'}")
+        if not path: missing.append(exe)
+    node=shutil.which("node")
+    if node:
+        version=subprocess.run([node,"--version"],capture_output=True,text=True,check=False).stdout.strip()
+        print("Node version:",version)
+        try:
+            if int(version.lstrip("v").split(".")[0])<22: missing.append("Node.js 22+")
+        except (ValueError,IndexError): missing.append("Node.js version unknown")
+    app=home/"app"
+    print("Harness checkout:", "OK" if (app/"package.json").is_file() else "NOT INSTALLED")
+    if not (app/"package.json").is_file(): missing.append("Harness checkout")
+    for skill in SKILLS:
+        exists=(home/"data"/"skills"/skill/"SKILL.md").is_file()
+        print(f"Skill {skill}:","OK" if exists else "MISSING")
+        if not exists: missing.append(skill)
+    py=home/"python-env"/("Scripts/python.exe" if os.name=="nt" else "bin/python")
+    print("Gateway Python:","OK" if py.is_file() else "MISSING")
+    if not py.is_file(): missing.append("Gateway Python")
+    print("MCP registration: NOT VERIFIED (requires live Harness test)")
+    return 1 if missing else 0
+
+def main(argv=None):
+    parser=argparse.ArgumentParser(prog="ohamlab-harness")
+    parser.add_argument("--version",action="version",version=__version__)
+    parser.add_argument("--home",type=Path,default=default_home(),help="Installation directory")
+    subs=parser.add_subparsers(dest="action",required=True)
+    setup=subs.add_parser("install",help="Fetch, build, and install Harness")
+    setup.add_argument("--repo-url",default=REPO_URL)
+    setup.add_argument("--harness-ref",default="1.0")
+    setup.add_argument("--vendor-ref",default="main")
+    setup.add_argument("--vendor-path",type=Path)
+    setup.add_argument("--skip-python",action="store_true")
+    subs.add_parser("doctor",help="Check runtime prerequisites and installed files")
+    run=subs.add_parser("start",help="Start local Harness web UI")
+    run.add_argument("--start-command",default=os.environ.get("OHAMLAB_HARNESS_START_CMD","pnpm dsh web"))
+    run.add_argument("--host",default="127.0.0.1")
+    run.add_argument("--port",type=int,default=3080)
+    run.add_argument("--open-browser",action="store_true")
+    args=parser.parse_args(argv)
+    try:
+        if args.action=="install":
+            install(args.home,repo_url=args.repo_url,harness_ref=args.harness_ref,vendor_ref=args.vendor_ref,vendor_path=args.vendor_path,skip_python=args.skip_python)
+            return 0
+        if args.action=="doctor": return doctor(args.home)
+        return start(args.home,command=args.start_command,host=args.host,port=args.port,open_browser=args.open_browser)
+    except (InstallError,OSError,subprocess.CalledProcessError) as exc:
+        print(f"[OHAMLAB] ERROR: {exc}",file=sys.stderr)
+        return 1
+
+if __name__=="__main__":
+    sys.exit(main())

ohamlab_harness-0.1.0b1/src/ohamlab_harness/installer.py

@@ -0,0 +1,85 @@
+"""Fetch and build an isolated Harness runtime, without modifying the source repository."""
+from __future__ import annotations
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+import venv
+
+REPO_URL = "https://github.com/innokria/ohamlab-deepseek-harness.git"
+SKILLS = ("web-search", "agent-lab", "research-workflow")
+
+class InstallError(RuntimeError):
+    pass
+
+def run(argv, *, cwd=None, env=None):
+    print("+", " ".join(map(str, argv)), flush=True)
+    subprocess.run([str(x) for x in argv], cwd=cwd, env=env, check=True)
+
+def require(binary):
+    found = shutil.which(binary)
+    if not found:
+        raise InstallError(f"Missing executable: {binary}. Install it and retry.")
+    return found
+
+def git_checkout(url: str, ref: str, destination: Path):
+    if destination.exists():
+        raise InstallError(f"Refusing to overwrite existing directory: {destination}")
+    run([require("git"), "clone", "--no-checkout", url, destination])
+    run(["git", "-C", destination, "checkout", ref])
+
+def install_skills(source: Path, target: Path):
+    target.mkdir(parents=True, exist_ok=True)
+    for skill in SKILLS:
+        src = source / skill
+        if not (src / "SKILL.md").is_file():
+            raise InstallError(f"Required skill missing: {src / 'SKILL.md'}")
+        shutil.copytree(src, target / skill, dirs_exist_ok=True)
+        print(f"[OHAMLAB] Installed skill: {skill}")
+
+def install(home: Path, *, repo_url: str=REPO_URL, harness_ref: str="1.0", vendor_ref: str="main", vendor_path: Path|None=None, skip_python: bool=False):
+    require("git"); require("node"); require("pnpm")
+    home = home.expanduser().resolve()
+    home.mkdir(parents=True, exist_ok=True)
+    app = home / "app"
+    if app.exists():
+        raise InstallError(f"Harness already installed at {app}. Remove it manually to reinstall; no automatic overwrite.")
+    git_checkout(repo_url, harness_ref, app)
+    if not (app / "package.json").is_file():
+        raise InstallError("Selected Harness ref has no package.json at repository root")
+    vendor_dest = app / "vendor" / "ohamlab"
+    if vendor_path:
+        vendor_src = vendor_path.expanduser().resolve()
+        if not vendor_src.is_dir():
+            raise InstallError(f"Vendor directory missing: {vendor_src}")
+    else:
+        vendor_repo = home / "vendor-checkout"
+        git_checkout(repo_url, vendor_ref, vendor_repo)
+        vendor_src = vendor_repo / "vendor" / "ohamlab"
+        if not vendor_src.is_dir():
+            raise InstallError(f"Vendor integration missing: {vendor_src}")
+    vendor_dest.parent.mkdir(parents=True,exist_ok=True)
+    if vendor_dest.exists():
+        shutil.rmtree(vendor_dest)
+    shutil.copytree(vendor_src,vendor_dest)
+    if not vendor_path:
+        shutil.rmtree(home / "vendor-checkout")
+    requirements = vendor_dest / "gateway" / "requirements.txt"
+    if not requirements.is_file():
+        raise InstallError(f"Gateway requirements missing: {requirements}")
+    run(["pnpm", "install", "--frozen-lockfile"],cwd=app)
+    run(["pnpm", "run", "build"],cwd=app)
+    branding = vendor_dest / "plugins" / "harness-brand"
+    if branding.is_dir():
+        run(["pnpm", "dsh", "plugin", "--profile", "web", "add", branding], cwd=app)
+    if not skip_python:
+        venv_dir=home / "python-env"
+        venv.EnvBuilder(with_pip=True).create(venv_dir)
+        python=venv_dir / ("Scripts/python.exe" if os.name=="nt" else "bin/python")
+        run([python,"-m","pip","install","-r",requirements])
+        run([python,"-m","pip","install","ohamlab-agent==0.1.2","ohamlab-agent-lab==7.0.0"])
+    install_skills(vendor_dest / "skills", home / "data" / "skills")
+    print(f"[OHAMLAB] Installed into {home}")
+    print("[OHAMLAB] Next: ohamlab-harness doctor && ohamlab-harness start")
+    return app

ohamlab_harness-0.1.0b1/src/ohamlab_harness/runtime.py

@@ -0,0 +1,42 @@
+"""Run the upstream Harness web server with an isolated data directory."""
+from __future__ import annotations
+import os
+from pathlib import Path
+import shlex
+import subprocess
+import threading
+import time
+import urllib.request
+import webbrowser
+from .installer import InstallError
+
+def start(home: Path, *, command: str="pnpm dsh web", host: str="127.0.0.1", port: int=3080, open_browser: bool=False):
+    home=home.expanduser().resolve()
+    app=home/"app"
+    if not (app/"package.json").is_file():
+        raise InstallError(f"Harness not installed at {app}. Run 'ohamlab-harness install' first.")
+    if not (home/"data"/"skills"/"web-search"/"SKILL.md").is_file():
+        raise InstallError("OhamLab skills missing; rerun installation")
+    env=os.environ.copy()
+    env.update({"DSH_HOME":str(home/"data"),"DSH_HOST":host,"DSH_PORT":str(port),"PORT":str(port)})
+    venv_bin=home/"python-env"/("Scripts" if os.name=="nt" else "bin")
+    if venv_bin.is_dir():
+        env["PATH"]=str(venv_bin)+os.pathsep+env.get("PATH","")
+        env["OHAM_PYTHON"]=str(venv_bin/("python.exe" if os.name=="nt" else "python"))
+    argv=shlex.split(command,posix=os.name!="nt")
+    if not argv:
+        raise InstallError("Empty startup command")
+    url=f"http://{host}:{port}"
+    print(f"[OHAMLAB] Starting Harness at {url}",flush=True)
+    print("[OHAMLAB] MCP gateway registration must be configured and verified separately.",flush=True)
+    if open_browser:
+        def open_when_ready():
+            for _ in range(40):
+                try:
+                    with urllib.request.urlopen(url,timeout=1):
+                        webbrowser.open(url)
+                        return
+                except Exception:
+                    time.sleep(1)
+        threading.Thread(target=open_when_ready,daemon=True).start()
+    return subprocess.call(argv,cwd=app,env=env)

ohamlab_harness-0.1.0b1/src/ohamlab_harness.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: ohamlab-harness
+Version: 0.1.0b1
+Summary: Installer and launcher for OhamLab DeepSeek Harness
+Author: OhamLab
+License: Proprietary - verify repository license before publication
+Keywords: agent,mcp,harness
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# OhamLab Harness CLI (beta)
+
+This Python package bootstraps the Node-based Harness and the OhamLab vendor integration from GitHub. Node.js 22, Git and pnpm are required. Install and run:
+
+```sh
+pip install -e packages/python
+# from any directory
+ohamlab-harness doctor
+ohamlab-harness install
+ohamlab-harness start
+```
+
+By default `install` clones the Harness `1.0` branch and overlays `vendor/ohamlab` from `main` of the same repository. Override the refs with `--harness-ref` and `--vendor-ref`; pin immutable commit SHAs for reproducible production installs. For a local vendor checkout, pass `--vendor-path /path/to/vendor/ohamlab`. The installer creates a separate Python virtual environment for gateway dependencies and uses a persistent data directory.
+
+The default Harness startup command is `pnpm dsh web`; confirm this against the selected Harness release. Override with `--start-command 'pnpm ...'` if needed. The launcher does not assert MCP registration automatically; use `doctor` and test actual tool calls in Harness.
+
+`start` serves the upstream web UI locally; it is not a cloud-hosted service or browser extension. Use `--open-browser` to open the local URL. Do not expose the UI to the public Internet without authentication and TLS.

ohamlab_harness-0.1.0b1/src/ohamlab_harness.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/ohamlab_harness/__init__.py
+src/ohamlab_harness/cli.py
+src/ohamlab_harness/installer.py
+src/ohamlab_harness/runtime.py
+src/ohamlab_harness.egg-info/PKG-INFO
+src/ohamlab_harness.egg-info/SOURCES.txt
+src/ohamlab_harness.egg-info/dependency_links.txt
+src/ohamlab_harness.egg-info/entry_points.txt
+src/ohamlab_harness.egg-info/top_level.txt

ohamlab_harness-0.1.0b1/src/ohamlab_harness.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ohamlab_harness-0.1.0b1/src/ohamlab_harness.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ohamlab-harness = ohamlab_harness.cli:main

ohamlab_harness-0.1.0b1/src/ohamlab_harness.egg-info/top_level.txt

@@ -0,0 +1 @@
+ohamlab_harness