slopper 0.1.0__tar.gz

slopper-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: slopper
+Version: 0.1.0
+Summary: Run Claude Code and Codex agent sessions for Folio on your own machine.
+Keywords: agents,claude-code,codex,folio
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pycrdt>=0.12.0
+Requires-Dist: claude-agent-sdk<0.3,>=0.2.152
+Requires-Dist: openai-codex-cli-bin<0.157,>=0.156
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: websockets>=13.0
+Requires-Dist: pydantic-settings>=2.2.0
+Requires-Dist: python-json-logger>=2.0.0
+
+# slopper
+
+Run Folio agent sessions — Claude Code or Codex — on your own machine.
+
+`slopper` is the environment a Folio session runs in. It registers with your
+Folio server, picks up the sessions assigned to it, checks out the project's
+repositories into a workspace per session, and runs the agent there. Every
+tool call that needs your approval shows up in the session in Folio; the
+agent waits until you answer.
+
+Runs on **macOS** and **Linux**, Python 3.11+. Both agent CLIs are installed
+with the package.
+
+## Install
+
+```bash
+uv tool install slopper        # or: pipx install slopper
+```
+
+## Set up
+
+1. **Sign the agents in**, once per machine, as the user the service will run as:
+
+   ```bash
+   claude login                  # Claude Code
+   codex login                   # Codex (optional)
+   ```
+
+2. **Point it at Folio** with an API key from Folio's settings:
+
+   ```bash
+   slopper configure --server https://api.folio.example.com --token <api-key>
+   ```
+
+   This writes `~/.slopper/config.toml`, readable only by you.
+
+3. **Check everything**:
+
+   ```bash
+   slopper doctor
+   ```
+
+4. **Run it as a service** — started now, at every login, and again if it crashes:
+
+   ```bash
+   slopper service install
+   ```
+
+   - **macOS:** a LaunchAgent (`~/Library/LaunchAgents/slopper.plist`) in your
+     login session, so it can use the Claude login in your Keychain.
+     Logs: `~/Library/Logs/slopper/slopper.log`.
+   - **Linux:** a systemd user unit (`~/.config/systemd/user/slopper.service`).
+     Logs: `journalctl --user -u slopper`. To keep it running while you are
+     logged out (a headless machine): `sudo loginctl enable-linger $USER`.
+
+## Commands
+
+| Command | |
+|---|---|
+| `slopper configure` | Write `~/.slopper/config.toml` (`--server`, `--token`, `--env-id`, `--workspace`) |
+| `slopper doctor` | Check the config, the server, the key, git, and both agents' logins |
+| `slopper service install` · `uninstall` | Install or remove the service |
+| `slopper service start` · `stop` · `restart` · `status` | Control it |
+| `slopper service logs [-f]` | Show (or follow) its log |
+| `slopper run` | Run in the foreground instead of as a service |
+
+Only one environment runs per user account; a second `slopper run` refuses to
+start while the service is running.
+
+## Upgrade
+
+```bash
+uv tool upgrade slopper && slopper service restart
+```
+
+The service runs the installed interpreter by path, so it picks up the new
+version on restart — there is nothing to reinstall.
+
+## Configuration
+
+`~/.slopper/config.toml` holds the settings; environment variables of the
+same name override it.
+
+| Setting | Default | |
+|---|---|---|
+| `SLOPPER_SERVER_URL` | `http://localhost:8000` | Folio API |
+| `SLOPPER_TOKEN` | — | API key this environment registers with |
+| `SLOPPER_ENV_ID` | generated once, kept in `~/.slopper/identity.toml` | This machine's name in Folio. Must stay stable: sessions are bound to it |
+| `SLOPPER_WORKSPACE_ROOT` | `~/.slopper/workspaces` | One directory per session |
+| `SLOPPER_CLONE_SINCE` | `1.month.ago` | How much git history a checkout carries; empty for all |
+| `SLOPPER_CODEX_BIN` | the bundled one | A different `codex` binary |

slopper-0.1.0/README.md

