solvewright 0.1.0__py3-none-any.whl

solvewright/service.py

@@ -0,0 +1,52 @@
+"""HTTPS calls to Solvewright's account service. Nothing else leaves the machine."""
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from urllib.parse import urlparse
+
+from . import __version__
+
+
+class ServiceError(Exception):
+    """The service refused the request; retrying the same request will not help."""
+
+    def __init__(self, message: str, code: str | None = None):
+        super().__init__(message)
+        self.code = code
+
+
+class Unavailable(OSError):
+    """The network or the service is down; the same request can be retried."""
+
+
+class Service:
+    def __init__(self, url: str, key: str, timeout: float = 25):
+        parsed = urlparse(url)
+        local = parsed.scheme == "http" and parsed.hostname in ("127.0.0.1", "localhost")
+        if not key or not (parsed.scheme == "https" or local):
+            raise ValueError("The Solvewright service address must use HTTPS.")
+        self.url, self.key, self.timeout = url.rstrip("/"), key, timeout
+
+    def rpc(self, name: str, data: dict):
+        request = urllib.request.Request(
+            self.url + "/rest/v1/rpc/" + name,
+            data=json.dumps(data).encode("utf-8"),
+            headers={"apikey": self.key, "Content-Type": "application/json",
+                     "User-Agent": f"solvewright-connector/{__version__}"},
+        )
+        try:
+            with urllib.request.urlopen(request, timeout=self.timeout) as response:
+                content = response.read()
+                return json.loads(content) if content else None
+        except urllib.error.HTTPError as error:
+            if error.code >= 500 or error.code in (408, 429):
+                raise Unavailable("Solvewright is temporarily unavailable.") from error
+            try:
+                detail = json.loads(error.read().decode("utf-8"))
+            except (ValueError, UnicodeError):
+                detail = {}
+            raise ServiceError(detail.get("message") or "Solvewright refused the request.", detail.get("code")) from error
+        except (urllib.error.URLError, TimeoutError, ConnectionError) as error:
+            raise Unavailable("Could not reach Solvewright. Check the internet connection.") from error

solvewright/settings.py

