bub 0.4.3__tar.gz → 0.5.0__tar.gz

{bub-0.4.3 → bub-0.5.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: bub
-Version: 0.4.3
-Summary: A common shape for agents that live alongside people.
+Version: 0.5.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
@@ -16,24 +16,31 @@ 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: aiohttp>=3.13.3
-Requires-Dist: any-llm-sdk[anthropic]
+Requires-Dist: aiohttp>=3.14.3
+Requires-Dist: any-llm-sdk[anthropic]>=1.22.1
 Requires-Dist: authlib>=1.7.2
 Requires-Dist: httpx[socks]>=0.28.1
-Requires-Dist: inquirer-textual>=0.5.1
-Requires-Dist: loguru>=0.7.2
+Requires-Dist: inquirer-textual>=0.8.0
+Requires-Dist: loguru>=0.7.3
 Requires-Dist: pluggy>=1.6.0
-Requires-Dist: prompt-toolkit>=3.0.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: python-telegram-bot>=21.0
-Requires-Dist: pyyaml>=6.0.0
-Requires-Dist: rapidfuzz>=3.14.3
-Requires-Dist: rich>=13.0.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: typing-extensions>=4.13.0
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pydantic-settings>=2.14.2
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-telegram-bot>=22.7
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rapidfuzz>=3.14.5
+Requires-Dist: rich>=14.3.4
+Requires-Dist: typer>=0.24.1
+Requires-Dist: typing-extensions>=4.15.0
 Provides-Extra: logfire
-Requires-Dist: logfire>=4.31.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'
+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
@@ -45,7 +52,7 @@ Description-Content-Type: text/markdown
   <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 hook-first runtime for agents that live alongside people.</strong></p>
+<p><strong>A tiny agent runtime, composable with plugins.</strong></p>
 
 </div>
 
@@ -57,8 +64,26 @@ Built on [agents.md](https://agents.md/) and [Agent Skills](https://agentskills.
 
 ## 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"
+```
+
+The interactive installer uses a colored preset picker, accepts additional plugin dependencies, and runs `bub onboard` after installation. For automation, select a preset explicitly; non-interactive installs skip onboarding:
+
 ```bash
-pip install bub
+curl -fsSL https://bub.build/install.sh | bash -s -- --preset recommended --dependency extra-plugin
+```
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "& ([scriptblock]::Create((irm https://bub.build/install.ps1))) --preset recommended --dependency extra-plugin"
 ```
 
 Or from source:
@@ -72,14 +97,14 @@ uv sync  # enough to run Bub from source
 For local development, use `make install` instead so the website toolchain and `prek` hooks are installed too.
 
 ```bash
-uv run bub chat                         # interactive session
-uv run bub run "summarize this repo"    # one-shot task
-uv run bub gateway                      # channel listener mode
+bub chat                         # interactive session
+bub run "summarize this repo"    # one-shot task
+bub gateway                      # channel listener mode
 ```
 
 ## Why Bub
 
-- **Hook-first runtime.** Every turn stage is a hook. Override one stage or replace the whole flow without forking the runtime.
+- **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.
@@ -158,6 +183,7 @@ Lines starting with `,` enter internal command mode (`,help`, `,skill name=my-sk
 | `BUB_MAX_STEPS`             | unlimited                    | Tool-use loop limit; must be a positive integer      |
 | `BUB_MAX_TOKENS`            | `16384`                      | Max tokens per model call                            |
 | `BUB_MODEL_TIMEOUT_SECONDS` | —                            | Model call timeout (seconds)                         |
+| `BUB_SPILL_THRESHOLD`       | `4096`                       | Estimated tokens before tool output spills; `0` disables |
 
 ## Background
 

{bub-0.4.3 → bub-0.5.0}/README.md

@@ -7,7 +7,7 @@
   <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 hook-first runtime for agents that live alongside people.</strong></p>
+<p><strong>A tiny agent runtime, composable with plugins.</strong></p>
 
 </div>
 
@@ -19,8 +19,26 @@ Built on [agents.md](https://agents.md/) and [Agent Skills](https://agentskills.
 
 ## 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"
+```
+
+The interactive installer uses a colored preset picker, accepts additional plugin dependencies, and runs `bub onboard` after installation. For automation, select a preset explicitly; non-interactive installs skip onboarding:
+
 ```bash
-pip install bub
+curl -fsSL https://bub.build/install.sh | bash -s -- --preset recommended --dependency extra-plugin
+```
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "& ([scriptblock]::Create((irm https://bub.build/install.ps1))) --preset recommended --dependency extra-plugin"
 ```
 
 Or from source:
@@ -34,14 +52,14 @@ uv sync  # enough to run Bub from source
 For local development, use `make install` instead so the website toolchain and `prek` hooks are installed too.
 
 ```bash
-uv run bub chat                         # interactive session
-uv run bub run "summarize this repo"    # one-shot task
-uv run bub gateway                      # channel listener mode
+bub chat                         # interactive session
+bub run "summarize this repo"    # one-shot task
+bub gateway                      # channel listener mode
 ```
 
 ## Why Bub
 
-- **Hook-first runtime.** Every turn stage is a hook. Override one stage or replace the whole flow without forking the runtime.
+- **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.
@@ -120,6 +138,7 @@ Lines starting with `,` enter internal command mode (`,help`, `,skill name=my-sk
 | `BUB_MAX_STEPS`             | unlimited                    | Tool-use loop limit; must be a positive integer      |
 | `BUB_MAX_TOKENS`            | `16384`                      | Max tokens per model call                            |
 | `BUB_MODEL_TIMEOUT_SECONDS` | —                            | Model call timeout (seconds)                         |
+| `BUB_SPILL_THRESHOLD`       | `4096`                       | Estimated tokens before tool output spills; `0` disables |
 
 ## Background
 

{bub-0.4.3 → bub-0.5.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "bub"
 dynamic = ["version"]
-description = "A common shape for agents that live alongside people."
+description = "A tiny agent runtime, composable with plugins."
 authors = [
     { name = "Chojan Shang", email = "psiace@apache.org" },
     { name = "Frost Ming", email = "me@frostming.com" },
@@ -21,22 +21,22 @@ classifiers = [
 ]
 
 dependencies = [
-    "pydantic>=2.0.0",
-    "pydantic-settings>=2.0.0",
-    "pyyaml>=6.0.0",
+    "pydantic>=2.12.5",
+    "pydantic-settings>=2.14.2",
+    "pyyaml>=6.0.3",
     "pluggy>=1.6.0",
-    "inquirer-textual>=0.5.1",
-    "typer>=0.9.0",
+    "inquirer-textual>=0.8.0",
+    "typer>=0.24.1",
     "authlib>=1.7.2",
-    "any-llm-sdk[anthropic]",
-    "rich>=13.0.0",
-    "prompt-toolkit>=3.0.0",
-    "python-telegram-bot>=21.0",
-    "loguru>=0.7.2",
-    "rapidfuzz>=3.14.3",
-    "aiohttp>=3.13.3",
+    "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.13.0",
+    "typing-extensions>=4.15.0",
 ]
 
 [project.urls]
@@ -48,18 +48,24 @@ Documentation = "https://bub.build"
 bub = "bub.__main__:app"
 
 [project.optional-dependencies]
+trace = [
+    "opentelemetry-api>=1.39.0",
+    "opentelemetry-sdk>=1.39.0",
+    "opentelemetry-exporter-otlp-proto-http>=1.39.0",
+]
 logfire = [
-    "logfire>=4.31.0",
+    "bub[trace]",
+    "logfire>=4.32.0",
 ]
 
 [dependency-groups]
 dev = [
-    "pytest>=7.2.0",
-    "tox-uv>=1.11.3",
-    "types-PyYAML>=6.0.12",
-    "mypy>=0.991",
-    "ruff>=0.11.5",
-    "prek>=0.3.1",
+    "pytest>=9.0.3",
+    "tox-uv>=1.35.1",
+    "types-PyYAML>=6.0.12.20260408",
+    "mypy>=1.20.0",
+    "ruff>=0.15.10",
+    "prek>=0.3.8",
     "pytest-asyncio>=1.3.0",
 ]
 

{bub-0.4.3 → bub-0.5.0}/src/bub/__main__.py

@@ -2,32 +2,49 @@
 
 from __future__ import annotations
 
+import os
 import sys
 
 import typer
 
+from bub.builtin.settings import load_settings
 from bub.framework import BubFramework
 
+LOG_LEVEL = {
+    0: "INFO",
+    1: "DEBUG",
+    2: "TRACE",
+}
 
-def _instrument_bub() -> None:
+
+def _instrument_bub(level: str) -> None:
     from loguru import logger
 
     logger.remove()
-    logger.add(sys.stderr, colorize=True)
+    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(), format="{message}")
+        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:
-    _instrument_bub()
     framework = BubFramework()
+    _instrument_bub(LOG_LEVEL[load_settings().verbose])
     framework.load_hooks()
     app = framework.create_cli_app()
 

{bub-0.4.3 → bub-0.5.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.4.3'
-__version_tuple__ = version_tuple = (0, 4, 3)
+__version__ = version = '0.5.0'
+__version_tuple__ = version_tuple = (0, 5, 0)
 
 __commit_id__ = commit_id = None

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

@@ -0,0 +1,3 @@
+from .agent import Agent
+
+__all__ = ["Agent"]