@@ -0,0 +1,91 @@
+# slopper
+
+Run Folio agent sessions — Claude Code or Codex — on your own machine.
+
+`slopper` is the environment a Folio session runs in. It registers with your
+Folio server, picks up the sessions assigned to it, checks out the project's
+repositories into a workspace per session, and runs the agent there. Every
+tool call that needs your approval shows up in the session in Folio; the
+agent waits until you answer.
+
+Runs on **macOS** and **Linux**, Python 3.11+. Both agent CLIs are installed
+with the package.
+
+## Install
+
+```bash
+uv tool install slopper        # or: pipx install slopper
+```
+
+## Set up
+
+1. **Sign the agents in**, once per machine, as the user the service will run as:
+
+   ```bash
+   claude login                  # Claude Code
+   codex login                   # Codex (optional)
+   ```
+
+2. **Point it at Folio** with an API key from Folio's settings:
+
+   ```bash
+   slopper configure --server https://api.folio.example.com --token <api-key>
+   ```
+
+   This writes `~/.slopper/config.toml`, readable only by you.
+
+3. **Check everything**:
+
+   ```bash
+   slopper doctor
+   ```
+
+4. **Run it as a service** — started now, at every login, and again if it crashes:
+
+   ```bash
+   slopper service install
+   ```
+
+   - **macOS:** a LaunchAgent (`~/Library/LaunchAgents/slopper.plist`) in your
+     login session, so it can use the Claude login in your Keychain.
+     Logs: `~/Library/Logs/slopper/slopper.log`.
+   - **Linux:** a systemd user unit (`~/.config/systemd/user/slopper.service`).
+     Logs: `journalctl --user -u slopper`. To keep it running while you are
+     logged out (a headless machine): `sudo loginctl enable-linger $USER`.
+
+## Commands
+
+| Command | |
+|---|---|
+| `slopper configure` | Write `~/.slopper/config.toml` (`--server`, `--token`, `--env-id`, `--workspace`) |
+| `slopper doctor` | Check the config, the server, the key, git, and both agents' logins |
+| `slopper service install` · `uninstall` | Install or remove the service |
+| `slopper service start` · `stop` · `restart` · `status` | Control it |
+| `slopper service logs [-f]` | Show (or follow) its log |
+| `slopper run` | Run in the foreground instead of as a service |
+
+Only one environment runs per user account; a second `slopper run` refuses to
+start while the service is running.
+
+## Upgrade
+
+```bash
+uv tool upgrade slopper && slopper service restart
+```
+
+The service runs the installed interpreter by path, so it picks up the new
+version on restart — there is nothing to reinstall.
+
+## Configuration
+
+`~/.slopper/config.toml` holds the settings; environment variables of the
+same name override it.
+
+| Setting | Default | |
+|---|---|---|
+| `SLOPPER_SERVER_URL` | `http://localhost:8000` | Folio API |
+| `SLOPPER_TOKEN` | — | API key this environment registers with |
+| `SLOPPER_ENV_ID` | generated once, kept in `~/.slopper/identity.toml` | This machine's name in Folio. Must stay stable: sessions are bound to it |
+| `SLOPPER_WORKSPACE_ROOT` | `~/.slopper/workspaces` | One directory per session |
+| `SLOPPER_CLONE_SINCE` | `1.month.ago` | How much git history a checkout carries; empty for all |
+| `SLOPPER_CODEX_BIN` | the bundled one | A different `codex` binary |

