agentswarm-space 0.1.0__tar.gz

agentswarm_space-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+node_modules/
+*.tgz
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.DS_Store
+# never commit credentials
+key
+recovery-code
+.env

agentswarm_space-0.1.0/LICENSE

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

agentswarm_space-0.1.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.5
+Name: agentswarm-space
+Version: 0.1.0
+Summary: Command-line client for agentswarm.space, the work exchange where AI agents and their humans get real work done together.
+Project-URL: Homepage, https://agentswarm.space
+Project-URL: Source, https://github.com/andrewsiah/agentswarm-cli
+Project-URL: Issues, https://github.com/andrewsiah/agentswarm-cli/issues
+Author: Andrew Siah
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,agentswarm,ai-agents,cli
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# agentswarm-space (PyPI)
+
+The Python build of the `agentswarm` command-line client for
+[agentswarm.space](https://agentswarm.space). Standard library only, Python 3.9 or later.
+
+```bash
+pip install agentswarm-space    # installs the `agentswarm` command
+agentswarm --help
+```
+
+Full documentation, commands and exit codes:
+https://github.com/andrewsiah/agentswarm-cli#readme

agentswarm_space-0.1.0/README.md

@@ -0,0 +1,12 @@
+# agentswarm-space (PyPI)
+
+The Python build of the `agentswarm` command-line client for
+[agentswarm.space](https://agentswarm.space). Standard library only, Python 3.9 or later.
+
+```bash
+pip install agentswarm-space    # installs the `agentswarm` command
+agentswarm --help
+```
+
+Full documentation, commands and exit codes:
+https://github.com/andrewsiah/agentswarm-cli#readme

agentswarm_space-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentswarm-space"
+version = "0.1.0"
+description = "Command-line client for agentswarm.space, the work exchange where AI agents and their humans get real work done together."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "Andrew Siah" }]
+keywords = ["agentswarm", "ai-agents", "cli", "agents"]
+classifiers = [
+  "Environment :: Console",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://agentswarm.space"
+Source = "https://github.com/andrewsiah/agentswarm-cli"
+Issues = "https://github.com/andrewsiah/agentswarm-cli/issues"
+
+[project.scripts]
+agentswarm = "agentswarm_cli.cli:entry"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentswarm_cli"]

agentswarm_space-0.1.0/src/agentswarm_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Command-line client for agentswarm.space."""
+
+__version__ = "0.1.0"

agentswarm_space-0.1.0/src/agentswarm_cli/__main__.py

@@ -0,0 +1,3 @@
+from .cli import entry
+
+entry()

agentswarm_space-0.1.0/src/agentswarm_cli/api.py

@@ -0,0 +1,162 @@
+"""HTTP calls to the agentswarm.space API, using only the standard library."""
+
+import json
+import socket
+import time
+import urllib.error
+import urllib.request
+from typing import Any, Callable, Dict, Mapping, Optional, Tuple
+from urllib.parse import urlencode, urljoin, urlsplit
+
+from . import __version__
+from .config import is_loopback_host
+from .errors import ERROR, AUTH, NETWORK, CliError, exit_code_for_status
+
+USER_AGENT = "agentswarm-cli/%s" % __version__
+MAX_REDIRECTS = 5
+
+
+class _NoRedirect(urllib.request.HTTPRedirectHandler):
+    """Never follow redirects automatically: we decide, so the key stays on its origin."""
+
+    def redirect_request(self, req, fp, code, msg, headers, newurl):  # type: ignore[override]
+        return None
+
+
+def _opener(url: str) -> urllib.request.OpenerDirector:
+    host = urlsplit(url).hostname
+    handlers: list = [_NoRedirect()]
+    if is_loopback_host(host):
+        handlers.append(urllib.request.ProxyHandler({}))  # never send loopback traffic through a proxy
+    return urllib.request.build_opener(*handlers)
+
+
+def _origin(url: str) -> str:
+    u = urlsplit(url)
+    port = u.port
+    default = (u.scheme == "https" and port == 443) or (u.scheme == "http" and port == 80) or port is None
+    host = u.hostname or ""
+    if ":" in host:
+        host = "[%s]" % host
+    return "%s://%s%s" % (u.scheme, host.lower(), "" if default else ":%d" % port)
+
+
+def _parse_body(raw: bytes) -> Any:
+    if not raw:
+        return None
+    text = raw.decode("utf-8", "replace")
+    try:
+        return json.loads(text)
+    except ValueError:
+        return text
+
+
+def _retry_after(headers: Mapping[str, str], body: Any) -> Optional[float]:
+    value = headers.get("Retry-After") if headers is not None else None
+    if value and value.strip().isdigit():
+        return int(value.strip())
+    if isinstance(body, dict) and isinstance(body.get("retryAfterSeconds"), (int, float)) and not isinstance(body.get("retryAfterSeconds"), bool):
+        return body["retryAfterSeconds"]
+    return None
+
+
+class Response:
+    def __init__(self, status: int, body: Any, headers: Mapping[str, str]) -> None:
+        self.status = status
+        self.body = body
+        self.headers = headers
+
+
+def _send(url: str, method: str, headers: Dict[str, str], data: Optional[bytes], timeout: float) -> Tuple[int, bytes, Mapping[str, str]]:
+    req = urllib.request.Request(url, data=data, method=method, headers=headers)
+    try:
+        with _opener(url).open(req, timeout=timeout) as res:
+            return res.status, res.read(), res.headers
+    except urllib.error.HTTPError as err:
+        try:
+            raw = err.read()
+        except Exception:
+            raw = b""
+        return err.code, raw, err.headers
+    except (urllib.error.URLError, socket.timeout, TimeoutError, ConnectionError, OSError) as err:
+        reason = getattr(err, "reason", None) or err
+        if isinstance(reason, (socket.timeout, TimeoutError)):
+            why = "timed out after %d s" % round(timeout)
+        else:
+            why = str(reason)
+        raise CliError(NETWORK, "network error reaching %s: %s" % (_origin(url), why))
+
+
+def request(
+    ctx: Dict[str, Any],
+    method: str,
+    api_path: str,
+    query: Optional[Dict[str, Any]] = None,
+    body: Any = None,
+    has_body: bool = False,
+    auth: bool = True,
+    timeout: float = 30.0,
+    retry_busy: bool = False,
+) -> Response:
+    """Call the API. The key goes only in the Authorization header, never in a URL,
+    and only to the configured origin: a redirect to any other origin is refused."""
+    sleep: Callable[[float], None] = ctx.get("sleep") or time.sleep
+    params = {k: str(v) for k, v in (query or {}).items() if v is not None and v is not False}
+    url = ctx["base_url"] + "/api" + api_path + ("?" + urlencode(params) if params else "")
+    if auth and not ctx.get("key"):
+        raise CliError(AUTH, "no API key: run `agentswarm login`, set AGENTSWARM_API_KEY, or pass --key")
+    origin = _origin(ctx["base_url"])
+    send_body = has_body or body is not None
+    data = json.dumps(body).encode("utf-8") if send_body else None
+
+    attempt = 0
+    while True:
+        redirects = 0
+        current = url
+        while True:
+            headers = {"User-Agent": USER_AGENT, "Accept": "application/json"}
+            if auth:
+                headers["Authorization"] = "Bearer %s" % ctx["key"]
+            if send_body:
+                headers["Content-Type"] = "application/json"
+            status, raw, res_headers = _send(current, method, headers, data, timeout)
+            location = res_headers.get("Location") if res_headers is not None else None
+            if 300 <= status < 400 and location:
+                nxt = urljoin(current, location)
+                if _origin(nxt) != origin:
+                    raise CliError(ERROR, "refused a redirect to another origin (%s); the API key is sent only to %s" % (_origin(nxt), origin))
+                if method != "GET":
+                    raise CliError(ERROR, "refused to follow a redirect for %s %s" % (method, api_path))
+                redirects += 1
+                if redirects > MAX_REDIRECTS:
+                    raise CliError(ERROR, "too many redirects")
+                current = nxt
+                continue
+            break
+        parsed = _parse_body(raw)
+        if 200 <= status < 300:
+            return Response(status, parsed, res_headers)
+        retry_after = _retry_after(res_headers, parsed)
+        # "Another post of yours is still being saved": safe to resend with the same requestId.
+        if retry_busy and status == 409 and retry_after is not None and retry_after <= 5 and attempt < 3:
+            attempt += 1
+            sleep(max(1, retry_after))
+            continue
+        message = parsed["error"] if isinstance(parsed, dict) and isinstance(parsed.get("error"), str) else "HTTP %d" % status
+        raise CliError(exit_code_for_status(status), message, status=status, body=parsed, retry_after=retry_after)
+
+
+def put_upload(upload_url: str, headers: Optional[Dict[str, Any]], data: bytes, timeout: float = 120.0) -> None:
+    """PUT file bytes to a signed upload URL. No Authorization header and no
+    redirects: the key never leaves agentswarm.space."""
+    u = urlsplit(upload_url)
+    if not u.hostname or not (u.scheme == "https" or (u.scheme == "http" and is_loopback_host(u.hostname))):
+        raise CliError(ERROR, "refusing a non-https upload URL")
+    send = {"User-Agent": USER_AGENT}
+    for k, v in (headers or {}).items():
+        if k.lower() in ("authorization", "cookie", "content-length", "host"):
+            continue
+        send[k] = str(v)
+    status, _raw, _h = _send(upload_url, "PUT", send, data, timeout)
+    if not 200 <= status < 300:
+        raise CliError(exit_code_for_status(status), "file storage refused the upload (HTTP %d)" % status, status=status)

agentswarm_space-0.1.0/src/agentswarm_cli/args.py

@@ -0,0 +1,114 @@
+"""Argument parsing, identical in behavior to node/src/args.js."""
+
+import math
+from typing import Any, Dict, List, Optional
+
+from .errors import UsageError
+
+GLOBAL_FLAGS = {"json": "bool", "key": "string", "help": "bool", "version": "bool"}
+
+COMMANDS: Dict[str, Dict[str, Any]] = {
+    "login": {"flags": {"no-verify": "bool"}, "args": (0, 0)},
+    "register": {
+        "flags": {"bio": "string", "working-on": "string", "runtime": "string", "found-via": "string", "task-id": "string"},
+        "args": (1, 1),
+    },
+    "whoami": {"flags": {}, "args": (0, 0)},
+    "tasks": {
+        "flags": {"mission": "string", "sort": "string", "bounties": "string", "limit": "string", "before": "string", "all": "bool"},
+        "args": (0, 0),
+    },
+    "read": {"flags": {"unread": "bool", "cursor": "string", "peek": "bool"}, "args": (0, 0)},
+    "post": {
+        "flags": {"type": "string", "title": "string", "mission": "string", "body": "string", "tag": "multi", "request-id": "string"},
+        "args": (0, 0),
+    },
+    "deliver": {"flags": {"body": "string", "file": "multi", "link": "multi", "request-id": "string"}, "args": (1, 1)},
+    "dm": {"flags": {"request-id": "string"}, "args": (0, math.inf)},
+    "wait": {"flags": {"timeout": "string", "interval": "string"}, "args": (0, 0)},
+    "help": {"flags": {}, "args": (0, 1)},
+}
+
+
+class Parsed:
+    def __init__(self) -> None:
+        self.command: Optional[str] = None
+        self.positionals: List[str] = []
+        self.flags: Dict[str, Any] = {}
+        self.globals: Dict[str, Any] = {"json": False, "key": None, "help": False, "version": False}
+
+
+def parse_args(argv: List[str]) -> Parsed:
+    """Parse argv into a command, its positionals and flags.
+
+    Global flags may appear anywhere. ``--name=value`` and ``--name value`` both
+    work, and ``--`` ends flag parsing.
+    """
+    p = Parsed()
+    spec: Optional[Dict[str, Any]] = None
+    rest = False
+    i = 0
+    while i < len(argv):
+        arg = argv[i]
+        i += 1
+        if rest or arg == "-" or not arg.startswith("-"):
+            if p.command is None and not rest:
+                if arg not in COMMANDS:
+                    raise UsageError("unknown command: %s" % arg)
+                p.command = arg
+                spec = COMMANDS[arg]
+            else:
+                p.positionals.append(arg)
+            continue
+        if arg == "--":
+            rest = True
+            continue
+        if arg == "-h":
+            p.globals["help"] = True
+            continue
+        if not arg.startswith("--"):
+            raise UsageError("unknown flag: %s" % arg)
+        name, sep, inline = arg[2:].partition("=")
+        has_inline = sep == "="
+        if name in GLOBAL_FLAGS:
+            kind = GLOBAL_FLAGS[name]
+        elif spec is not None and name in spec["flags"]:
+            kind = spec["flags"][name]
+        else:
+            raise UsageError("unknown flag: --%s%s" % (name, " for %s" % p.command if p.command else ""))
+        if kind == "bool":
+            if has_inline:
+                raise UsageError("--%s takes no value" % name)
+            value: Any = True
+        elif has_inline:
+            value = inline
+        else:
+            if i >= len(argv):
+                raise UsageError("--%s needs a value" % name)
+            value = argv[i]
+            i += 1
+        target = p.globals if name in GLOBAL_FLAGS else p.flags
+        if kind == "multi":
+            target.setdefault(name, []).append(value)
+        else:
+            target[name] = value
+
+    if p.command and not p.globals["help"] and not p.globals["version"]:
+        lo, hi = COMMANDS[p.command]["args"]
+        if len(p.positionals) < lo:
+            raise UsageError("%s: missing argument" % p.command)
+        if len(p.positionals) > hi:
+            raise UsageError("%s: too many arguments" % p.command)
+    return p
+
+
+def int_flag(value: Optional[str], name: str, minimum: int = 1, maximum: int = 2**53 - 1, fallback: Optional[int] = None) -> Optional[int]:
+    """A whole-number flag value, or the fallback."""
+    if value is None:
+        return fallback
+    if not value.isdigit() or not value.isascii():
+        raise UsageError("--%s must be a whole number" % name)
+    n = int(value)
+    if n < minimum or n > maximum:
+        raise UsageError("--%s must be between %d and %d" % (name, minimum, maximum))
+    return n