by-framework-langgraph 0.2.0__tar.gz

by_framework_langgraph-0.2.0/.gitignore

@@ -0,0 +1,68 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Environment
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+dist/
+.cache/
+.next/
+out/
+.next-env.d.ts
+
+# IDEs / Editors
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Project Specific
+.worktrees/
+*.log
+.gemini/
+/brain/
+.agents/
+.agent/
+*gateway-sdk.log*
+.claude/settings.local.json
+.claude/settings.json

by_framework_langgraph-0.2.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: by-framework-langgraph
+Version: 0.2.0
+Summary: LangGraph integration for by-framework
+Requires-Python: >=3.12
+Requires-Dist: by-framework>=1.0.0
+Requires-Dist: langchain-core>=1.2.28
+Requires-Dist: langgraph>=1.1.6
+Provides-Extra: dev
+Requires-Dist: isort>=5.13.0; extra == 'dev'
+Requires-Dist: pyink>=24.0.0; extra == 'dev'
+Requires-Dist: pylint>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: langfuse
+Requires-Dist: by-framework-trace-langfuse>=0.2.0; extra == 'langfuse'
+Provides-Extra: phoenix
+Requires-Dist: by-framework-trace-phoenix>=0.2.0; extra == 'phoenix'
+Requires-Dist: openinference-instrumentation-langchain>=0.1.0; extra == 'phoenix'
+Requires-Dist: openinference-instrumentation-openai>=0.1.0; extra == 'phoenix'
+Description-Content-Type: text/markdown
+
+# by-framework-langgraph
+
+LangGraph integration for by-framework. Provides two integration modes:
+
+1. **Adapter Mode** — Plug existing LangGraph graphs into by-framework with one line
+2. **Native Mode** — Build LangGraph workers with native `call_agent` / `ask_user` / `resume` support
+
+## Installation
+
+```bash
+uv add by-framework-langgraph
+```
+
+## Quick Start
+
+### Adapter Mode — Plug in existing graphs
+
+```python
+from by_framework.worker import ByaiWorker
+from by_framework_langgraph import LangGraphAdapter
+
+class MyWorker(ByaiWorker):
+    def get_agent_types(self):
+        return ["my-agent"]
+
+    async def process_command(self, command, context):
+        graph = build_my_existing_graph()  # your existing LangGraph
+        adapter = LangGraphAdapter(graph, context)
+        return await adapter.run(command)
+```
+
+### Native Mode — Framework-native LangGraph workers
+
+```python
+from by_framework_langgraph import LangGraphWorker, make_remote_agent_tool, make_ask_user_tool
+
+class OrchestratorWorker(LangGraphWorker):
+    def get_agent_types(self):
+        return ["orchestrator"]
+
+    def build_graph(self, context, command):
+        poet = make_remote_agent_tool(context, "invoke_poet", "poet-agent", "调度诗人创作")
+        ask = make_ask_user_tool(context)
+        llm = ChatOpenAI(model="gpt-4o").bind_tools([poet, ask])
+        # ... build and return compiled graph
+```

by_framework_langgraph-0.2.0/README.md

@@ -0,0 +1,46 @@
+# by-framework-langgraph
+
+LangGraph integration for by-framework. Provides two integration modes:
+
+1. **Adapter Mode** — Plug existing LangGraph graphs into by-framework with one line
+2. **Native Mode** — Build LangGraph workers with native `call_agent` / `ask_user` / `resume` support
+
+## Installation
+
+```bash
+uv add by-framework-langgraph
+```
+
+## Quick Start
+
+### Adapter Mode — Plug in existing graphs
+
+```python
+from by_framework.worker import ByaiWorker
+from by_framework_langgraph import LangGraphAdapter
+
+class MyWorker(ByaiWorker):
+    def get_agent_types(self):
+        return ["my-agent"]
+
+    async def process_command(self, command, context):
+        graph = build_my_existing_graph()  # your existing LangGraph
+        adapter = LangGraphAdapter(graph, context)
+        return await adapter.run(command)
+```
+
+### Native Mode — Framework-native LangGraph workers
+
+```python
+from by_framework_langgraph import LangGraphWorker, make_remote_agent_tool, make_ask_user_tool
+
+class OrchestratorWorker(LangGraphWorker):
+    def get_agent_types(self):
+        return ["orchestrator"]
+
+    def build_graph(self, context, command):
+        poet = make_remote_agent_tool(context, "invoke_poet", "poet-agent", "调度诗人创作")
+        ask = make_ask_user_tool(context)
+        llm = ChatOpenAI(model="gpt-4o").bind_tools([poet, ask])
+        # ... build and return compiled graph
+```

