feat: add streaming server and GitHub toolset

[bordumb]

Summary

• Streaming Server: Production-ready SSE/WebSocket server for any Bond agent
• GitHub Toolset: 6 tools to browse and analyze any GitHub repository
• Composite Dependencies: BondToolDeps enables using multiple toolsets together

New Modules

bond.server

from bond import BondAgent
from bond.server import create_bond_server

agent = BondAgent(name="assistant", instructions="...", model="openai:gpt-4o")
app = create_bond_server(agent)
# uvicorn main:app

Endpoints:

• POST /ask - Start session, get session_id
• GET /stream/{session_id} - SSE stream
• WS /ws - WebSocket bidirectional
• GET /health - Health check

bond.tools.github

from bond.tools import github_toolset, GitHubAdapter

agent = BondAgent(
    toolsets=[github_toolset],
    deps=GitHubAdapter(token=os.environ["GITHUB_TOKEN"]),
)
await agent.ask("What's in the facebook/react repo?")

Tools: github_get_repo, github_list_files, github_read_file, github_search_code, github_get_commits, github_get_pr

BondToolDeps

from bond.tools import BondToolDeps, github_toolset, githunter_toolset

deps = BondToolDeps(github_token=os.environ["GITHUB_TOKEN"])
agent = BondAgent(toolsets=[github_toolset, githunter_toolset], deps=deps)

Files Changed

New:

• src/bond/server/ - Server module (5 files)
• src/bond/tools/github/ - GitHub toolset (7 files)
• src/bond/tools/_composite.py - Composite dependencies
• docs/guides/streaming-server.md - Server integration guide
• docs/guides/github.md - GitHub toolset guide
• tests/unit/server/ - Server tests
• tests/unit/tools/github/ - GitHub tests

Modified:

• pyproject.toml - Added httpx dep, server optional deps
• src/bond/__init__.py - Lazy import for server
• src/bond/tools/__init__.py - Export new toolsets
• mkdocs.yml - Navigation updates

Test plan

• pytest tests/unit/server/ tests/unit/tools/github/ - 36 tests pass
• pytest tests/ - All 219 tests pass
• ruff check - No linting errors
• Manual: Run server with uvicorn, connect from UI

🤖 Generated with Claude Code