bog-agents 0.5.2__tar.gz

bog_agents-0.5.2/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: bog-agents
+Version: 0.5.2
+Summary: Bog Agents - batteries-included agent harness for building AI agents. Supports any major provider (Anthropic, OpenAI, AWS Bedrock, Google, etc.) and local models via Ollama. Built on LangGraph.
+Author-email: bogware <support@bogware.com>
+Maintainer-email: bogware <support@bogware.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bogware/bog-agents
+Project-URL: Repository, https://github.com/bogware/bog-agents
+Project-URL: Issues, https://github.com/bogware/bog-agents/issues
+Keywords: agents,ai,llm,langgraph,langchain,bog-agents,sub-agents,agentic,multi-provider,ollama
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core<2.0.0,>=1.2.18
+Requires-Dist: langchain<2.0.0,>=1.2.11
+Requires-Dist: langchain-anthropic<2.0.0,>=1.3.4
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.0
+Requires-Dist: wcmatch
+Provides-Extra: serve
+Requires-Dist: starlette>=0.41.0; extra == "serve"
+Requires-Dist: uvicorn>=0.34.0; extra == "serve"
+Requires-Dist: sse-starlette>=2.0.0; extra == "serve"
+
+# 🧠🤖 Bog Agents
+
+[![PyPI - Version](https://img.shields.io/pypi/v/bog-agents?label=%20)](https://pypi.org/project/bog-agents/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/bog-agents)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/bog-agents)](https://pypistats.org/packages/bog-agents)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain)
+
+Looking for the JS/TS version? Check out [Bog Agents.js](https://github.com/langchain-ai/bog-agentsjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com).
+LangSmith is a unified developer platform for building, testing, and monitoring LLM applications.
+
+## Quick Install
+
+```bash
+pip install bog-agents
+# or
+uv add bog-agents
+```
+
+## Getting Started
+
+1. **Set your API key** (the default model uses Anthropic):
+
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+Or for OpenAI, Google, etc.:
+
+```bash
+export OPENAI_API_KEY="sk-..."
+export GOOGLE_API_KEY="AI..."
+```
+
+2. **Create and run an agent**:
+
+```python
+from bog_agents import create_agent
+
+# Uses Claude Sonnet by default (needs ANTHROPIC_API_KEY)
+agent = create_agent()
+
+# Or specify a different provider
+agent = create_agent(model="openai:gpt-4o")
+agent = create_agent(model="google_genai:gemini-2.0-flash")
+
+# Run the agent
+result = agent.invoke(
+    {"messages": [{"role": "user", "content": "Hello!"}]},
+    config={"configurable": {"thread_id": "my-thread"}},
+)
+```
+
+3. **Run as an HTTP server** (optional):
+
+```bash
+pip install 'bog-agents[serve]'
+```
+
+```python
+from bog_agents import create_agent
+from bog_agents.serve import AgentServer
+
+agent = create_agent()
+server = AgentServer(agent)
+server.run()  # Starts on http://127.0.0.1:8420
+```
+
+## 🤔 What is this?
+
+Using an LLM to call tools in a loop is the simplest form of an agent. This architecture, however, can yield agents that are "shallow" and fail to plan and act over longer, more complex tasks.
+
+Applications like "Deep Research", "Manus", and "Claude Code" have gotten around this limitation by implementing a combination of four things: a **planning tool**, **sub agents**, access to a **file system**, and a **detailed prompt**.
+
+`bog-agents` is a Python package that implements these in a general purpose way so that you can easily create a Bog Agents for your application. For a full overview and quickstart of Bog Agents, the best resource is our [docs](https://docs.langchain.com/oss/python/bog-agents/overview).
+
+**Acknowledgements: This project was primarily inspired by Claude Code, and initially was largely an attempt to see what made Claude Code general purpose, and make it even more so.**
+
+## 🚀 Features
+
+### Core Agent
+- **LangGraph-powered** — composable agent with middleware architecture
+- **Multi-model** — works with Anthropic, OpenAI, Google, DeepSeek, and any LangChain-compatible LLM
+- **Sub-agents** — spawn isolated sub-agents for complex tasks
+- **File system** — read, write, edit, search files with pluggable backends
+- **Planning** — built-in todo list and plan mode for structured task execution
+
+### Middleware (Pluggable)
+
+| Middleware | Description |
+|-----------|-------------|
+| `FilesystemMiddleware` | File read/write/edit/search + multi-edit and batch read |
+| `GitToolsMiddleware` | 9 git tools: status, diff, log, commit, add, branch, stash, blame, show |
+| `RepoMapMiddleware` | Structural code map with symbol extraction (Python, JS, TS, Rust, Go, Java) |
+| `CheckpointingMiddleware` | Git-based snapshots before mutations, with undo/diff |
+| `CostTrackerMiddleware` | Token usage, cost estimation, budget enforcement, effort levels |
+| `PlanModeMiddleware` | Read-only mode that blocks mutating tools |
+| `AutoQualityMiddleware` | Auto-lint/test after edits with project detection |
+| `ArchitectMiddleware` | Dual-model architect/reviewer with cross-model consultation |
+| `ParallelAgentsMiddleware` | Concurrent sub-agent task execution |
+| `LifecycleHooksMiddleware` | 15 event types for external tool integration |
+| `ContextPackingMiddleware` | Smart structured context compression |
+| `SummarizationMiddleware` | Auto-summarization when context window fills |
+| `MemoryMiddleware` | Persistent AGENTS.md memory across sessions |
+| `SkillsMiddleware` | Custom skill/instruction loading |
+| `SafeToolsConfig` | Per-tool auto-approval rules |
+
+### Security
+- **OS-level sandbox** — bubblewrap (Linux), seatbelt (macOS), landlock isolation
+- **Human-in-the-loop** — configurable tool approval with interrupt handling
+
+## 📦 Quick Start
+
+```python
+from bog_agents import create_agent
+
+agent = create_agent(
+    model="anthropic:claude-sonnet-4-6",
+    enable_git_tools=True,
+    enable_repo_map=True,
+    enable_checkpointing=True,
+    enable_cost_tracking=True,
+    enable_plan_mode=True,
+    auto_lint=True,
+    working_dir="/path/to/project",
+)
+
+# Run the agent
+result = await agent.ainvoke(
+    {"messages": [{"role": "user", "content": "Fix the failing tests"}]},
+    config={"configurable": {"thread_id": "my-session"}},
+)
+```
+
+## 📖 Resources
+
+- **[Documentation](https://docs.langchain.com/oss/python/bog-agents)** — Full documentation
+- **[API Reference](https://reference.langchain.com/python/bog-agents/)** — Full SDK reference documentation
+- **[Chat LangChain](https://chat.langchain.com)** - Chat interactively with the docs
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

bog_agents-0.5.2/README.md

@@ -0,0 +1,150 @@
+# 🧠🤖 Bog Agents
+
+[![PyPI - Version](https://img.shields.io/pypi/v/bog-agents?label=%20)](https://pypi.org/project/bog-agents/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/bog-agents)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/bog-agents)](https://pypistats.org/packages/bog-agents)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain)
+
+Looking for the JS/TS version? Check out [Bog Agents.js](https://github.com/langchain-ai/bog-agentsjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com).
+LangSmith is a unified developer platform for building, testing, and monitoring LLM applications.
+
+## Quick Install
+
+```bash
+pip install bog-agents
+# or
+uv add bog-agents
+```
+
+## Getting Started
+
+1. **Set your API key** (the default model uses Anthropic):
+
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+Or for OpenAI, Google, etc.:
+
+```bash
+export OPENAI_API_KEY="sk-..."
+export GOOGLE_API_KEY="AI..."
+```
+
+2. **Create and run an agent**:
+
+```python
+from bog_agents import create_agent
+
+# Uses Claude Sonnet by default (needs ANTHROPIC_API_KEY)
+agent = create_agent()
+
+# Or specify a different provider
+agent = create_agent(model="openai:gpt-4o")
+agent = create_agent(model="google_genai:gemini-2.0-flash")
+
+# Run the agent
+result = agent.invoke(
+    {"messages": [{"role": "user", "content": "Hello!"}]},
+    config={"configurable": {"thread_id": "my-thread"}},
+)
+```
+
+3. **Run as an HTTP server** (optional):
+
+```bash
+pip install 'bog-agents[serve]'
+```
+
+```python
+from bog_agents import create_agent
+from bog_agents.serve import AgentServer
+
+agent = create_agent()
+server = AgentServer(agent)
+server.run()  # Starts on http://127.0.0.1:8420
+```
+
+## 🤔 What is this?
+
+Using an LLM to call tools in a loop is the simplest form of an agent. This architecture, however, can yield agents that are "shallow" and fail to plan and act over longer, more complex tasks.
+
+Applications like "Deep Research", "Manus", and "Claude Code" have gotten around this limitation by implementing a combination of four things: a **planning tool**, **sub agents**, access to a **file system**, and a **detailed prompt**.
+
+`bog-agents` is a Python package that implements these in a general purpose way so that you can easily create a Bog Agents for your application. For a full overview and quickstart of Bog Agents, the best resource is our [docs](https://docs.langchain.com/oss/python/bog-agents/overview).
+
+**Acknowledgements: This project was primarily inspired by Claude Code, and initially was largely an attempt to see what made Claude Code general purpose, and make it even more so.**
+
+## 🚀 Features
+
+### Core Agent
+- **LangGraph-powered** — composable agent with middleware architecture
+- **Multi-model** — works with Anthropic, OpenAI, Google, DeepSeek, and any LangChain-compatible LLM
+- **Sub-agents** — spawn isolated sub-agents for complex tasks
+- **File system** — read, write, edit, search files with pluggable backends
+- **Planning** — built-in todo list and plan mode for structured task execution
+
+### Middleware (Pluggable)
+
+| Middleware | Description |
+|-----------|-------------|
+| `FilesystemMiddleware` | File read/write/edit/search + multi-edit and batch read |
+| `GitToolsMiddleware` | 9 git tools: status, diff, log, commit, add, branch, stash, blame, show |
+| `RepoMapMiddleware` | Structural code map with symbol extraction (Python, JS, TS, Rust, Go, Java) |
+| `CheckpointingMiddleware` | Git-based snapshots before mutations, with undo/diff |
+| `CostTrackerMiddleware` | Token usage, cost estimation, budget enforcement, effort levels |
+| `PlanModeMiddleware` | Read-only mode that blocks mutating tools |
+| `AutoQualityMiddleware` | Auto-lint/test after edits with project detection |
+| `ArchitectMiddleware` | Dual-model architect/reviewer with cross-model consultation |
+| `ParallelAgentsMiddleware` | Concurrent sub-agent task execution |
+| `LifecycleHooksMiddleware` | 15 event types for external tool integration |
+| `ContextPackingMiddleware` | Smart structured context compression |
+| `SummarizationMiddleware` | Auto-summarization when context window fills |
+| `MemoryMiddleware` | Persistent AGENTS.md memory across sessions |
+| `SkillsMiddleware` | Custom skill/instruction loading |
+| `SafeToolsConfig` | Per-tool auto-approval rules |
+
+### Security
+- **OS-level sandbox** — bubblewrap (Linux), seatbelt (macOS), landlock isolation
+- **Human-in-the-loop** — configurable tool approval with interrupt handling
+
+## 📦 Quick Start
+
+```python
+from bog_agents import create_agent
+
+agent = create_agent(
+    model="anthropic:claude-sonnet-4-6",
+    enable_git_tools=True,
+    enable_repo_map=True,
+    enable_checkpointing=True,
+    enable_cost_tracking=True,
+    enable_plan_mode=True,
+    auto_lint=True,
+    working_dir="/path/to/project",
+)
+
+# Run the agent
+result = await agent.ainvoke(
+    {"messages": [{"role": "user", "content": "Fix the failing tests"}]},
+    config={"configurable": {"thread_id": "my-session"}},
+)
+```
+
+## 📖 Resources
+
+- **[Documentation](https://docs.langchain.com/oss/python/bog-agents)** — Full documentation
+- **[API Reference](https://reference.langchain.com/python/bog-agents/)** — Full SDK reference documentation
+- **[Chat LangChain](https://chat.langchain.com)** - Chat interactively with the docs
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

bog_agents-0.5.2/bog_agents/__init__.py

@@ -0,0 +1,120 @@
+"""Bog Agents package.
+
+Middleware classes are loaded lazily — they are only imported when first accessed.
+This keeps ``import bog_agents`` fast.
+"""
+
+from bog_agents._version import __version__
+from bog_agents.feature_config import FeatureConfig
+from bog_agents.graph import create_agent
+
+# Lazy-loaded symbols: maps exported name → (module_path, attribute_name)
+_LAZY_IMPORTS: dict[str, tuple[str, str]] = {
+    "AdaptiveContextMiddleware": ("bog_agents.middleware.adaptive_context", "AdaptiveContextMiddleware"),
+    "AgentReplayMiddleware": ("bog_agents.middleware.agent_replay", "AgentReplayMiddleware"),
+    "AgentTeamsMiddleware": ("bog_agents.middleware.agent_teams", "AgentTeamsMiddleware"),
+    "AirGappedMiddleware": ("bog_agents.middleware.air_gapped", "AirGappedMiddleware"),
+    "ApprovalGatesMiddleware": ("bog_agents.middleware.approval_gates", "ApprovalGatesMiddleware"),
+    "ArchitectMiddleware": ("bog_agents.middleware.architect", "ArchitectMiddleware"),
+    "AuditTrailMiddleware": ("bog_agents.middleware.audit_trail", "AuditTrailMiddleware"),
+    "AutoQualityMiddleware": ("bog_agents.middleware.auto_quality", "AutoQualityMiddleware"),
+    "AutomationsMiddleware": ("bog_agents.middleware.automations", "AutomationsMiddleware"),
+    "BrowserAgentFAMiddleware": ("bog_agents.middleware.browser_agent_fa", "BrowserAgentFAMiddleware"),
+    "BrowserAgentMiddleware": ("bog_agents.middleware.browser_agent", "BrowserAgentMiddleware"),
+    "CheckpointingMiddleware": ("bog_agents.middleware.checkpointing", "CheckpointingMiddleware"),
+    "CitationsMiddleware": ("bog_agents.middleware.citations", "CitationsMiddleware"),
+    "ClientKnowledgeBaseMiddleware": ("bog_agents.middleware.client_knowledge_base", "ClientKnowledgeBaseMiddleware"),
+    "ClientReportsMiddleware": ("bog_agents.middleware.client_reports", "ClientReportsMiddleware"),
+    "CloudSandboxMiddleware": ("bog_agents.middleware.cloud_sandbox", "CloudSandboxMiddleware"),
+    "CodeIntelligenceMiddleware": ("bog_agents.middleware.code_intelligence", "CodeIntelligenceMiddleware"),
+    "CodeReviewMiddleware": ("bog_agents.middleware.code_review", "CodeReviewMiddleware"),
+    "CollaborativeSessionsMiddleware": ("bog_agents.middleware.collaborative_sessions", "CollaborativeSessionsMiddleware"),
+    "CompetitiveIntelMiddleware": ("bog_agents.middleware.competitive_intel", "CompetitiveIntelMiddleware"),
+    "CompiledSubAgent": ("bog_agents.middleware.subagents", "CompiledSubAgent"),
+    "ComputerUseMiddleware": ("bog_agents.middleware.computer_use", "ComputerUseMiddleware"),
+    "ContextPackingMiddleware": ("bog_agents.middleware.context_packing", "ContextPackingMiddleware"),
+    "ConversationBranchMiddleware": ("bog_agents.middleware.conversation_branch", "ConversationBranchMiddleware"),
+    "CostTrackerMiddleware": ("bog_agents.middleware.cost_tracker", "CostTrackerMiddleware"),
+    "DLPMiddleware": ("bog_agents.middleware.dlp", "DLPMiddleware"),
+    "DashboardMiddleware": ("bog_agents.middleware.dashboard", "DashboardMiddleware"),
+    "DeepResearchMiddleware": ("bog_agents.middleware.deep_research", "DeepResearchMiddleware"),
+    "DueDiligenceMiddleware": ("bog_agents.middleware.due_diligence", "DueDiligenceMiddleware"),
+    "EarningsAnalysisMiddleware": ("bog_agents.middleware.earnings_analysis", "EarningsAnalysisMiddleware"),
+    "EnhancedSkillsMiddleware": ("bog_agents.middleware.enhanced_skills", "EnhancedSkillsMiddleware"),
+    "EnterpriseMiddleware": ("bog_agents.middleware.enterprise", "EnterpriseMiddleware"),
+    "FactCheckMiddleware": ("bog_agents.middleware.fact_check", "FactCheckMiddleware"),
+    "FilesystemMiddleware": ("bog_agents.middleware.filesystem", "FilesystemMiddleware"),
+    "FinancialDataMiddleware": ("bog_agents.middleware.financial_data", "FinancialDataMiddleware"),
+    "FirmDeploymentMiddleware": ("bog_agents.middleware.firm_deployment", "FirmDeploymentMiddleware"),
+    "GitToolsMiddleware": ("bog_agents.middleware.git_tools", "GitToolsMiddleware"),
+    "HallucinationDetectionMiddleware": ("bog_agents.middleware.hallucination_detection", "HallucinationDetectionMiddleware"),
+    "HotReloadSkillsMiddleware": ("bog_agents.middleware.hot_reload_skills", "HotReloadSkillsMiddleware"),
+    "HttpHooksMiddleware": ("bog_agents.middleware.http_hooks", "HttpHooksMiddleware"),
+    "ImageInputMiddleware": ("bog_agents.middleware.image_input", "ImageInputMiddleware"),
+    "ImagePdfInputMiddleware": ("bog_agents.middleware.image_pdf_input", "ImagePdfInputMiddleware"),
+    "KnowledgeGraphMiddleware": ("bog_agents.middleware.knowledge_graph", "KnowledgeGraphMiddleware"),
+    "LifecycleHooksMiddleware": ("bog_agents.middleware.lifecycle_hooks", "LifecycleHooksMiddleware"),
+    "MarketSentimentMiddleware": ("bog_agents.middleware.market_sentiment", "MarketSentimentMiddleware"),
+    "MeetingPrepMiddleware": ("bog_agents.middleware.meeting_prep", "MeetingPrepMiddleware"),
+    "MemoryMiddleware": ("bog_agents.middleware.memory", "MemoryMiddleware"),
+    "MessagingIntegrationMiddleware": ("bog_agents.middleware.messaging_integration", "MessagingIntegrationMiddleware"),
+    "ModelCascadeMiddleware": ("bog_agents.middleware.model_cascade", "ModelCascadeMiddleware"),
+    "ModelPortfolioMiddleware": ("bog_agents.middleware.model_portfolio", "ModelPortfolioMiddleware"),
+    "MultiAgentOrchestratorMiddleware": ("bog_agents.middleware.multi_agent_orchestrator", "MultiAgentOrchestratorMiddleware"),
+    "MultiModelMiddleware": ("bog_agents.middleware.multi_model", "MultiModelMiddleware"),
+    "NLQueryMiddleware": ("bog_agents.middleware.nl_query", "NLQueryMiddleware"),
+    "NotificationsMiddleware": ("bog_agents.middleware.notifications", "NotificationsMiddleware"),
+    "OfflineModeMiddleware": ("bog_agents.middleware.offline_mode", "OfflineModeMiddleware"),
+    "OpenSearchRAGMiddleware": ("bog_agents.middleware.opensearch_rag", "OpenSearchRAGMiddleware"),
+    "PRManagementMiddleware": ("bog_agents.middleware.pr_management", "PRManagementMiddleware"),
+    "ParallelAgentsMiddleware": ("bog_agents.middleware.parallel_agents", "ParallelAgentsMiddleware"),
+    "PeerComparisonMiddleware": ("bog_agents.middleware.peer_comparison", "PeerComparisonMiddleware"),
+    "PlanModeMiddleware": ("bog_agents.middleware.plan_mode", "PlanModeMiddleware"),
+    "PluginSystemMiddleware": ("bog_agents.middleware.plugin_system", "PluginSystemMiddleware"),
+    "PortfolioAnalysisMiddleware": ("bog_agents.middleware.portfolio_analysis", "PortfolioAnalysisMiddleware"),
+    "RBACMiddleware": ("bog_agents.middleware.rbac", "RBACMiddleware"),
+    "ReasoningChainMiddleware": ("bog_agents.middleware.reasoning_chain", "ReasoningChainMiddleware"),
+    "RegulatoryAlertsMiddleware": ("bog_agents.middleware.regulatory_alerts", "RegulatoryAlertsMiddleware"),
+    "RegulatoryImpactMiddleware": ("bog_agents.middleware.regulatory_impact", "RegulatoryImpactMiddleware"),
+    "RepoMapMiddleware": ("bog_agents.middleware.repo_map", "RepoMapMiddleware"),
+    "SSOAuthMiddleware": ("bog_agents.middleware.sso_auth", "SSOAuthMiddleware"),
+    "SafeToolsConfig": ("bog_agents.middleware.safe_tools", "SafeToolsConfig"),
+    "SavedPromptsMiddleware": ("bog_agents.middleware.saved_prompts", "SavedPromptsMiddleware"),
+    "ScenarioEngineMiddleware": ("bog_agents.middleware.scenario_engine", "ScenarioEngineMiddleware"),
+    "ScheduledReportsMiddleware": ("bog_agents.middleware.scheduled_reports", "ScheduledReportsMiddleware"),
+    "ScheduledRunsMiddleware": ("bog_agents.middleware.scheduled_runs", "ScheduledRunsMiddleware"),
+    "SecurityAuditMiddleware": ("bog_agents.middleware.security_audit", "SecurityAuditMiddleware"),
+    "SelfImprovingMiddleware": ("bog_agents.middleware.self_improving", "SelfImprovingMiddleware"),
+    "SmartApprovalsMiddleware": ("bog_agents.middleware.smart_approvals", "SmartApprovalsMiddleware"),
+    "SmartContextMiddleware": ("bog_agents.middleware.smart_context", "SmartContextMiddleware"),
+    "SubAgent": ("bog_agents.middleware.subagents", "SubAgent"),
+    "SubAgentMiddleware": ("bog_agents.middleware.subagents", "SubAgentMiddleware"),
+    "TaxOptimizationMiddleware": ("bog_agents.middleware.tax_optimization", "TaxOptimizationMiddleware"),
+    "TestGenerationMiddleware": ("bog_agents.middleware.test_generation", "TestGenerationMiddleware"),
+    "VersionControlMiddleware": ("bog_agents.middleware.version_control", "VersionControlMiddleware"),
+    "VoiceIOMiddleware": ("bog_agents.middleware.voice_io", "VoiceIOMiddleware"),
+    "WorktreeMiddleware": ("bog_agents.middleware.worktree", "WorktreeMiddleware"),
+}
+
+
+def __getattr__(name: str) -> object:
+    """Lazy-load middleware classes on first access."""
+    if name in _LAZY_IMPORTS:
+        module_path, attr_name = _LAZY_IMPORTS[name]
+        import importlib
+
+        module = importlib.import_module(module_path)
+        value = getattr(module, attr_name)
+        # Cache in module namespace so subsequent accesses are fast
+        globals()[name] = value
+        return value
+    msg = f"module {__name__!r} has no attribute {name!r}"
+    raise AttributeError(msg)
+
+
+__all__ = [  # noqa: PLE0604
+    "FeatureConfig",
+    "__version__",
+    "create_agent",
+    *_LAZY_IMPORTS,
+]

bog_agents-0.5.2/bog_agents/_models.py

@@ -0,0 +1,81 @@
+"""Shared helpers for resolving and inspecting chat models."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from langchain.chat_models import init_chat_model
+from langchain_core.language_models import BaseChatModel
+
+
+def resolve_model(model: str | BaseChatModel) -> BaseChatModel:
+    """Resolve a model string to a `BaseChatModel`.
+
+    If `model` is already a `BaseChatModel`, returns it unchanged.
+
+    String models are resolved via `init_chat_model`. OpenAI models
+    (prefixed with `openai:`) default to the Responses API.
+
+    Args:
+        model: Model string or pre-configured model instance.
+
+    Returns:
+        Resolved `BaseChatModel` instance.
+    """
+    if isinstance(model, BaseChatModel):
+        return model
+    if model.startswith("openai:"):
+        return init_chat_model(model, use_responses_api=True)
+    return init_chat_model(model)
+
+
+def get_model_identifier(model: BaseChatModel) -> str | None:
+    """Extract the provider-native model identifier from a chat model.
+
+    Providers do not agree on a single field name for the identifier. Some use
+    `model_name`, while others use `model`. Reading the serialized model config
+    lets us inspect both without relying on reflective attribute access.
+
+    Args:
+        model: Chat model instance to inspect.
+
+    Returns:
+        The configured model identifier, or `None` if it is unavailable.
+    """
+    config = model.model_dump()
+    return _string_value(config, "model_name") or _string_value(config, "model")
+
+
+def model_matches_spec(model: BaseChatModel, spec: str) -> bool:
+    """Check whether a model instance already matches a string model spec.
+
+    Matching is performed in two ways: first by exact string equality between
+    `spec` and the model identifier, then by comparing only the model-name
+    portion of a `provider:model` spec against the identifier. For example,
+    `"openai:gpt-5"` matches a model with identifier `"gpt-5"`.
+
+    Assumes the `provider:model` convention (single colon separator).
+
+    Args:
+        model: Chat model instance to inspect.
+        spec: Model spec in `provider:model` format (e.g., `openai:gpt-5`).
+
+    Returns:
+        `True` if the model already matches the spec, otherwise `False`.
+    """
+    current = get_model_identifier(model)
+    if current is None:
+        return False
+    if spec == current:
+        return True
+
+    _, separator, model_name = spec.partition(":")
+    return bool(separator) and model_name == current
+
+
+def _string_value(config: dict[str, Any], key: str) -> str | None:
+    """Return a non-empty string value from a serialized model config."""
+    value = config.get(key)
+    if isinstance(value, str) and value:
+        return value
+    return None

bog_agents-0.5.2/bog_agents/_version.py

@@ -0,0 +1,3 @@
+"""Version information for `bog-agents` (SDK)."""
+
+__version__ = "0.5.2"  # x-release-please-version

bog_agents-0.5.2/bog_agents/backends/__init__.py

@@ -0,0 +1,24 @@
+"""Memory backends for pluggable file storage."""
+
+from bog_agents.backends.composite import CompositeBackend
+from bog_agents.backends.filesystem import FilesystemBackend
+from bog_agents.backends.local_shell import DEFAULT_EXECUTE_TIMEOUT, LocalShellBackend
+from bog_agents.backends.protocol import BackendProtocol
+from bog_agents.backends.state import StateBackend
+from bog_agents.backends.store import (
+    BackendContext,
+    NamespaceFactory,
+    StoreBackend,
+)
+
+__all__ = [
+    "DEFAULT_EXECUTE_TIMEOUT",
+    "BackendContext",
+    "BackendProtocol",
+    "CompositeBackend",
+    "FilesystemBackend",
+    "LocalShellBackend",
+    "NamespaceFactory",
+    "StateBackend",
+    "StoreBackend",
+]