@@ -0,0 +1,52 @@
+"""Where the connector talks to, and where it keeps its files.
+
+The service URL and key below are the same public values every visitor's
+browser already receives from solvewright.app: a publishable key that can only
+call the functions Solvewright exposes to anonymous clients. Row-level security
+and the per-computer key decide what any request can reach.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+
+SITE_URL = "https://solvewright.app"
+SERVICE_URL = "https://zqdxsgetwbeiwpjwjhzd.supabase.co"
+SERVICE_KEY = "sb_publishable_zhQrE__vhJ1W6Nr-DSDXBQ_slqYpYUq"
+
+
+@dataclass(frozen=True)
+class Settings:
+    site_url: str
+    service_url: str
+    service_key: str
+    home: Path
+
+    @property
+    def connection_file(self) -> Path:
+        return self.home / "connection.json"
+
+    @property
+    def interviews(self) -> Path:
+        return self.home / "interviews"
+
+
+def default_home() -> Path:
+    if sys.platform == "win32":
+        return Path(os.environ.get("LOCALAPPDATA") or Path.home() / "AppData" / "Local") / "Solvewright"
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / "Solvewright"
+    return Path(os.environ.get("XDG_DATA_HOME") or Path.home() / ".local" / "share") / "solvewright"
+
+
+def load(home: str | os.PathLike[str] | None = None) -> Settings:
+    """Environment variables exist for development against a local stack."""
+    chosen = Path(home or os.environ.get("SOLVEWRIGHT_HOME") or default_home()).expanduser().resolve()
+    return Settings(
+        site_url=os.environ.get("SOLVEWRIGHT_SITE_URL", SITE_URL).rstrip("/"),
+        service_url=os.environ.get("SOLVEWRIGHT_SERVICE_URL", SERVICE_URL).rstrip("/"),
+        service_key=os.environ.get("SOLVEWRIGHT_SERVICE_KEY", SERVICE_KEY),
+        home=chosen,
+    )

solvewright/worker.py

@@ -0,0 +1,159 @@
+"""The job loop: fetch the account's requests over HTTPS, answer them, repeat.
+
+This computer opens no port. Every request comes from the person's own signed-in
+Solvewright account through the service, and every request is one of the fixed
+operations below; there is no operation that runs an arbitrary command.
+"""
+from __future__ import annotations
+
+import re
+import sys
+import time
+import uuid
+
+from . import __version__, agents
+from .service import ServiceError, Unavailable
+
+ROUND = re.compile(r"/sessions/([a-f0-9-]{36})(?:/(message|files|test-runs|interrupt))?")
+ACTIVE_SECONDS, ACTIVE_POLL, IDLE_POLL = 180, 1.0, 4.0
+
+
+class Revoked(Exception):
+    """This computer was disconnected from the account; its key no longer works."""
+
+
+def health(runtime, models=False) -> dict:
+    described = agents.describe()
+    for name, info in described.items():
+        if info["available"]:
+            info["isolation"] = runtime.isolation.get(name, info["isolation"])
+    if models:
+        if described["claude"]["available"]:
+            described["claude"]["models"] = agents.CLAUDE_MODELS
+            described["claude"]["efforts"] = agents.CLAUDE_EFFORTS
+        if described["codex"]["available"]:
+            try:
+                described["codex"]["models"] = runtime.codex_models()
+            except (OSError, ValueError) as error:
+                described["codex"]["modelsError"] = str(error)[:300]
+    return {"version": 2, "connector": __version__, "agents": described,
+            # Kept for pages built before version 2.
+            "providers": {name: info["available"] for name, info in described.items()},
+            "dataDirectory": str(runtime.root)}
+
+
+def dispatch(runtime, owner: str, path: str, body):
+    if body is not None and not isinstance(body, dict):
+        raise ValueError("Invalid interview request.")
+    if path == "/health" and body is None:
+        return health(runtime, models=True)
+    if path == "/sync":
+        if body is None:
+            return runtime.export_sync(owner)
+        if body.get("operation") == "manifest":
+            return runtime.export_sync(owner, metadata=True)
+        if body.get("operation") == "export":
+            if not isinstance(body.get("ids"), list):
+                raise ValueError("Choose which rounds to export.")
+            return runtime.export_sync(owner, ids=body["ids"])
+        if body.get("operation") is not None:
+            raise ValueError("Unknown account history operation.")
+        return runtime.import_sync(owner, body)
+    if path == "/sessions":
+        return {"sessions": runtime.sessions(owner)} if body is None else runtime.create(owner, body)
+    match = ROUND.fullmatch(path)
+    if not match:
+        raise ValueError("Unknown interview operation.")
+    session_id, operation = match.groups()
+    if body is None and operation is None:
+        return runtime.public(owner, runtime.load(owner, session_id), True)
+    if body is None:
+        raise ValueError("This interview operation needs a request body.")
+    if operation == "message":
+        message = body.get("message", "")
+        if not isinstance(message, str) or not message.strip() or len(message) > 30_000:
+            raise ValueError("Send a message of at most 30,000 characters.")
+        runtime.start_turn(owner, session_id, message, remark=body.get("remark") is True)
+        return {"ok": True}
+    if operation == "files":
+        runtime.save_files(owner, session_id, body.get("files"))
+        return {"ok": True}
+    if operation == "test-runs":
+        return runtime.record_test_run(owner, session_id, body.get("files"), body.get("run"))
+    if operation == "interrupt":
+        runtime.interrupt(owner, session_id)
+        return {"ok": True}
+    raise ValueError("Unsupported interview operation.")
+
+
+def describe_job(path: str, body) -> str | None:
+    """One line for the terminal, without the request's content."""
+    if path == "/sessions" and body is not None:
+        return None  # The runtime announces the new round itself.
+    match = ROUND.fullmatch(path)
+    operation = match.group(2) if match else None
+    return {"files": "Saved your code", "interrupt": "Stopped the interviewer"}.get(operation)
+
+
+def details(runtime) -> dict:
+    return {"connector": __version__, "agents": {name: {"version": info["version"], "isolation": info["isolation"]}
+                                                 for name, info in health(runtime)["agents"].items() if info["available"]}}
+
+
+def run(runtime, service, credentials: dict, say=print, sleep=time.sleep, clock=time.monotonic) -> None:
+    identity = {"p_worker_id": credentials["workerId"], "p_key": credentials["key"], "p_instance_id": str(uuid.uuid4())}
+    last_job = clock()
+    announced = None
+    started = clock()
+    try:
+        while True:
+            try:
+                jobs = service.rpc("next_interview_jobs", {**identity, "p_details": details(runtime)})
+            except Unavailable:
+                if announced != "offline":
+                    say("Connection interrupted; retrying until Solvewright answers…")
+                    announced = "offline"
+                sleep(3)
+                continue
+            except ServiceError as error:
+                if error.code == "42501":
+                    raise Revoked() from error
+                # A connector that was killed rather than closed still counts as running for 30 s.
+                if error.code == "PT409" and clock() - started < 45:
+                    if announced != "waiting":
+                        say("An earlier connector on this computer is still marked as running; waiting for it to time out…")
+                        announced = "waiting"
+                    sleep(5)
+                    continue
+                raise
+            if announced in ("offline", "waiting"):
+                say("Reconnected.")
+            announced = "online"
+            for job in jobs or []:
+                last_job = clock()
+                result, failure = None, None
+                try:
+                    result = dispatch(runtime, credentials["owner"], job["path"], job.get("body"))
+                    line = describe_job(job["path"], job.get("body"))
+                    if line:
+                        say(line)
+                except (ValueError, KeyError, TypeError, OSError) as error:
+                    failure = str(error) or "The request failed."
+                # Retrying delivery never repeats the operation itself.
+                while True:
+                    try:
+                        service.rpc("complete_interview_job", {**identity, "p_id": job["id"], "p_result": result, "p_error": failure})
+                        break
+                    except Unavailable:
+                        sleep(3)
+            if not jobs:
+                sleep(ACTIVE_POLL if clock() - last_job < ACTIVE_SECONDS else IDLE_POLL)
+    finally:
+        try:
+            service.rpc("disconnect_interview_worker", identity)
+        except (OSError, ServiceError):
+            pass
+
+
+def stderr(text: str) -> None:
+    print(text, file=sys.stderr, flush=True)