slopper-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "slopper"
+version = "0.1.0"
+description = "Run Claude Code and Codex agent sessions for Folio on your own machine."
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["agents", "claude-code", "codex", "folio"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "pycrdt>=0.12.0",
+    # Pinned to a range, not a floor. A floor alone let two machines install
+    # from the same wheel and get agents two minor versions apart -- one on
+    # CLI 2.1.30, the other on 2.1.259 -- which made behaviour on one
+    # impossible to reason about from the source of the other. 0.2.x is also
+    # the floor for PreToolUse "defer", which the approval flow depends on.
+    "claude-agent-sdk>=0.2.152,<0.3",
+    # Bundles the codex binary for Codex sessions. Pinned to one minor: the
+    # app-server protocol the Codex backend speaks is marked experimental,
+    # and a drift between machines would be as confusing as the CLI drift
+    # above.
+    "openai-codex-cli-bin>=0.156,<0.157",
+    "httpx>=0.28.0",
+    "websockets>=13.0",
+    # TomlConfigSettingsSource, for ~/.slopper/config.toml.
+    "pydantic-settings>=2.2.0",
+    "python-json-logger>=2.0.0",
+]
+
+[dependency-groups]
+dev = ["pytest>=8.0.0", "pytest-asyncio>=0.24.0"]
+
+[project.scripts]
+slopper = "slopper_env.cli:main"
+# The old name, kept for existing scripts: same flags, straight into `run`.
+slopper-env = "slopper_env.cli:run_alias"
+slopper-dev = "slopper_env.devtools:cli"
+
+# Named explicitly. Auto-discovery treated the old "src" directory as the
+# src-layout convention and flattened its modules to the top level of the
+# wheel -- installing "config", "main", "doc" and "sync" into site-packages,
+# where they shadow anything else by those names, while the console scripts
+# still pointed at a "src" package the wheel no longer contained.
+[tool.setuptools]
+packages = ["slopper_env", "slopper_env.adapters", "slopper_env.backends"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

slopper-0.1.0/setup.cfg

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

slopper-0.1.0/slopper.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: slopper
+Version: 0.1.0
+Summary: Run Claude Code and Codex agent sessions for Folio on your own machine.
+Keywords: agents,claude-code,codex,folio
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pycrdt>=0.12.0
+Requires-Dist: claude-agent-sdk<0.3,>=0.2.152
+Requires-Dist: openai-codex-cli-bin<0.157,>=0.156
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: websockets>=13.0
+Requires-Dist: pydantic-settings>=2.2.0
+Requires-Dist: python-json-logger>=2.0.0
+
+# slopper
+
+Run Folio agent sessions — Claude Code or Codex — on your own machine.
+
+`slopper` is the environment a Folio session runs in. It registers with your
+Folio server, picks up the sessions assigned to it, checks out the project's
+repositories into a workspace per session, and runs the agent there. Every
+tool call that needs your approval shows up in the session in Folio; the
+agent waits until you answer.
+
+Runs on **macOS** and **Linux**, Python 3.11+. Both agent CLIs are installed
+with the package.
+
+## Install
+
+```bash
+uv tool install slopper        # or: pipx install slopper
+```
+
+## Set up
+
+1. **Sign the agents in**, once per machine, as the user the service will run as:
+
+   ```bash
+   claude login                  # Claude Code
+   codex login                   # Codex (optional)
+   ```
+
+2. **Point it at Folio** with an API key from Folio's settings:
+
+   ```bash
+   slopper configure --server https://api.folio.example.com --token <api-key>
+   ```
+
+   This writes `~/.slopper/config.toml`, readable only by you.
+
+3. **Check everything**:
+
+   ```bash
+   slopper doctor
+   ```
+
+4. **Run it as a service** — started now, at every login, and again if it crashes:
+
+   ```bash
+   slopper service install
+   ```
+
+   - **macOS:** a LaunchAgent (`~/Library/LaunchAgents/slopper.plist`) in your
+     login session, so it can use the Claude login in your Keychain.
+     Logs: `~/Library/Logs/slopper/slopper.log`.
+   - **Linux:** a systemd user unit (`~/.config/systemd/user/slopper.service`).
+     Logs: `journalctl --user -u slopper`. To keep it running while you are
+     logged out (a headless machine): `sudo loginctl enable-linger $USER`.
+
+## Commands
+
+| Command | |
+|---|---|
+| `slopper configure` | Write `~/.slopper/config.toml` (`--server`, `--token`, `--env-id`, `--workspace`) |
+| `slopper doctor` | Check the config, the server, the key, git, and both agents' logins |
+| `slopper service install` · `uninstall` | Install or remove the service |
+| `slopper service start` · `stop` · `restart` · `status` | Control it |
+| `slopper service logs [-f]` | Show (or follow) its log |
+| `slopper run` | Run in the foreground instead of as a service |
+
+Only one environment runs per user account; a second `slopper run` refuses to
+start while the service is running.
+
+## Upgrade
+
+```bash
+uv tool upgrade slopper && slopper service restart
+```
+
+The service runs the installed interpreter by path, so it picks up the new
+version on restart — there is nothing to reinstall.
+
+## Configuration
+
+`~/.slopper/config.toml` holds the settings; environment variables of the
+same name override it.
+
+| Setting | Default | |
+|---|---|---|
+| `SLOPPER_SERVER_URL` | `http://localhost:8000` | Folio API |
+| `SLOPPER_TOKEN` | — | API key this environment registers with |
+| `SLOPPER_ENV_ID` | generated once, kept in `~/.slopper/identity.toml` | This machine's name in Folio. Must stay stable: sessions are bound to it |
+| `SLOPPER_WORKSPACE_ROOT` | `~/.slopper/workspaces` | One directory per session |
+| `SLOPPER_CLONE_SINCE` | `1.month.ago` | How much git history a checkout carries; empty for all |
+| `SLOPPER_CODEX_BIN` | the bundled one | A different `codex` binary |

slopper-0.1.0/slopper.egg-info/SOURCES.txt

@@ -0,0 +1,52 @@
+README.md
+pyproject.toml
+slopper.egg-info/PKG-INFO
+slopper.egg-info/SOURCES.txt
+slopper.egg-info/dependency_links.txt
+slopper.egg-info/entry_points.txt
+slopper.egg-info/requires.txt
+slopper.egg-info/top_level.txt
+slopper_env/__init__.py
+slopper_env/__main__.py
+slopper_env/agent.py
+slopper_env/cli.py
+slopper_env/config.py
+slopper_env/constants.py
+slopper_env/devtools.py
+slopper_env/doc.py
+slopper_env/folio_mcp.py
+slopper_env/identity.py
+slopper_env/ids.py
+slopper_env/lock.py
+slopper_env/loop.py
+slopper_env/main.py
+slopper_env/models.py
+slopper_env/ordering.py
+slopper_env/registration.py
+slopper_env/runner.py
+slopper_env/service.py
+slopper_env/sync.py
+slopper_env/workspace.py
+slopper_env/adapters/__init__.py
+slopper_env/adapters/base.py
+slopper_env/adapters/claude_code.py
+slopper_env/adapters/codex.py
+slopper_env/backends/__init__.py
+slopper_env/backends/base.py
+slopper_env/backends/claude.py
+slopper_env/backends/codex.py
+tests/test_agent.py
+tests/test_agent_config.py
+tests/test_agent_resume.py
+tests/test_claude_adapter.py
+tests/test_codex.py
+tests/test_doc.py
+tests/test_folio_mcp.py
+tests/test_identity.py
+tests/test_loop.py
+tests/test_ordering.py
+tests/test_packaging.py
+tests/test_runner.py
+tests/test_sync.py
+tests/test_tool_decision.py
+tests/test_workspace.py

slopper-0.1.0/slopper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

slopper-0.1.0/slopper.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+slopper = slopper_env.cli:main
+slopper-dev = slopper_env.devtools:cli
+slopper-env = slopper_env.cli:run_alias

slopper-0.1.0/slopper.egg-info/requires.txt

@@ -0,0 +1,7 @@
+pycrdt>=0.12.0
+claude-agent-sdk<0.3,>=0.2.152
+openai-codex-cli-bin<0.157,>=0.156
+httpx>=0.28.0
+websockets>=13.0
+pydantic-settings>=2.2.0
+python-json-logger>=2.0.0

slopper-0.1.0/slopper.egg-info/top_level.txt

@@ -0,0 +1 @@
+slopper_env

slopper-0.1.0/slopper_env/__main__.py

@@ -0,0 +1,7 @@
+"""``python -m slopper_env`` -- what the installed service runs."""
+
+import sys
+
+from slopper_env.cli import main
+
+sys.exit(main())

slopper-0.1.0/slopper_env/adapters/base.py

@@ -0,0 +1,44 @@
+"""The provider seam.
+
+This interface is the only place in the environment where a provider is
+named. ``TurnRunner``, ``ConversationLoop``, the document, and the UI all
+operate on canonical items alone.
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+from typing import Any, Sequence
+
+
+@dataclass(frozen=True)
+class TurnEnd:
+    """The provider's account of how a turn finished, in neutral terms."""
+
+    #: The provider's own session (Claude) or thread (Codex) id, recorded so
+    #: a later attach can resume it.
+    session_id: str | None
+    #: The turn ended on a tool call waiting for a human, to be resumed.
+    deferred: bool = False
+
+
+class AgentAdapter(ABC):
+    kind: str
+
+    @abstractmethod
+    def from_provider(self, message: Any) -> list[dict]:
+        """Translate one provider message into canonical items.
+
+        Returns a list because a single provider message may carry several
+        canonical items, and because some provider messages (usage reports,
+        lifecycle chatter) carry none.
+        """
+
+    @abstractmethod
+    def turn_end(self, message: Any) -> TurnEnd | None:
+        """The turn's outcome if ``message`` is the one that ends it."""
+
+    @abstractmethod
+    def to_provider(self, items: Sequence[dict]) -> Any:
+        """Translate canonical history into a provider payload."""