squawkbox 0.1.0__tar.gz

squawkbox-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,28 @@
+# 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/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "squawkbox"
+version = "0.1.0"
+description = "Thin PyPI wrapper for the squawkbox Node CLI — the intercom for your AI agents."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Ben Wiseman" }]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Topic :: Software Development :: Build Tools",
+]
+
+[project.scripts]
+squawkbox = "squawkbox.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

squawkbox-0.1.0/setup.cfg

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

squawkbox-0.1.0/src/squawkbox/__init__.py

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

squawkbox-0.1.0/src/squawkbox/__main__.py

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

squawkbox-0.1.0/src/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/src/squawkbox.egg-info/PKG-INFO

@@ -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/src/squawkbox.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/squawkbox/__init__.py
+src/squawkbox/__main__.py
+src/squawkbox/cli.py
+src/squawkbox.egg-info/PKG-INFO
+src/squawkbox.egg-info/SOURCES.txt
+src/squawkbox.egg-info/dependency_links.txt
+src/squawkbox.egg-info/entry_points.txt
+src/squawkbox.egg-info/top_level.txt
+tests/test_cli.py

squawkbox-0.1.0/src/squawkbox.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

squawkbox-0.1.0/src/squawkbox.egg-info/entry_points.txt

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

squawkbox-0.1.0/src/squawkbox.egg-info/top_level.txt

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

squawkbox-0.1.0/tests/test_cli.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+PYTHON_SRC = REPO_ROOT / "python" / "src"
+
+
+class SquawkboxWrapperTests(unittest.TestCase):
+    def test_module_help_shells_out_to_local_node_cli(self) -> None:
+        env = os.environ.copy()
+        env["PYTHONPATH"] = str(PYTHON_SRC)
+
+        result = subprocess.run(
+            [sys.executable, "-m", "squawkbox", "--help"],
+            cwd=REPO_ROOT,
+            env=env,
+            capture_output=True,
+            text=True,
+        )
+
+        self.assertEqual(result.returncode, 0, result.stderr)
+        self.assertIn("squawkbox — the intercom for your AI agents", result.stdout)
+        self.assertIn("squawkbox daemon", result.stdout)
+
+    def test_resolve_command_falls_back_to_npx_when_local_cli_is_missing(self) -> None:
+        sys.path.insert(0, str(PYTHON_SRC))
+        try:
+            from squawkbox.cli import resolve_command
+        finally:
+            sys.path.pop(0)
+
+        with tempfile.TemporaryDirectory() as tmp:
+            command = resolve_command(search_root=Path(tmp))
+
+        self.assertEqual(command, ["npx", "-y", "squawkbox"])
+
+
+if __name__ == "__main__":
+    unittest.main()