bub 0.5.0__tar.gz → 0.6.0__tar.gz

bub-0.6.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.5
+Name: bub
+Version: 0.6.0
+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.4; 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.4; 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>Build your Bub.</strong></p>
+
+[Website](https://bub.build) · [Docs](https://bub.build/docs/) · [Hub](https://hub.bub.build)
+
+</div>
+
+Put an agent in your own Python program, or customize the Bub application. The application uses the same agent kernel and adds configuration, plugins, and channel integration.
+
+## Build your own agent
+
+Use `bub.core.Agent` to choose your model, tools, instructions, and conversation storage. The base `bub` package installs the kernel's dependencies.
+
+In a Python 3.12+ project:
+
+```bash
+uv add bub
+```
+
+Run your first agent with the [SDK guide](https://bub.build/docs/sdk/), then [serve it with FastAPI](https://bub.build/docs/sdk/web-service/) when you need an HTTP endpoint.
+
+You can also embed `BubAgent` to reuse the application's settings and plugin hooks in your service. This uses `bub[app]`; [Reuse the Bub app](https://bub.build/docs/integrations/reuse-app/) explains the integration choices and their requirements.
+
+## Customize the Bub app
+
+Start a conversation, then add tools, skills, plugins, or channels for the work you want Bub to do.
+
+Install on macOS or Linux:
+
+```bash
+curl -fsSL https://bub.build/install.sh | bash
+```
+
+On Windows:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
+```
+
+Follow the prompts to choose plugins and configure your model, then start a conversation:
+
+```bash
+bub chat
+```
+
+[Run your first conversation](https://bub.build/docs/app/workspace/) walks through a task in your workspace. [Customize the Bub app](https://bub.build/docs/app/workspace/) covers tools, plugins, and packaging. For `uv tool install` and other setup options, see [Install Bub](https://bub.build/docs/getting-started/install/#app-install).
+
+## Documentation
+
+- [Choose a starting point](https://bub.build/docs/)
+- [Shared concepts and capabilities](https://bub.build/docs/concepts/)
+- [API and application reference](https://bub.build/docs/reference/)
+
+## 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.0/README.md

@@ -0,0 +1,70 @@
+# 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>Build your Bub.</strong></p>
+
+[Website](https://bub.build) · [Docs](https://bub.build/docs/) · [Hub](https://hub.bub.build)
+
+</div>
+
+Put an agent in your own Python program, or customize the Bub application. The application uses the same agent kernel and adds configuration, plugins, and channel integration.
+
+## Build your own agent
+
+Use `bub.core.Agent` to choose your model, tools, instructions, and conversation storage. The base `bub` package installs the kernel's dependencies.
+
+In a Python 3.12+ project:
+
+```bash
+uv add bub
+```
+
+Run your first agent with the [SDK guide](https://bub.build/docs/sdk/), then [serve it with FastAPI](https://bub.build/docs/sdk/web-service/) when you need an HTTP endpoint.
+
+You can also embed `BubAgent` to reuse the application's settings and plugin hooks in your service. This uses `bub[app]`; [Reuse the Bub app](https://bub.build/docs/integrations/reuse-app/) explains the integration choices and their requirements.
+
+## Customize the Bub app
+
+Start a conversation, then add tools, skills, plugins, or channels for the work you want Bub to do.
+
+Install on macOS or Linux:
+
+```bash
+curl -fsSL https://bub.build/install.sh | bash
+```
+
+On Windows:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
+```
+
+Follow the prompts to choose plugins and configure your model, then start a conversation:
+
+```bash
+bub chat
+```
+
+[Run your first conversation](https://bub.build/docs/app/workspace/) walks through a task in your workspace. [Customize the Bub app](https://bub.build/docs/app/workspace/) covers tools, plugins, and packaging. For `uv tool install` and other setup options, see [Install Bub](https://bub.build/docs/getting-started/install/#app-install).
+
+## Documentation
+
+- [Choose a starting point](https://bub.build/docs/)
+- [Shared concepts and capabilities](https://bub.build/docs/concepts/)
+- [API and application reference](https://bub.build/docs/reference/)
+
+## 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.0 → bub-0.6.0}/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.4",
+    "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.0/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.0/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.0 → bub-0.6.0}/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.0'
-__version_tuple__ = version_tuple = (0, 5, 0)
+__version__ = version = '0.6.0'
+__version_tuple__ = version_tuple = (0, 6, 0)
 
 __commit_id__ = commit_id = None

bub-0.6.0/src/bub/application.py

@@ -0,0 +1,35 @@
+"""CLI, channel work and prompt events published by the application."""
+
+from contextvars import ContextVar
+from dataclasses import dataclass
+from typing import Literal
+
+from bub.core.events import Event, EventBus
+
+type Outcome = Literal["succeeded", "failed", "cancelled"]
+type PromptKind = Literal["question", "permission", "auth"]
+
+cli_events: ContextVar[EventBus | None] = ContextVar("cli_events", default=None)
+"""The event bus of the application running the current CLI command, if any."""
+
+
+@dataclass(frozen=True)
+class CommandChanged(Event):
+    """A CLI invocation started (None) or finished with an outcome."""
+
+    outcome: Outcome | None = None
+
+
+@dataclass(frozen=True)
+class WorkChanged(Event):
+    """A channel work snapshot, optionally including the message outcome that caused it."""
+
+    busy: bool
+    completed: Outcome | None = None
+
+
+@dataclass(frozen=True)
+class PromptChanged(Event):
+    """A modal prompt opened (kind) or closed (None)."""
+
+    kind: PromptKind | None

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

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