solvewright-0.1.0.dist-info/METADATA

@@ -0,0 +1,132 @@
+Metadata-Version: 2.5
+Name: solvewright
+Version: 0.1.0
+Summary: Connect your own Claude Code or Codex to Solvewright Interview Lab for mock technical interviews.
+Project-URL: Homepage, https://solvewright.app/coding/interviews
+Project-URL: Source, https://github.com/fus3r/solvewright-connector
+Project-URL: Privacy, https://solvewright.app/privacy#privacy-interviews
+Author: Riad Darwish
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude code,codex,interview,mock interview,practice
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Education
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Solvewright connector
+
+Practise live technical interviews in [Solvewright Interview Lab](https://solvewright.app/coding/interviews)
+with the Claude Code or Codex you already use. The interviewer runs on your computer, under your own
+sign-in and plan. Solvewright provides the room: the problem, the editor, the tests, the conversation,
+your history and your skill profile.
+
+```sh
+uvx solvewright
+```
+
+No uv? `pipx run solvewright` works the same way, or `python3 -m pip install --user solvewright` and
+then `solvewright`. Python 3.10 or newer. The package has no dependencies.
+
+## What happens when you run it
+
+1. The terminal lists this computer, the agents it found and where interviews are kept.
+2. It prints a short code and opens `solvewright.app/connect`. Check that the page shows the same
+   code, then press **Connect this computer**. You must be signed in to Solvewright.
+3. The terminal says which account it joined. Keep the window open while you practise; it prints one
+   line for each thing it does (a round prepared, a reply, tests recorded).
+4. Press Ctrl+C to stop. Nothing keeps running in the background, and nothing starts again by itself.
+
+Next time, `solvewright` reconnects without a new code. `solvewright disconnect` removes this
+computer from your account; you can also remove it from Interview Lab, which stops its key at once.
+
+| Command | Does |
+| --- | --- |
+| `solvewright` | Connect if needed, then wait for rounds |
+| `solvewright connect` | Approve this computer again, with a new key |
+| `solvewright status` | Show the connection and the agents found here |
+| `solvewright disconnect` | Remove this computer from your account |
+| `solvewright doctor` | Check Python, Claude Code, Codex and the sandbox |
+
+## What it can and cannot do
+
+The connector is deliberately small. Every request it accepts is one of a fixed list: report its
+status, start a round, pass your message to the interviewer, save your files, record a test result,
+stop the interviewer, and sync your history. There is no request that runs a command.
+
+- **It opens no port.** It connects out to Solvewright over HTTPS and asks for work.
+- **It only takes requests from your account.** This computer's key is issued after you approve it
+  in the browser, is stored only here (`connection.json`, readable by you alone), and the service
+  keeps a hash of it.
+- **It never sees your Claude or ChatGPT credentials.** It starts the official `claude` or `codex`
+  program, unmodified, which signs in the way it always does. Usage counts against your own plan.
+- **It never runs your code.** Public tests run in your browser, in Pyodide (Python compiled to
+  WebAssembly). The connector only stores the files you tested and the result.
+- **It does not update itself.** What runs is the version you installed from PyPI. The interviewer's
+  instructions ship inside the package (`src/solvewright/interviewer/`), so you can read exactly what
+  your agent is told.
+
+### The interviewer's sandbox
+
+The interviewer writes the problem and checks its own reference solution, so it needs to run code.
+It does that inside its own agent's sandbox, confined to the folder of the current round:
+
+| | Commands | Files | Network |
+| --- | --- | --- | --- |
+| Claude Code, macOS and Linux | Claude Code's OS sandbox | Read and write only in the round folder; the rest of your home folder is unreadable | None |
+| Codex, macOS and Linux | Codex's sandbox with a Solvewright permission profile | Read and write in your interview folders; the rest of your home folder is unreadable | None |
+| Claude Code, native Windows | No command tool at all: its sandbox needs macOS, Linux or WSL2 | The file tools stay in the round folder | None |
+
+Claude Code runs with `--restricted --safe-mode --strict-mcp-config`: your own CLAUDE.md, hooks,
+plugins and MCP servers are not loaded. Codex runs through its documented app-server with its plugins,
+apps, hooks, web search, memories and every MCP server you configured switched off for the interview.
+If a platform cannot provide one of these limits, the connector removes the capability rather than the
+limit, and says so in the terminal and in Interview Lab. On Linux, Claude Code's sandbox needs
+`bubblewrap` and `socat`.
+
+## What is stored where
+
+On this computer, in one folder (`solvewright status` prints it):
+
+| System | Folder |
+| --- | --- |
+| macOS | `~/Library/Application Support/Solvewright` |
+| Windows | `%LOCALAPPDATA%\Solvewright` |
+| Linux | `$XDG_DATA_HOME/solvewright`, by default `~/.local/share/solvewright` |
+
+Each round is a folder holding the candidate files, the interviewer's private files, snapshots of
+what you submitted, and the conversation. When you are signed in, Interview Lab also keeps a copy in
+your Solvewright account so you can continue on another computer; deleting your account deletes it.
+Your agent sends what it reads to its own provider (Anthropic or OpenAI) under your account's terms,
+as it does in any other session. Details: [solvewright.app/privacy](https://solvewright.app/privacy#privacy-interviews).
+
+## Read the code
+
+About 1,800 lines of Python in `src/solvewright/`:
+
+| File | Role |
+| --- | --- |
+| `cli.py` | The commands and everything the terminal prints |
+| `connection.py` | The browser approval and the saved key |
+| `service.py` | The only network calls: HTTPS to Solvewright's account service |
+| `worker.py` | The fixed list of requests and the loop that fetches them |
+| `agents.py` | How Claude Code and Codex are started, and their sandbox settings |
+| `runtime.py` | Rounds on disk, account-history sync, the interviewer's turns |
+| `interviewer/` | The instructions and references the interviewer reads |
+
+The account service address and its publishable key are in `settings.py`. They are the same public
+values every visitor's browser receives from solvewright.app.
+
+Run the tests from this folder with `PYTHONPATH=src python -m unittest discover -s tests` (on Windows, set `PYTHONPATH=src` first).
+
+## Licence
+
+MIT. Solvewright is not affiliated with Anthropic or OpenAI. Claude Code and Codex are their
+respective owners' products; this program runs the versions you installed.

solvewright-0.1.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+solvewright/__init__.py,sha256=2AO3NySPLVN1hawJTBPPdzm8teKtYdHkCpZ2PTSjWJk,106
+solvewright/__main__.py,sha256=k1ocEWawweo1qCJWNFAAvyxz3tcY13dzvCenHszij30,48
+solvewright/agents.py,sha256=xw1efno_Dxm7JcZQH99HWpY18zfZ2w2HmJVrl7cWgSU,21959
+solvewright/cli.py,sha256=7TS9PDeAA9yDCzzMFKbuM6ZkqkbI3btGsuD5tPds-sc,11234
+solvewright/connection.py,sha256=93GzPwVSBkPGusDkEj-XkYsSXeRDvLPcx2z_3Tjjbcg,4626
+solvewright/runtime.py,sha256=UwPJqsR-DpIOuO6iGpyINuLQovXiTgY3Ulf2SgAnbLA,42397
+solvewright/service.py,sha256=YZdug-euCS80lk0OvDOc7JSSukjlTtozp4To0JNTc8Y,2216
+solvewright/settings.py,sha256=N2DVOloCRduej-b81Jui-X0i7kgoKRq9qYxHwTUCPlM,1858
+solvewright/worker.py,sha256=cN6WwazsiqkzAYKVhJsc6X7HBgxnS7zrngTJwzg03m4,7102
+solvewright/interviewer/interviewer.txt,sha256=TwL0Mel-PW2VXZYue9T36v7y-tS2x48x-Q-rJJ7rDSA,13747
+solvewright/interviewer/cases/portals/brief.txt,sha256=iD_Hrh8pAuzTR62I_W56KaP_CcgruW_WZrOPdyDp_Ok,1869
+solvewright/interviewer/cases/portals/interviewer.txt,sha256=EeApJ2ZgIG2vlmjWzaxqT2KSSn4XiLfu9gns68yGwmM,6834
+solvewright/interviewer/cases/portals/reported-round.txt,sha256=XRG1kiJVFlKBIPHtnf9MT2cUFMTJzh4gbDq4d0R11fQ,3290
+solvewright/interviewer/data/portal-samples/sample-01.json,sha256=8CEaVoZhRuPW9b0tAJpBoR5KAcDTvLVj6mPAUlmMbiE,13857
+solvewright/interviewer/data/portal-samples/sample-02.json,sha256=2EzFEoI3kC6cppWJiFu8mOcGOzxlEuIj8lqsYeIalLg,13737
+solvewright/interviewer/data/portal-samples/sample-03.json,sha256=0Mj28_Esd-ktq3BG28SGfDeWsS8dbiY-S7DyCf5ocSc,13495
+solvewright/interviewer/data/portal-samples/sample-04.json,sha256=nYFy0bwGlIEQuk1_4Y2neanKapdXoMODcU1T2q8OoLw,13987
+solvewright/interviewer/data/portal-samples/sample-05.json,sha256=5_MD8LVX3REfffkYdol1m4uatqQ3Jesl0-st5NcA-fg,13893
+solvewright/interviewer/data/portal-samples/sample-06.json,sha256=IFUf2ZgtUtPHAJlpB_0s9otNOfHCNOjpmBCL7RcwME4,13782
+solvewright/interviewer/data/portal-samples/sample-07.json,sha256=P636q5FmaBqDz3GMplO1vfJxH3no4meQORyDpfAw9FE,13565
+solvewright/interviewer/data/portal-samples/sample-08.json,sha256=jefyq-F7LaMFiPxMMSS7pWH8sBnISLSNfhTQb7IGK2Q,13643
+solvewright/interviewer/references/case-generation.txt,sha256=PuFv0T0G99ZcxHGN0YbBKEKJOyNhqMNgAfuH7sbdM74,7808
+solvewright/interviewer/references/curriculum.txt,sha256=17ch-6p0R4ok3YUZSRPSZR7-QIhCJWMo_dp7JwtfFGI,3112
+solvewright/interviewer/references/scoring.txt,sha256=hyiw_XY3r8bzQhfhwnCHfYlyeSMmdRwlg-NgIzB6jNc,6438
+solvewright/interviewer/references/session-format.txt,sha256=DRAdjNWNnzOQgbNIwpjdIbkh0gYQ9HapjGpT4dGK1g8,4528
+solvewright/interviewer/tools/portal_lab.py,sha256=c7lNDFMvZVi7KRXv42zyP5Sc5llvqsnsUb9tQDMf-xc,9088
+solvewright-0.1.0.dist-info/METADATA,sha256=A3Ruj_abXbEqVOWRahRCD37Whw-ZEEqMxfod9O1RZCQ,7129
+solvewright-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+solvewright-0.1.0.dist-info/entry_points.txt,sha256=YL71CWedKPiXyPioNc3tYor2wo38z_wQN0JU9VTcTU8,53
+solvewright-0.1.0.dist-info/licenses/LICENSE,sha256=FtM09nZcmb027gl4INBvq59AZFWKrCdO9D-dwwUKufg,1069
+solvewright-0.1.0.dist-info/RECORD,,

solvewright-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

solvewright-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+solvewright = solvewright.cli:main

solvewright-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Riad Darwish
+
+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.