squawkbox 0.1.0__py3-none-any.whl

squawkbox/__init__.py

@@ -0,0 +1,5 @@
+"""Thin Python wrapper for the squawkbox Node CLI."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

squawkbox/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+
+raise SystemExit(main())

squawkbox/cli.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Iterable, Sequence
+
+
+PACKAGE_NAME = "squawkbox"
+
+
+def _candidate_roots(start: Path) -> Iterable[Path]:
+    current = start.resolve()
+    if current.is_file():
+        current = current.parent
+    yield current
+    yield from current.parents
+
+
+def find_local_cli(search_root: Path | None = None) -> Path | None:
+    start = search_root or Path(__file__)
+    for root in _candidate_roots(start):
+        cli_path = root / "dist" / "cli.js"
+        if (root / "package.json").is_file() and cli_path.is_file():
+            return cli_path
+    return None
+
+
+def resolve_command(search_root: Path | None = None) -> list[str]:
+    cli_path = find_local_cli(search_root)
+    if cli_path is not None:
+        node = shutil.which("node")
+        if node is None:
+            raise RuntimeError("node is required to run the local squawkbox CLI")
+        return [node, str(cli_path)]
+    return ["npx", "-y", PACKAGE_NAME]
+
+
+def run(argv: Sequence[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    command = resolve_command()
+    try:
+        completed = subprocess.run([*command, *args], check=False)
+    except FileNotFoundError as exc:
+        executable = exc.filename or command[0]
+        sys.stderr.write(
+            f"squawkbox: required executable not found: {executable}\n",
+        )
+        return 1
+    return int(completed.returncode)
+
+
+def main() -> int:
+    try:
+        return run()
+    except RuntimeError as exc:
+        sys.stderr.write(f"squawkbox: {exc}\n")
+        return 1

squawkbox-0.1.0.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: squawkbox
+Version: 0.1.0
+Summary: Thin PyPI wrapper for the squawkbox Node CLI — the intercom for your AI agents.
+Author: Ben Wiseman
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# squawkbox (PyPI wrapper)
+
+**The intercom for your AI agents** — `pip`/`uvx` access to
+[squawkbox](https://github.com/BenWiseman/squawkbox), a local MCP message broker
+that lets parallel AI coding agents (Claude Code, Codex, and concurrent
+sessions) coordinate instead of colliding.
+
+This package is a thin wrapper around the Node CLI: it runs a local build if one
+is present, otherwise falls back to `npx -y squawkbox`. The implementation,
+docs, and demo live in the main repo.
+
+## Install
+
+```bash
+pip install squawkbox      # or: uvx squawkbox
+```
+
+## Use
+
+```bash
+squawkbox shim --runtime claude    # wire into your MCP client (see the repo)
+squawkbox daemon                   # run the broker standalone
+```
+
+Full docs, the 60-second quickstart, and MCP config snippets:
+**https://github.com/BenWiseman/squawkbox**
+
+MIT.

squawkbox-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+squawkbox/__init__.py,sha256=4wkiYin8rCrOvWNbuQrzd8FJzGEPNbasF154buz_QyA,104
+squawkbox/__main__.py,sha256=D31U8_ux95qF64EQ8ReT25nabzxh7ped5avpobXz_bM,49
+squawkbox/cli.py,sha256=GU_tgCoJsJg-Ye6XhUekWsWW3-dsktIo4APF8n4m-6Y,1647
+squawkbox-0.1.0.dist-info/METADATA,sha256=aG4B2-KFCgM9sjG9AXIQca07A0d89MmSB4rFP52k0yc,1455
+squawkbox-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+squawkbox-0.1.0.dist-info/entry_points.txt,sha256=K2__mGouxzDaeGUVb8GcX7DWW46AIWVIcytRPJAT8p8,49
+squawkbox-0.1.0.dist-info/top_level.txt,sha256=bJ9v_-OjczHuJ7o_DcXD6CX7IlMP5op5op5NhJwF55s,10
+squawkbox-0.1.0.dist-info/RECORD,,

squawkbox-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

squawkbox-0.1.0.dist-info/entry_points.txt

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

squawkbox-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+squawkbox