humanbottasks 0.1.1__tar.gz → 0.1.2__tar.gz

humanbottasks-0.1.2/GUIDE.md

@@ -0,0 +1,76 @@
+# Give your AI agent a human fallback — in 2 lines
+
+Agents are great at reasoning, but bad at the parts that need a real person:
+verifying a fact, doing something physical, judging whether something "feels right",
+labeling data correctly. humanbottasks closes that gap with a two-tool MCP server.
+
+## Install
+
+```bash
+uvx humanbottasks
+```
+
+That's it. Add it to your MCP client (Claude Desktop, Cursor, Windsurf) or spawn it
+as a subprocess from any agent framework.
+
+## What you get — two tools
+
+- `request_human_task(task_type, description, max_price_usd)` — delegate work to a real person
+- `get_task_status(task_id)` — poll for the result
+
+## Five task types
+
+| task_type | for things like |
+|---|---|
+| `verification` | check a fact, test a page, confirm a detail |
+| `physical_action` | buy, ship, call, sign, visit |
+| `subjective_judgment` | "does this sound natural?", "is this good enough?" |
+| `ground_truth_labeling` | label data correctly, build eval sets |
+| `prove_human` | CAPTCHA, identity/account verification |
+
+## Example — Claude Desktop
+
+`claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "humanbottasks": {
+      "command": "uvx",
+      "args": ["humanbottasks"]
+    }
+  }
+}
+```
+
+Then ask Claude:
+
+> Check whether https://example.com is reachable from your side, and if it is,
+> what the page title is.
+
+Claude calls `request_human_task(task_type="verification", description="...")`,
+gets a `task_id`, a human fulfills it, and Claude polls `get_task_status` for the result.
+
+## How the loop works
+
+```
+Agent → request_human_task → queue (SQLite) → human fulfills → get_task_status → result
+```
+
+The queue lives at `~/.humanbottasks/tasks.db` (override with `HBT_DB`). Fulfill from the CLI:
+
+```bash
+python fulfill.py done <task_id> "<result>"
+```
+
+## Transports
+
+- `stdio` — Claude Desktop, Cursor, Windsurf, local agent frameworks (default)
+- `streamable-http` — remote agents: `python -m server --transport streamable-http`
+- `sse` — legacy clients
+
+## Links
+
+- Repo: https://github.com/humanbottasks/humanbottasks
+- Landing: https://humanbottasks.github.io/humanbottasks/
+- PyPI: https://pypi.org/project/humanbottasks/

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: humanbottasks
-Version: 0.1.1
+Version: 0.1.2
 Summary: Human fallback for AI agents: delegate tasks a model can't do to a human, over MCP.
 License-File: LICENSE
 Requires-Python: >=3.10
@@ -9,6 +9,8 @@ Description-Content-Type: text/markdown
 
 # humanbottasks
 
+mcp-name: io.github.humanbottasks/humanbottasks
+
 Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP
 eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt
 sie, der Agent ruft das Ergebnis ab.
@@ -38,6 +40,9 @@ Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.
 ## Install (fuer andere Builder, 1 Zeile)
     uvx humanbottasks
 
+## Guide (Englisch)
+- [GUIDE.md](GUIDE.md) — Einfuehrung, Task-Typen, Beispiel-Loop, Transports
+
 ## Task-Typen
 verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human
 

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/README.md

@@ -1,5 +1,7 @@
 # humanbottasks
 
+mcp-name: io.github.humanbottasks/humanbottasks
+
 Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP
 eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt
 sie, der Agent ruft das Ergebnis ab.
@@ -29,6 +31,9 @@ Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.
 ## Install (fuer andere Builder, 1 Zeile)
     uvx humanbottasks
 
+## Guide (Englisch)
+- [GUIDE.md](GUIDE.md) — Einfuehrung, Task-Typen, Beispiel-Loop, Transports
+
 ## Task-Typen
 verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human
 

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/index.html

@@ -63,6 +63,7 @@
     <div class="h2">Install</div>
     <div class="code"><span class="c"># one command</span><br>uvx humanbottasks</div>
     <div class="code"><span class="c"># MCP client config (Claude Desktop / Cursor / Windsurf)</span><br>{"mcpServers":{"humanbottasks":{"command":"uvx","args":["humanbottasks"]}}}</div>
+    <p><a href="https://github.com/humanbottasks/humanbottasks/blob/main/GUIDE.md">Read the full guide →</a></p>
   </section>
 
   <section class="wrap">

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "humanbottasks"
-version = "0.1.1"
+version = "0.1.2"
 description = "Human fallback for AI agents: delegate tasks a model can't do to a human, over MCP."
 readme = "README.md"
 requires-python = ">=3.10"

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/server.json

@@ -8,13 +8,13 @@
     "url": "https://github.com/humanbottasks/humanbottasks",
     "source": "github"
   },
-  "version": "0.1.1",
+  "version": "0.1.2",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "humanbottasks",
-      "version": "0.1.1",
+      "version": "0.1.2",
       "transport": {
         "type": "stdio"
       }

{humanbottasks-0.1.1 → humanbottasks-0.1.2}/test_mcp_client.py

@@ -15,10 +15,9 @@ import store as q
 
 
 async def main():
-    # Lokalen Server spawnen (fuer die Fix-Verifikation).
-    # Fuer den Test gegen das PyPI-Package stattdessen:
-    #   StdioServerParameters(command="uvx", args=["humanbottasks"])
-    params = StdioServerParameters(command=sys.executable, args=["server.py"])
+    # Test gegen das gepublishte PyPI-Package (0.1.1 mit DB-Fix)
+    # --refresh erzwingt Neuaufloesung (sonst greift uvx auf gecachtes 0.1.0 zurueck)
+    params = StdioServerParameters(command="uvx", args=["--refresh", "humanbottasks"])
     async with stdio_client(params) as (read, write):
         async with ClientSession(read, write) as session:
             await session.initialize()