sycommon-python-lib 0.2.7a55__tar.gz → 0.2.8__tar.gz

{sycommon_python_lib-0.2.7a55 → sycommon_python_lib-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a55
+Version: 0.2.8
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -9,17 +9,17 @@ Requires-Dist: aiohttp==3.14.3
 Requires-Dist: aiomysql==0.3.2
 Requires-Dist: anyio==4.14.2
 Requires-Dist: decorator==5.3.1
-Requires-Dist: deepagents==0.7.1
-Requires-Dist: elasticsearch==9.4.1
+Requires-Dist: deepagents==0.7.6
+Requires-Dist: elasticsearch==9.5.0
 Requires-Dist: fastapi==0.141.1
 Requires-Dist: jinja2==3.1.6
-Requires-Dist: kafka-python==3.0.9
-Requires-Dist: langchain==1.3.14
-Requires-Dist: langchain-core==1.5.3
-Requires-Dist: langchain-openai==1.4.1
-Requires-Dist: langfuse==4.14.2
-Requires-Dist: langgraph==1.2.10
-Requires-Dist: langgraph-checkpoint-postgres==3.1.1
+Requires-Dist: kafka-python==3.0.10
+Requires-Dist: langchain==1.3.15
+Requires-Dist: langchain-core==1.5.5
+Requires-Dist: langchain-openai==1.5.1
+Requires-Dist: langfuse==4.14.4
+Requires-Dist: langgraph==1.2.11
+Requires-Dist: langgraph-checkpoint-postgres==3.1.2
 Requires-Dist: langgraph-checkpoint-redis==0.5.1
 Requires-Dist: ldap3==2.9.1
 Requires-Dist: loguru==0.7.3
@@ -32,18 +32,19 @@ Requires-Dist: python-dotenv==1.2.2
 Requires-Dist: python-multipart==0.0.32
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: redis==7.4.0
-Requires-Dist: sentry-sdk[fastapi]==2.66.1
-Requires-Dist: sqlalchemy[asyncio]==2.0.51
-Requires-Dist: starlette[full]==1.3.1
+Requires-Dist: sentry-sdk[fastapi]==2.68.0
+Requires-Dist: sqlalchemy[asyncio]==2.0.52
+Requires-Dist: starlette[full]==1.6.0
 Requires-Dist: tiktoken==0.13.0
-Requires-Dist: uvicorn==0.52.1
+Requires-Dist: uvicorn==0.52.3
 Requires-Dist: wecom-aibot-python-sdk==1.0.2
 Requires-Dist: twine==7.0.0
 Requires-Dist: minio==7.2.20
-Requires-Dist: langchain-mcp-adapters==0.3.1
+Requires-Dist: langchain-mcp-adapters==0.3.2
 Requires-Dist: fastapi-mcp==0.4.0
 Requires-Dist: psycopg[binary,pool]==3.3.4
-Requires-Dist: agent-client-protocol==0.12.0
+Requires-Dist: agent-client-protocol==0.11.0
+Requires-Dist: langchain-acp==1.7.0
 Requires-Dist: pypinyin==0.55.0
 
 # sycommon-python-lib

{sycommon_python_lib-0.2.7a55 → sycommon_python_lib-0.2.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.7a55"
+version = "0.2.8"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -10,17 +10,17 @@ dependencies = [
     "aiomysql==0.3.2",
     "anyio==4.14.2",
     "decorator==5.3.1",
-    "deepagents==0.7.1",
-    "elasticsearch==9.4.1",
+    "deepagents==0.7.6",
+    "elasticsearch==9.5.0",
     "fastapi==0.141.1",
     "jinja2==3.1.6",
-    "kafka-python==3.0.9",
-    "langchain==1.3.14",
-    "langchain-core==1.5.3",
-    "langchain-openai==1.4.1",
-    "langfuse==4.14.2",
-    "langgraph==1.2.10",
-    "langgraph-checkpoint-postgres==3.1.1",
+    "kafka-python==3.0.10",
+    "langchain==1.3.15",
+    "langchain-core==1.5.5",
+    "langchain-openai==1.5.1",
+    "langfuse==4.14.4",
+    "langgraph==1.2.11",
+    "langgraph-checkpoint-postgres==3.1.2",
     "langgraph-checkpoint-redis==0.5.1",
     "ldap3==2.9.1",
     "loguru==0.7.3",
@@ -33,18 +33,19 @@ dependencies = [
     "python-multipart==0.0.32",
     "pyyaml==6.0.3",
     "redis==7.4.0",
-    "sentry-sdk[fastapi]==2.66.1",
-    "sqlalchemy[asyncio]==2.0.51",
-    "starlette[full]==1.3.1",
+    "sentry-sdk[fastapi]==2.68.0",
+    "sqlalchemy[asyncio]==2.0.52",
+    "starlette[full]==1.6.0",
     "tiktoken==0.13.0",
-    "uvicorn==0.52.1",
+    "uvicorn==0.52.3",
     "wecom-aibot-python-sdk==1.0.2",
     "twine==7.0.0",
     "minio==7.2.20",
-    "langchain-mcp-adapters==0.3.1",
+    "langchain-mcp-adapters==0.3.2",
     "fastapi-mcp==0.4.0",
     "psycopg[binary,pool]==3.3.4",
-    "agent-client-protocol==0.12.0",
+    "agent-client-protocol==0.11.0",
+    "langchain-acp==1.7.0",
     "pypinyin==0.55.0",
 ]
 

{sycommon_python_lib-0.2.7a55 → sycommon_python_lib-0.2.8}/src/sycli/cli.py

@@ -173,6 +173,11 @@ def _create_parser() -> argparse.ArgumentParser:
     p_acp.add_argument("--config", "-c", help="Path to ACP config file (default: .sycli/acp.yaml)")
     p_acp.add_argument("--project-root", "-r", default=".", help="Project root directory")
 
+    # ── acp-serve ──
+    p_acp_serve = sub.add_parser(
+        "acp-serve", help="Serve a DeepAgent as Zed ACP agent over stdio (LLM-backed)")
+    p_acp_serve.add_argument("--project-root", "-r", default=".", help="Project root directory")
+
     # ── version ──
     sub.add_parser("version", help="Show version")
 
@@ -243,6 +248,10 @@ def main() -> None:
         from sycli.commands.acp_cmd import handle_acp
         sys.exit(handle_acp(args))
 
+    elif args.command == "acp-serve":
+        from sycli.commands.acp_serve_cmd import handle_acp_serve
+        sys.exit(handle_acp_serve(args))
+
 
 def _handle_status(args) -> None:
     """Show current RL state."""

sycommon_python_lib-0.2.8/src/sycli/commands/acp_serve_cmd.py

@@ -0,0 +1,113 @@
+"""sycli acp-serve command — 把 DeepAgent 起成 Zed ACP agent（stdio）。
+
+与 `sycli acp` 的区别：
+- acp：把 .sycli/acp.yaml 里的静态 CLI 工具暴露成 ACP agent（无 LLM，纯命令路由）。
+- acp-serve：把一个真的 DeepAgent（LLM + 本地 shell 后端）暴露成 ACP agent，
+  Zed/其它 ACP client 连上后即可对话式驱动它干活。
+
+stdio 约定：stdout 是 JSON-RPC 通道，一切诊断输出走 stderr。
+"""
+
+from __future__ import annotations
+
+import signal
+import sys
+from pathlib import Path
+
+
+def _e(msg: str) -> None:
+    """stderr 诊断输出（stdout 留给 JSON-RPC）。"""
+    print(f"  {msg}", file=sys.stderr)
+
+
+def handle_acp_serve(args) -> int:
+    """Handle `sycli acp-serve` command.
+
+    Flow:
+        1. Resolve project root, load sycli.json（LLM 配置）
+        2. Build DeepAgent graph（LLM + LocalShellBackend）
+        3. Serve over stdio as Zed ACP agent (blocking)
+
+    Args:
+        args: Parsed argparse namespace with project_root.
+
+    Returns:
+        Exit code (0 for success, 1 for error).
+    """
+    project_root = Path(args.project_root or ".").resolve()
+    config_path = project_root / ".sycli" / "sycli.json"
+
+    from sycli.models.config_models import SycliConfig
+
+    config = SycliConfig.load(config_path)
+    issues = config.validate_config()
+    fatal = [i for i in issues if "base_url" in i or "api_key" in i]
+    if fatal:
+        for i in fatal:
+            _e(f"✘ Config: {i}")
+        _e("✘ LLM 未配置，无法启动 DeepAgent。先运行 `sycli init` 或检查 sycli.json。")
+        return 1
+
+    # Print summary to stderr（stdout 留给 stdio JSON-RPC）
+    _e("═" * 60)
+    _e("Zed ACP DeepAgent Server")
+    _e(f"  Project:  {project_root}")
+    _e(f"  Config:   {config_path if config_path.exists() else '(defaults)'}")
+    _e(f"  Model:    {config.llm.model} @ {config.llm.resolved_base_url()}")
+    _e("  Transport: stdio (JSON-RPC)")
+    _e("─" * 60)
+
+    # Build DeepAgent graph（延迟导入：出错时不污染 stdout）
+    def _build_graph():
+        from deepagents import create_deep_agent
+        from sycli.agents.factory import build_subagents
+        from sycli.core.backend import create_backend
+        from sycli.core.llm import create_llm
+
+        llm = create_llm(config.llm, streaming=True)
+        backend = create_backend(project_root)
+        subagents = build_subagents(config, llm, backend, project_name=project_root.name, mode="serve", project_root=str(project_root))
+        return create_deep_agent(
+            model=llm,
+            backend=backend,
+            system_prompt=(
+                "你是 sycli DeepAgent，正通过 ACP 协议被远程 client 驱动。"
+                "在项目根目录内完成任务；需要拆解任务时用 write_todos 维护计划。"
+            ),
+            subagents=subagents,
+            checkpointer=None,  # langchain-acp 适配层自动挂进程内 checkpointer
+            debug=False,
+            name="sycli-acp-serve",
+        )
+
+    from sycommon.agent.acp.server_adapter import serve_graph
+
+    _shutdown = False
+
+    def _signal_handler(sig, frame):
+        nonlocal _shutdown
+        if _shutdown:
+            sys.exit(1)
+        _shutdown = True
+        _e("⚠ Shutting down ACP DeepAgent...")
+
+    signal.signal(signal.SIGINT, _signal_handler)
+
+    try:
+        serve_graph(
+            graph_factory=_build_graph,
+            agent_name="sycli-deepagent",
+            agent_title="sycli DeepAgent",
+        )
+    except KeyboardInterrupt:
+        _e("⚠ ACP DeepAgent stopped.")
+        return 0
+    except Exception as e:
+        _e(f"✘ ACP server failed: {e}")
+        import traceback
+
+        traceback.print_exc(file=sys.stderr)
+        return 1
+
+    return 0
+

sycommon_python_lib-0.2.8/src/sycommon/agent/acp/server_adapter.py

@@ -0,0 +1,99 @@
+"""ACP server 适配器——把 LangGraph/DeepAgent graph 暴露成 ACP agent（stdio）。
+
+与 client.py 相反的方向：client.py 让我们的 agent 通过 ACP 调远程 agent（如 Codex）；
+本模块让我们的 agent（DeepAgent compiled graph）反过来被 ACP client（Zed 编辑器、
+其它主控 agent）驱动，基于 langchain-acp 的 LangChainAcpAgent 适配层。
+
+对外暴露：
+- serve_graph：把 compiled graph 包成 ACP agent 并阻塞跑 stdio JSON-RPC 循环。
+- build_acp_server_agent：只构建 LangChainAcpAgent（不进 IO 循环，测试/嵌入用）。
+
+会话与状态：
+- 每 ACP session 对应 graph 一个 thread_id（session_id），多轮上下文由
+  langgraph checkpointer 维持；无 checkpointer 的 graph 会被适配层自动挂
+  MemorySaver（进程内，进程退出即失）。
+- deepagents 的 write_todos 计划事件经 DeepAgentsCompatibilityBridge 投影成
+  ACP AgentPlanUpdate，client（如 Zed）能实时看到计划进度。
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Optional
+
+from langchain_acp import create_acp_agent, run_acp
+from langchain_acp.runtime.adapter import LangChainAcpAgent
+
+logger = logging.getLogger(__name__)
+
+# graph 工厂类型：langchain-acp 以 FactoryGraphSource 调用工厂，签名是
+# factory(session: AcpSessionContext) -> compiled graph（session 可忽略）。
+# 声明成可选参以兼容「无参工厂」——我们只透传给 langchain-acp。
+GraphFactory = Callable[..., Any]
+
+
+def _adapt_factory(factory: GraphFactory) -> GraphFactory:
+    """把任意零参工厂包成 langchain-acp 要求的 (session) -> graph 签名。"""
+    def _wrapped(session: Any = None) -> Any:  # noqa: ARG001
+        return factory()
+    return _wrapped
+
+
+def build_acp_server_agent(
+    graph: Any = None,
+    *,
+    graph_factory: Optional[GraphFactory] = None,
+    agent_name: str = "sycommon-deepagent",
+    agent_title: str = "sycommon DeepAgent",
+) -> LangChainAcpAgent:
+    """构建 ACP 化的 agent（不进 IO 循环）。
+
+    Args:
+        graph: 已编译的 LangGraph/DeepAgent graph（与 graph_factory 二选一）。
+        graph_factory: 返回 compiled graph 的零参工厂（优先级低于 graph）。
+        agent_name: ACP agentInfo.name（client 侧展示用）。
+        agent_title: ACP agentInfo.title。
+
+    Returns:
+        LangChainAcpAgent，可直接传给 acp.run_agent 或自托管事件循环。
+    """
+    if graph is None and graph_factory is None:
+        raise ValueError("graph 与 graph_factory 至少提供一个")
+    agent = create_acp_agent(
+        graph=graph,
+        graph_factory=_adapt_factory(graph_factory) if graph_factory else None,
+        config=_make_config(agent_name, agent_title),
+    )
+    logger.info("[acp_server] agent 就绪 name=%s（等待 stdio client 连接）", agent_name)
+    return agent
+
+
+def serve_graph(
+    graph: Any = None,
+    *,
+    graph_factory: Optional[GraphFactory] = None,
+    agent_name: str = "sycommon-deepagent",
+    agent_title: str = "sycommon DeepAgent",
+) -> None:
+    """把 graph 包成 ACP agent 并阻塞运行 stdio JSON-RPC 循环。
+
+    stdout 是 JSON-RPC 通道，任何日志必须走 stderr（上层负责 logging 配置）。
+    client 断开 stdin 或进程被 kill 时返回。
+    """
+    agent = build_acp_server_agent(
+        graph, graph_factory=graph_factory,
+        agent_name=agent_name, agent_title=agent_title,
+    )
+    run_acp(graph_source=agent._graph_source, config=agent._config)
+
+
+def _make_config(agent_name: str, agent_title: str) -> Any:
+    """构造 AdapterConfig（agent 标识 + deepagents 兼容桥）。"""
+    from langchain_acp import AdapterConfig
+    from langchain_acp.bridges import DeepAgentsCompatibilityBridge
+
+    return AdapterConfig(
+        agent_name=agent_name,
+        agent_title=agent_title,
+        capability_bridges=(DeepAgentsCompatibilityBridge(),),
+    )