bub 0.5.1__tar.gz → 0.6.0a2__tar.gz

bub-0.6.0a2/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.5
+Name: bub
+Version: 0.6.0a2
+Summary: A tiny agent runtime, composable with plugins.
+Project-URL: Homepage, https://bub.build
+Project-URL: Repository, https://github.com/bubbuild/bub
+Project-URL: Documentation, https://bub.build
+Author-email: Chojan Shang <psiace@apache.org>, Frost Ming <me@frostming.com>, Yihong <zouzou0208@gmail.com>
+License: Apache-2.0
+License-File: LICENSE
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.12
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: republic>=0.6.0a1
+Requires-Dist: typing-extensions>=4.15.0
+Provides-Extra: app
+Requires-Dist: aiohttp>=3.14.3; extra == 'app'
+Requires-Dist: httpx[socks]>=0.28.1; extra == 'app'
+Requires-Dist: inquirer-textual>=0.8.0; extra == 'app'
+Requires-Dist: pluggy>=1.6.0; extra == 'app'
+Requires-Dist: prompt-toolkit>=3.0.52; extra == 'app'
+Requires-Dist: pydantic-settings>=2.14.2; extra == 'app'
+Requires-Dist: python-telegram-bot>=22.7; extra == 'app'
+Requires-Dist: pyyaml>=6.0.3; extra == 'app'
+Requires-Dist: rapidfuzz>=3.14.5; extra == 'app'
+Requires-Dist: rich>=14.3.4; extra == 'app'
+Requires-Dist: typer>=0.24.1; extra == 'app'
+Provides-Extra: logfire
+Requires-Dist: aiohttp>=3.14.3; extra == 'logfire'
+Requires-Dist: httpx[socks]>=0.28.1; extra == 'logfire'
+Requires-Dist: inquirer-textual>=0.8.0; extra == 'logfire'
+Requires-Dist: logfire>=4.32.0; extra == 'logfire'
+Requires-Dist: opentelemetry-api>=1.39.0; extra == 'logfire'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.39.0; extra == 'logfire'
+Requires-Dist: opentelemetry-sdk>=1.39.0; extra == 'logfire'
+Requires-Dist: pluggy>=1.6.0; extra == 'logfire'
+Requires-Dist: prompt-toolkit>=3.0.52; extra == 'logfire'
+Requires-Dist: pydantic-settings>=2.14.2; extra == 'logfire'
+Requires-Dist: python-telegram-bot>=22.7; extra == 'logfire'
+Requires-Dist: pyyaml>=6.0.3; extra == 'logfire'
+Requires-Dist: rapidfuzz>=3.14.5; extra == 'logfire'
+Requires-Dist: rich>=14.3.4; extra == 'logfire'
+Requires-Dist: typer>=0.24.1; extra == 'logfire'
+Provides-Extra: trace
+Requires-Dist: opentelemetry-api>=1.39.0; extra == 'trace'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.39.0; extra == 'trace'
+Requires-Dist: opentelemetry-sdk>=1.39.0; extra == 'trace'
+Description-Content-Type: text/markdown
+
+# Bub
+
+<div align="center">
+
+<picture>
+  <source srcset="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo-dark.png" media="(prefers-color-scheme: dark)">
+  <img alt="Bub logo" src="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo.png" width="200">
+</picture>
+
+<p><strong>A tiny agent runtime, composable with plugins.</strong></p>
+
+[Website](https://bub.build) · [Docs](https://bub.build/docs/getting-started/) · [Hub](https://hub.bub.build)
+
+</div>
+
+Bub is a small Python runtime for building agents in shared environments. It started in group chats, where multiple humans and agents had to work in the same conversation without hidden state, hand-wavy memory, or framework-specific magic.
+
+Built on [agents.md](https://agents.md/) and [Agent Skills](https://agentskills.io/), Bub stays intentionally small. Every turn stage is a [pluggy](https://pluggy.readthedocs.io/) hook, builtins are replaceable, and the same runtime drives CLI, Telegram, and any channel you add.
+
+## Quick Start
+
+macOS and Linux:
+
+```bash
+curl -fsSL https://bub.build/install.sh | bash
+```
+
+Windows PowerShell:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
+```
+
+Then:
+
+```bash
+bub chat                         # interactive session
+bub run "summarize this repo"    # one-shot task
+bub gateway                      # channel listener mode
+```
+
+See [Getting Started](https://bub.build/docs/getting-started/) for installer presets and source installs, and [Configure](https://bub.build/docs/operate/configure/) for model and runtime settings.
+
+## Why Bub
+
+- **Composable by design.** Every turn stage is a plugin hook. Override one stage or replace the whole flow without forking the runtime.
+- **Tape context.** Context is rebuilt from append-only records, not carried around as mutable session state. Easier to inspect, replay, and hand off.
+- **One runtime across surfaces.** The same inbound pipeline runs across CLI, Telegram, and custom channels. Adapters change the surface, not the runtime model.
+- **Batteries included.** CLI, Telegram, tools, skills, and model execution ship with the core runtime. Use the defaults first, replace them later.
+- **Operator equivalence.** Humans and agents work inside the same runtime boundaries, with the same evidence trail and handoff model.
+- **Embeddable Python SDK.** `pip install bub` installs only `bub.core`, which exposes the agent loop on its own (the CLI, channels and plugins come with `bub[app]`) — bring your own model, tools, prompts, and tape store, with no settings or plugins required.
+
+## How It Works
+
+Every inbound message goes through one turn pipeline. Each stage is a hook.
+
+```
+resolve_session → load_state → build_prompt → run_model
+                                                   ↓
+              dispatch_outbound ← render_outbound ← save_state
+```
+
+Builtins are registered first and external plugins load after them, so later plugins take precedence. There are no framework-only shortcuts.
+
+## Docs
+
+- [Getting Started](https://bub.build/docs/getting-started/) — install Bub and run the first turn
+- [Concepts](https://bub.build/docs/concepts/) — the mental model behind the runtime
+- [Python SDK](https://bub.build/docs/build/sdk/) — embed Bub's agent loop in your own application
+- [Build](https://bub.build/docs/build/) — write plugins, override hooks, ship tools and skills
+- [Bub Hub](https://hub.bub.build) — browse community plugins, skills, and distributions
+- [Channels](https://bub.build/docs/operate/channels/) — run Bub in CLI, Telegram, or your own channel
+- [Deployment](https://bub.build/docs/operate/deploy/) — Docker, environment, upgrades
+
+## Background
+
+- [Why We Rewrote Bub](https://bub.build/posts/why-rewrite-bub/)
+- [Socialized Evaluation and Agent Partnership](https://bub.build/posts/socialized-evaluation/)
+- [Context from Tape](https://tape.systems)
+
+## License
+
+[Apache-2.0](https://github.com/bubbuild/bub/blob/main/LICENSE)

bub-0.6.0a2/README.md

@@ -0,0 +1,83 @@
+# Bub
+
+<div align="center">
+
+<picture>
+  <source srcset="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo-dark.png" media="(prefers-color-scheme: dark)">
+  <img alt="Bub logo" src="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo.png" width="200">
+</picture>
+
+<p><strong>A tiny agent runtime, composable with plugins.</strong></p>
+
+[Website](https://bub.build) · [Docs](https://bub.build/docs/getting-started/) · [Hub](https://hub.bub.build)
+
+</div>
+
+Bub is a small Python runtime for building agents in shared environments. It started in group chats, where multiple humans and agents had to work in the same conversation without hidden state, hand-wavy memory, or framework-specific magic.
+
+Built on [agents.md](https://agents.md/) and [Agent Skills](https://agentskills.io/), Bub stays intentionally small. Every turn stage is a [pluggy](https://pluggy.readthedocs.io/) hook, builtins are replaceable, and the same runtime drives CLI, Telegram, and any channel you add.
+
+## Quick Start
+
+macOS and Linux:
+
+```bash
+curl -fsSL https://bub.build/install.sh | bash
+```
+
+Windows PowerShell:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
+```
+
+Then:
+
+```bash
+bub chat                         # interactive session
+bub run "summarize this repo"    # one-shot task
+bub gateway                      # channel listener mode
+```
+
+See [Getting Started](https://bub.build/docs/getting-started/) for installer presets and source installs, and [Configure](https://bub.build/docs/operate/configure/) for model and runtime settings.
+
+## Why Bub
+
+- **Composable by design.** Every turn stage is a plugin hook. Override one stage or replace the whole flow without forking the runtime.
+- **Tape context.** Context is rebuilt from append-only records, not carried around as mutable session state. Easier to inspect, replay, and hand off.
+- **One runtime across surfaces.** The same inbound pipeline runs across CLI, Telegram, and custom channels. Adapters change the surface, not the runtime model.
+- **Batteries included.** CLI, Telegram, tools, skills, and model execution ship with the core runtime. Use the defaults first, replace them later.
+- **Operator equivalence.** Humans and agents work inside the same runtime boundaries, with the same evidence trail and handoff model.
+- **Embeddable Python SDK.** `pip install bub` installs only `bub.core`, which exposes the agent loop on its own (the CLI, channels and plugins come with `bub[app]`) — bring your own model, tools, prompts, and tape store, with no settings or plugins required.
+
+## How It Works
+
+Every inbound message goes through one turn pipeline. Each stage is a hook.
+
+```
+resolve_session → load_state → build_prompt → run_model
+                                                   ↓
+              dispatch_outbound ← render_outbound ← save_state
+```
+
+Builtins are registered first and external plugins load after them, so later plugins take precedence. There are no framework-only shortcuts.
+
+## Docs
+
+- [Getting Started](https://bub.build/docs/getting-started/) — install Bub and run the first turn
+- [Concepts](https://bub.build/docs/concepts/) — the mental model behind the runtime
+- [Python SDK](https://bub.build/docs/build/sdk/) — embed Bub's agent loop in your own application
+- [Build](https://bub.build/docs/build/) — write plugins, override hooks, ship tools and skills
+- [Bub Hub](https://hub.bub.build) — browse community plugins, skills, and distributions
+- [Channels](https://bub.build/docs/operate/channels/) — run Bub in CLI, Telegram, or your own channel
+- [Deployment](https://bub.build/docs/operate/deploy/) — Docker, environment, upgrades
+
+## Background
+
+- [Why We Rewrote Bub](https://bub.build/posts/why-rewrite-bub/)
+- [Socialized Evaluation and Agent Partnership](https://bub.build/posts/socialized-evaluation/)
+- [Context from Tape](https://tape.systems)
+
+## License
+
+[Apache-2.0](https://github.com/bubbuild/bub/blob/main/LICENSE)

{bub-0.5.1 → bub-0.6.0a2}/pyproject.toml

@@ -20,22 +20,11 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 
+# The agent kernel, bub.core. Everything else (framework, CLI, channels, builtin agent) is in the `app` extra.
 dependencies = [
+    "republic>=0.6.0a1",
     "pydantic>=2.12.5",
-    "pydantic-settings>=2.14.2",
-    "pyyaml>=6.0.3",
-    "pluggy>=1.6.0",
-    "inquirer-textual>=0.8.0",
-    "typer>=0.24.1",
-    "authlib>=1.7.2",
-    "any-llm-sdk[anthropic]>=1.22.1",
-    "rich>=14.3.4",
-    "prompt-toolkit>=3.0.52",
-    "python-telegram-bot>=22.7",
     "loguru>=0.7.3",
-    "rapidfuzz>=3.14.5",
-    "aiohttp>=3.14.3",
-    "httpx[socks]>=0.28.1",
     "typing-extensions>=4.15.0",
 ]
 
@@ -45,21 +34,35 @@ Repository = "https://github.com/bubbuild/bub"
 Documentation = "https://bub.build"
 
 [project.scripts]
-bub = "bub.__main__:app"
+bub = "bub.__main__:main"
 
 [project.optional-dependencies]
+app = [
+    "pydantic-settings>=2.14.2",
+    "pyyaml>=6.0.3",
+    "pluggy>=1.6.0",
+    "inquirer-textual>=0.8.0",
+    "typer>=0.24.1",
+    "rich>=14.3.4",
+    "prompt-toolkit>=3.0.52",
+    "python-telegram-bot>=22.7",
+    "rapidfuzz>=3.14.5",
+    "aiohttp>=3.14.3",
+    "httpx[socks]>=0.28.1",
+]
 trace = [
     "opentelemetry-api>=1.39.0",
     "opentelemetry-sdk>=1.39.0",
     "opentelemetry-exporter-otlp-proto-http>=1.39.0",
 ]
 logfire = [
-    "bub[trace]",
+    "bub[app,trace]",
     "logfire>=4.32.0",
 ]
 
 [dependency-groups]
 dev = [
+    "bub[app]",
     "pytest>=9.0.3",
     "tox-uv>=1.35.1",
     "types-PyYAML>=6.0.12.20260408",

bub-0.6.0a2/src/bub/__init__.py

@@ -0,0 +1,62 @@
+"""Bub framework package.
+
+The top-level names are imported on first access, so ``import bub.core`` does not load
+the framework, its settings or the CLI.
+"""
+
+from __future__ import annotations
+
+import os
+from importlib import import_module
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as metadata_version
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from bub.configure import Settings, config, ensure_config
+    from bub.core.tools import tool
+    from bub.framework import BubFramework
+    from bub.hooks import hookimpl
+
+    home: Path
+
+__all__ = [
+    "BubFramework",
+    "Settings",
+    "config",
+    "ensure_config",
+    "home",
+    "hookimpl",
+    "tool",
+]
+
+_EXPORTS = {
+    "BubFramework": "bub.framework",
+    "Settings": "bub.configure",
+    "config": "bub.configure",
+    "ensure_config": "bub.configure",
+    "hookimpl": "bub.hooks",
+    "tool": "bub.core.tools",
+}
+
+try:
+    __version__ = import_module("bub._version").version
+except ModuleNotFoundError:
+    try:
+        __version__ = metadata_version("bub")
+    except PackageNotFoundError:
+        __version__ = "0.0.0"
+
+
+def __getattr__(name: str) -> Any:
+    if name == "home":
+        # Importing bub.configure loads ``.env``, which may set ``BUB_HOME``.
+        from bub.configure import DEFAULT_HOME
+
+        if "BUB_HOME" in os.environ:
+            return Path(os.path.expanduser(os.environ["BUB_HOME"]))
+        return DEFAULT_HOME
+    if name not in _EXPORTS:
+        raise AttributeError(f"module {__name__} has no attribute {name}")
+    return getattr(import_module(_EXPORTS[name]), name)

bub-0.6.0a2/src/bub/__main__.py

@@ -0,0 +1,101 @@
+"""Bub framework CLI bootstrap.
+
+The CLI needs the ``app`` extra, so this module imports it only when the command runs:
+``main`` reports missing requirements instead of failing on an import.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from importlib.metadata import PackageNotFoundError, distribution, requires
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import typer
+
+LOG_LEVEL = {
+    0: "INFO",
+    1: "DEBUG",
+    2: "TRACE",
+}
+
+_APP_REQUIREMENT = re.compile(r"""^([A-Za-z0-9][A-Za-z0-9._-]*).*;.*\bextra\s*==\s*["']app["']""")
+
+
+def missing_app_requirements() -> list[str]:
+    """Return the distributions required by ``bub[app]`` that are not installed."""
+    try:
+        requirements = requires("bub") or []
+    except PackageNotFoundError:  # Running from a source tree that is not installed.
+        return []
+    missing: list[str] = []
+    for requirement in requirements:
+        if (match := _APP_REQUIREMENT.match(requirement)) is None:
+            continue
+        try:
+            distribution(match.group(1))
+        except PackageNotFoundError:
+            missing.append(match.group(1))
+    return missing
+
+
+def _instrument_bub(level: str) -> None:
+    from loguru import logger
+
+    logger.remove()
+    logger.add(sys.stderr, level=level, colorize=True, diagnose=False)
+
+    if os.getenv("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") or os.getenv("OTEL_EXPORTER_OTLP_ENDPOINT"):
+        from bub.tracing import configure_otlp
+
+        try:
+            configure_otlp()
+        except Exception as exc:
+            logger.warning("OTLP instrumentation disabled: {}", exc)
+        return
+
+    try:
+        import logfire
+        from logfire.integrations.loguru import LogfireHandler
+
+        logfire.configure()
+        logger.add(LogfireHandler(), level=level, format="{message}", diagnose=False)
+    except Exception as exc:
+        logger.debug("logfire instrumentation disabled: {}", exc)
+
+
+def create_cli_app() -> typer.Typer:
+    import typer
+
+    from bub.builtin.settings import load_settings
+    from bub.framework import BubFramework
+
+    framework = BubFramework()
+    _instrument_bub(LOG_LEVEL[load_settings().verbose])
+    framework.load_hooks()
+    app = framework.create_cli_app()
+
+    if not app.registered_commands:
+
+        @app.command("help")
+        def _help() -> None:
+            typer.echo("No CLI command loaded.")
+
+    return app
+
+
+def main() -> None:
+    """Run the ``bub`` command."""
+    if missing := missing_app_requirements():
+        sys.exit(
+            "The bub command needs the 'app' extra, which is not installed "
+            f"(missing: {', '.join(missing)}).\n"
+            "Install it with: uv tool install 'bub[app]'  or  pip install 'bub[app]'"
+        )
+    create_cli_app()()
+
+
+if __name__ == "__main__":
+    main()

{bub-0.5.1 → bub-0.6.0a2}/src/bub/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.5.1'
-__version_tuple__ = version_tuple = (0, 5, 1)
+__version__ = version = '0.6.0a2'
+__version_tuple__ = version_tuple = (0, 6, 0, 'a2')
 
 __commit_id__ = commit_id = None

bub-0.6.0a2/src/bub/builtin/__init__.py

@@ -0,0 +1,6 @@
+from .agent import BubAgent
+
+Agent = BubAgent
+"""Deprecated alias of :class:`BubAgent`."""
+
+__all__ = ["Agent", "BubAgent"]