by_framework_langgraph-0.2.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "by-framework-langgraph"
+version = "0.2.0"
+description = "LangGraph integration for by-framework"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "by-framework>=1.0.0",
+    "langgraph>=1.1.6",
+    "langchain-core>=1.2.28",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "isort>=5.13.0",
+    "pyink>=24.0.0",
+    "pylint>=3.0.0",
+    "ruff>=0.3.0",
+]
+langfuse = [
+    "by-framework-trace-langfuse>=0.2.0",
+]
+phoenix = [
+    "by-framework-trace-phoenix>=0.2.0",
+    "openinference-instrumentation-langchain>=0.1.0",
+    "openinference-instrumentation-openai>=0.1.0",
+]
+
+[tool.uv.sources]
+by-framework = { workspace = true }
+by-framework-trace-langfuse = { workspace = true }
+by-framework-trace-phoenix = { workspace = true }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/by_framework_langgraph"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src", "../../src"]
+testpaths = ["tests"]

by_framework_langgraph-0.2.0/src/by_framework_langgraph/__init__.py

@@ -0,0 +1,36 @@
+"""LangGraph integration for by-framework.
+
+Provides two integration modes:
+
+1. **Adapter Mode** — Plug existing LangGraph graphs into by-framework::
+
+       from by_framework_langgraph import LangGraphAdapter
+
+       adapter = LangGraphAdapter(my_graph, context)
+       return await adapter.run(command)
+
+2. **Native Mode** — Build LangGraph workers with framework-native tools::
+
+       from by_framework_langgraph import (
+           LangGraphWorker,
+           make_remote_agent_tool,
+           make_ask_user_tool,
+       )
+
+       class MyWorker(LangGraphWorker):
+           def build_graph(self, context, command):
+               poet = make_remote_agent_tool(context, ...)
+               ask = make_ask_user_tool(context)
+               # ... build and return compiled graph
+"""
+
+from .adapter import LangGraphAdapter
+from .tools import make_ask_user_tool, make_remote_agent_tool
+from .worker import LangGraphWorker
+
+__all__ = [
+    "LangGraphAdapter",
+    "LangGraphWorker",
+    "make_ask_user_tool",
+    "make_remote_agent_tool",
+]

by_framework_langgraph-0.2.0/src/by_framework_langgraph/_utils.py

@@ -0,0 +1,64 @@
+"""Internal utilities for LangGraph integration."""
+
+from __future__ import annotations
+
+import hashlib
+from typing import Any
+
+from by_framework.core.protocol.commands import ResumeCommand
+
+
+def extract_content_text(content: Any) -> str:
+    """Extract plain text from various command content formats.
+
+    Handles:
+    - str → return directly
+    - list[dict] (BaiYing message format) → extract text fields
+    - other → str() conversion
+    """
+    if isinstance(content, str):
+        return content
+
+    if isinstance(content, list):
+        texts: list[str] = []
+        for item in content:
+            if isinstance(item, dict):
+                # BaiYing message format: {"type": "text", "text": "..."}
+                text = item.get("text", "")
+                if text:
+                    texts.append(str(text))
+                # Fallback: {"content": "..."}
+                elif "content" in item:
+                    texts.append(str(item["content"]))
+            elif isinstance(item, str):
+                texts.append(item)
+        return "\n".join(texts) if texts else str(content)
+
+    return str(content)
+
+
+def extract_resume_data(command: ResumeCommand) -> str:
+    """Extract resume data from a ResumeCommand.
+
+    Prioritizes reply_data (from call_agent callback) over content
+    (from ask_user reply), converting to string.
+    """
+    if command.reply_data is not None:
+        if isinstance(command.reply_data, str):
+            return command.reply_data
+        return str(command.reply_data)
+
+    if command.content:
+        return extract_content_text(command.content)
+
+    return ""
+
+
+def str_to_uint128(s: str) -> int:
+    """Convert a string to a 128-bit integer (for OTEL TraceId)."""
+    return int(hashlib.md5(s.encode()).hexdigest(), 16)
+
+
+def str_to_uint64(s: str) -> int:
+    """Convert a string to a 64-bit integer (for OTEL SpanId)."""
+    return int(hashlib.md5(s.encode()).hexdigest()[:16], 16)