beadle 0.1.0__tar.gz

beadle-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.env
+logs/
+employees/*/runs/
+employees/*/journal.jsonl
+employees/*/claims.jsonl
+employees/*/inbox.jsonl
+employees/*/baseline.json
+employees/*/gate.jsonl
+employees/*/snapshots/
+employees/*/seen.json
+.deliver-failures.jsonl
+__pycache__/
+*.pyc
+.DS_Store

beadle-0.1.0/LICENSE

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

beadle-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: beadle
+Version: 0.1.0
+Summary: Build an AI employee without building an agent platform — deterministic checks, one-shot judgment, and a gate that keeps the model out of the loop on quiet days.
+Project-URL: Homepage, https://github.com/agentropicai/beadle
+Project-URL: Source, https://github.com/agentropicai/beadle
+Author: Agentropic
+License: MIT License
+        
+        Copyright (c) 2026 Agentropic
+        
+        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.
+License-File: LICENSE
+Keywords: agents,ai,automation,claude,cron,llm,monitoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Beadle
+
+**Build an AI employee without building an agent platform.**
+
+Most of any job is *noticing*, not thinking — scanning, comparing against a baseline, concluding
+nothing changed. Noticing is constant and answerable in SQL. Judgment is rare, expensive, and the
+only part a model is good at. Most agent systems fuse the two and pay judgment prices for
+noticing. Beadle keeps them apart.
+
+```
+pip install beadle
+beadle init my-employees
+cd my-employees
+./beadle doctor
+./beadle run example-site-watch uptime-check
+```
+
+Every task is the same five steps:
+
+```
+GATHER   deterministic — SQL, an API call, a shell command. No model.
+GATE     plain Python. Did anything happen? If not, stop here — silently.
+JUDGE    one model call. Tools disabled, max-turns 1.
+DELIVER  gated. Silence is the correct output most days.
+RECORD   journal, archive.
+```
+
+There is no agent loop. On the production fleet this was extracted from — 21 live tasks —
+10 never call a model at all, 18 can exit before the model is invoked, and the busiest task runs
+144 times a day for zero tokens.
+
+Beadle is a workspace you own and edit, not a library you import. `beadle init` fetches it and
+gets out of the way. Full docs, four working example employees, and a complete worked build
+(including the bug hit along the way) are in the workspace itself.
+
+MIT · https://github.com/agentropicai/beadle

beadle-0.1.0/PYPI.md

@@ -0,0 +1,36 @@
+# Beadle
+
+**Build an AI employee without building an agent platform.**
+
+Most of any job is *noticing*, not thinking — scanning, comparing against a baseline, concluding
+nothing changed. Noticing is constant and answerable in SQL. Judgment is rare, expensive, and the
+only part a model is good at. Most agent systems fuse the two and pay judgment prices for
+noticing. Beadle keeps them apart.
+
+```
+pip install beadle
+beadle init my-employees
+cd my-employees
+./beadle doctor
+./beadle run example-site-watch uptime-check
+```
+
+Every task is the same five steps:
+
+```
+GATHER   deterministic — SQL, an API call, a shell command. No model.
+GATE     plain Python. Did anything happen? If not, stop here — silently.
+JUDGE    one model call. Tools disabled, max-turns 1.
+DELIVER  gated. Silence is the correct output most days.
+RECORD   journal, archive.
+```
+
+There is no agent loop. On the production fleet this was extracted from — 21 live tasks —
+10 never call a model at all, 18 can exit before the model is invoked, and the busiest task runs
+144 times a day for zero tokens.
+
+Beadle is a workspace you own and edit, not a library you import. `beadle init` fetches it and
+gets out of the way. Full docs, four working example employees, and a complete worked build
+(including the bug hit along the way) are in the workspace itself.
+
+MIT · https://github.com/agentropicai/beadle

beadle-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "beadle"
+version = "0.1.0"
+description = "Build an AI employee without building an agent platform — deterministic checks, one-shot judgment, and a gate that keeps the model out of the loop on quiet days."
+readme = "PYPI.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+authors = [{ name = "Agentropic" }]
+keywords = ["agents", "ai", "automation", "cron", "llm", "monitoring", "claude"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: System :: Monitoring",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/agentropicai/beadle"
+Source = "https://github.com/agentropicai/beadle"
+
+[project.scripts]
+beadle = "beadle:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/beadle"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/beadle", "PYPI.md", "LICENSE"]

beadle-0.1.0/src/beadle/__init__.py

@@ -0,0 +1,88 @@
+"""Beadle — build an AI employee without building an agent platform.
+
+This package is a thin installer. Beadle itself is a workspace you own and edit, not a library
+you import: employees are folders, tasks are scripts you change. So `beadle init` fetches the
+starter workspace into a directory and then gets out of your way.
+
+    pip install beadle
+    beadle init my-employees
+    cd my-employees && ./beadle doctor
+
+Everything after that is documented in the workspace itself — README.md, QUICKSTART.md and
+EXAMPLE.md. Source: https://github.com/agentropicai/beadle
+"""
+__version__ = "0.1.0"
+
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+
+REPO = "https://github.com/agentropicai/beadle"
+
+USAGE = """beadle — fetch the Beadle starter workspace.
+
+    beadle init [directory]     create a workspace (default: ./beadle)
+    beadle --version
+
+Beadle is a workspace, not a library. Once `init` has run, use the ./beadle script inside it:
+
+    cd <directory>
+    ./beadle doctor
+    ./beadle run example-site-watch uptime-check
+    ./beadle new my-first-employee
+
+Docs: %s
+""" % REPO
+
+
+def _init(target):
+    dest = os.path.abspath(target)
+    if os.path.exists(dest) and os.listdir(dest):
+        sys.exit("%s already exists and is not empty" % dest)
+    if not shutil.which("git"):
+        sys.exit("git is required to fetch the workspace. Install it, or clone %s by hand." % REPO)
+
+    with tempfile.TemporaryDirectory() as tmp:
+        staging = os.path.join(tmp, "beadle")
+        r = subprocess.run(["git", "clone", "--depth", "1", "--quiet", REPO, staging],
+                           capture_output=True, text=True)
+        if r.returncode != 0:
+            sys.exit("could not fetch the workspace:\n" + (r.stderr or "")[:400])
+        # The workspace is yours from here — drop our history so your first commit is your own.
+        shutil.rmtree(os.path.join(staging, ".git"), ignore_errors=True)
+        shutil.rmtree(os.path.join(staging, "src"), ignore_errors=True)
+        for name in ("pyproject.toml",):
+            f = os.path.join(staging, name)
+            if os.path.exists(f):
+                os.remove(f)
+        shutil.copytree(staging, dest, dirs_exist_ok=True)
+
+    os.chmod(os.path.join(dest, "beadle"), 0o755)
+    rel = os.path.relpath(dest)
+    print("Created %s\n" % rel)
+    print("  cd %s" % rel)
+    print("  ./beadle doctor                                # do the pieces work?")
+    print("  ./beadle run example-site-watch uptime-check   # a real employee, no config needed")
+    print("  ./beadle new my-first-employee                 # now write your own")
+    print("\nRead EXAMPLE.md for a full worked build, bug included.")
+
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+    if not argv or argv[0] in ("-h", "--help", "help"):
+        print(USAGE)
+        return 0
+    if argv[0] in ("-V", "--version", "version"):
+        print("beadle %s" % __version__)
+        return 0
+    if argv[0] == "init":
+        _init(argv[1] if len(argv) > 1 else "beadle")
+        return 0
+    print(USAGE)
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())