@baimingtao/lbs-agent 1.0.0

package/interfaces/cli/__init__.py

@@ -0,0 +1 @@
+from interfaces.cli._impl import *  # noqa: F401,F403

package/interfaces/cli/_impl/__init__.py

@@ -0,0 +1 @@
+"""智能体系统目标架构包。"""

package/interfaces/cli/_impl/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI 命令模块。"""

package/interfaces/cli/_impl/commands/agents.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import json
+import logging
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+from application.container import AgentSystemContainer
+from config.config import AppConfig, get_default_provider
+from interfaces.cli._impl.commands.common import bar as _bar, project_root
+from interfaces.cli._impl.commands.models import cmd_models
+
+
+def _container(config: AppConfig) -> AgentSystemContainer:
+    return AgentSystemContainer(config=config, project_root=project_root)
+
+
+def cmd_agents(config: AppConfig) -> None:
+    """列出所有子代理。"""
+    ac = config.agents
+    gc = ac.global_config
+
+    print()
+    print("  子代理配置")
+    _bar()
+    print(f"  全局: max_concurrent={gc.max_concurrent}  "
+          f"max_spawn_depth={gc.max_spawn_depth}  "
+          f"timeout={gc.default_timeout}s")
+    print()
+
+    if not ac.agents:
+        print("  (无子代理配置)")
+        print()
+        return
+
+    for name, a in sorted(ac.agents.items()):
+        dn = a.display_name or name
+        desc = a.description or ""
+        key_hint = _mask(a.api_key) if a.api_key else "(无key)"
+        tools = ", ".join(a.tools) if a.tools else "(纯推理)"
+        prompt = a.prompt_file or f"extensions/prompts/agents/{name}.md"
+        prompt_path = os.path.join(project_root, prompt)
+        prompt_status = "✓" if os.path.exists(prompt_path) else "✗"
+
+        print(f"  ┌─ {dn} ({name})")
+        print(f"  │  {desc}")
+        print(f"  │  prompt: {prompt_status} {prompt}")
+        chain = a.model_chain
+        if len(chain) > 1:
+            model_display = " → ".join(chain)
+        else:
+            model_display = a.model
+        print(f"  │  model={model_display}")
+        print(f"  │  provider={a.provider or '(inherit)'}")
+        print(f"  │  key={key_hint:<16} mode={a.api_mode}")
+        print(f"  │  timeout={a.timeout}s  max_iter={a.max_iterations}  "
+              f"strategy={a.error_strategy}  retries={a.max_retries}")
+        print(f"  │  tools=[{tools}]")
+        if a.guardrails:
+            print(f"  │  guardrails ({len(a.guardrails)}):")
+            for g in a.guardrails:
+                print(f"  │    - {g}")
+        if a.verification_rules:
+            print(f"  │  verification ({len(a.verification_rules)}):")
+            for v in a.verification_rules:
+                print(f"  │    - {v}")
+        if a.extra_body:
+            print(f"  │  extra_body={a.extra_body}")
+        print("  └─")
+        print()
+
+
+def cmd_config(config: AppConfig) -> None:
+    """显示完整配置。"""
+    cmd_models(config)
+    cmd_agents(config)
+
+    print("  配置文件")
+    _bar()
+    print(f"  models.yaml: {config.models.config_path or '(未找到)'}")
+    print(f"  agents.yaml: {config.agents.config_path or '(未找到)'}")
+    print()
+
+
+def cmd_status(config: AppConfig) -> None:
+    """显示运行时快照。"""
+    status = _container(config).orchestration_service().runtime_status()
+
+    print()
+    print("  运行状态")
+    _bar()
+    print(f"  project_root: {status.project_root}")
+    print(f"  default:      {status.default_provider} / {status.default_model}")
+    print(f"  agents:       {status.agent_count}")
+    print(f"  tools:        {status.tool_count}")
+    print(f"  sessions:     {status.session_count}")
+    print(f"  models.yaml:  {status.config_files['models']}")
+    print(f"  agents.yaml:  {status.config_files['agents']}")
+    print(f"  session_dir:  {status.session_dir}")
+    if status.status_notes:
+        print("  notes:")
+        for note in status.status_notes:
+            print(f"    - {note}")
+    print()

package/interfaces/cli/_impl/commands/architecture.py

@@ -0,0 +1,63 @@
+"""架构检查命令。"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+from application.container import AgentSystemContainer
+from application.contracts.result import ServiceResult
+from config.config import AppConfig
+from interfaces.cli._impl.result import CommandResult
+
+
+def _project_root() -> Path:
+    return Path(__file__).resolve().parents[4]
+
+
+def inspect_architecture_result(config: AppConfig, package_root: str | Path | None = None) -> ServiceResult[dict[str, Any]]:
+    """从 application service 获取架构巡检的统一返回契约。"""
+    root = Path(package_root) if package_root else _project_root()
+    return AgentSystemContainer(config=config, project_root=root).agent_service().inspect_architecture_result(root)
+
+
+def architecture_command_result(config: AppConfig, package_root: str | Path | None = None) -> CommandResult:
+    """将 application result 适配为 CLI transport result。"""
+    return CommandResult.from_service(inspect_architecture_result(config, package_root=package_root))
+
+
+def inspect_architecture(config: AppConfig, package_root: str | Path | None = None) -> dict[str, Any]:
+    """兼容旧调用方的裸报告读取接口。"""
+    return inspect_architecture_result(config, package_root).unwrap() or {}
+
+
+def print_architecture_report(config: AppConfig, package_root: str | Path | None = None, *, json_output: bool = False) -> None:
+    report = inspect_architecture(config, package_root)
+    if json_output:
+        print(json.dumps(report, ensure_ascii=False, indent=2))
+        return
+    summary = report["summary"]
+    print("\n Agent System 架构巡检")
+    print("=" * 64)
+    print(f" Package: {report['package_root']}")
+    print(f" Runtime Kernel: {summary['runtime_present']}/{summary['runtime_expected']}")
+    for path, ok in report["runtime_kernel"].items():
+        print(f" {'✓' if ok else '✗'} {path}")
+    print(f"\n 分层可见性: {summary['layers_present']}/{summary['layers_expected']}")
+    for path, ok in report["layers"].items():
+        print(f" {'✓' if ok else '✗'} {path}")
+    print(f"\n Agents: {summary['agent_count']}")
+    for agent in report["agents"]["agents"]:
+        tools = ", ".join(agent["tools"][:6])
+        if len(agent["tools"]) > 6:
+            tools += f", ... +{len(agent['tools']) - 6}"
+        print(f" ✓ {agent['name']} ({agent['display_name']}) model={agent['provider']}/{agent['model']} tools=[{tools}]")
+    print("\n 判断:")
+    if summary["runtime_present"] == summary["runtime_expected"]:
+        print(" ✓ Runtime Kernel 已显性化")
+    else:
+        missing = [path for path, ok in report["runtime_kernel"].items() if not ok]
+        print(f" ! Runtime Kernel 缺失 {len(missing)} 个组件：{', '.join(missing)}")
+    print(" ✓ Agent 已从 runtime/core/sub_agents/agents.yaml 显性暴露到 runtime.core.sub_agents.registry")
+    print(" ✓ lbs_agent 旧目录已移除，目标实现已切到分层目录")

package/interfaces/cli/_impl/commands/chat_repl.py

@@ -0,0 +1,291 @@
+"""LBS Agent REPL 交互模式（最小可工作版本）。
+
+设计：
+- 用户进入交互循环，每次输入一行
+- 内建命令以 `/` 开头（/help, /exit, /model, /agent, /session, /status, /clear, /new）
+- 其他输入走 Orchestrator.run_agent_sync()
+- 每次 turn 自动保存到 session（持久化）
+
+用法：
+    lbs chat                            # 默认 agent
+    lbs chat --agent code
+    lbs chat --agent code --provider minmax --model MiniMax-M3
+    lbs chat --session <id>             # 恢复已有 session
+    lbs chat --query "single query"     # 非交互（等价于 lbs run）
+"""
+from __future__ import annotations
+
+import sys
+import time
+from dataclasses import dataclass, field
+from typing import Optional
+
+from application.container import AgentSystemContainer
+from config.config import AppConfig
+from interfaces.cli._impl.commands.common import project_root
+
+
+BANNER = """\033[1;36m
+╔══════════════════════════════════════════════════════════════╗
+║  LBS Agent — Interactive Chat Mode                            ║
+║  内建命令: /help /exit /new /clear /status /model /agent      ║
+║  输入 / 开头是命令；其他内容发送给当前 agent                 ║
+╚══════════════════════════════════════════════════════════════╝\033[0m"""
+
+
+@dataclass
+class ChatState:
+    """REPL 运行时状态。"""
+    container: object = None
+    orchestrator: object = None
+    session_service: object = None
+    session_id: str = ""
+    agent_name: str = "code"
+    provider_name: str = ""
+    model_name: str = ""
+    turn_count: int = 0
+    started_at: float = field(default_factory=time.time)
+
+
+def _resolve_agent(config: AppConfig) -> str:
+    """选默认 agent：chat 优先（REPL 专用），其次 main/第一个。"""
+    names = list(config.agents.agents.keys()) if config.agents else []
+    if not names:
+        raise RuntimeError("没有配置任何 agent")
+    # chat 是 REPL 专用（无 evidence 强制，纯对话）
+    if "chat" in names:
+        return "chat"
+    if "main" in names:
+        return "main"
+    return names[0]
+
+
+def _print_turn_header(state: ChatState) -> None:
+    """每次 turn 的 header（agent + turn 编号）。"""
+    print(f"\n\033[1;33m[{state.agent_name} • turn {state.turn_count}]\033[0m ", end="", flush=True)
+
+
+def _print_help() -> None:
+    print("""
+\033[1;36m内建命令:\033[0m
+  /help              显示本帮助
+  /exit /quit        退出 chat（自动保存 session）
+  /new               开始新 session
+  /session [id]      查看或切换 session（不带参数显示当前）
+  /status            显示 session 状态
+  /agent             列出可用 agents
+  /agent <name>      切换到指定 agent
+  /model             列出当前 provider/models
+  /model <model>     切换 model（当前 provider 内）
+  /clear             清屏
+  /history [n]       显示最近 n 轮对话（默认 5）
+  /save              手动保存当前 session
+""")
+
+
+def _cmd_list_agents(state: ChatState) -> None:
+    agents = state.container.config.agents.agents
+    print("\n\033[1;36m可用 agents:\033[0m")
+    for name, a in agents.items():
+        marker = " \033[1;32m<-- 当前\033[0m" if name == state.agent_name else ""
+        print(f"  {name:25} {a.display_name}{marker}")
+
+
+def _cmd_list_models(state: ChatState) -> None:
+    config = state.container.config
+    provider_name = state.provider_name or config.models.default_provider
+    if provider_name not in config.models.providers:
+        print(f"  无 provider '{provider_name}'")
+        return
+    p = config.models.providers[provider_name]
+    print(f"\n\033[1;36m当前 provider: {provider_name} ({p.display_name or provider_name})\033[0m")
+    for m in p.models:
+        marker = " \033[1;32m<-- 当前\033[0m" if m == state.model_name else ""
+        print(f"  {m}{marker}")
+
+
+def _cmd_history(state: ChatState, n: int = 5) -> None:
+    if not state.session_id:
+        print("  无 session")
+        return
+    try:
+        messages = list(state.session_service.session_store.load_session_messages(state.session_id))
+        # 显示 user/assistant 配对
+        recent = []
+        for msg in messages[-n*2:]:
+            role = getattr(msg, "role", "?")
+            content = getattr(msg, "content", "")[:120]
+            if role in ("user", "assistant"):
+                recent.append((role, content))
+        print(f"\n\033[1;36m最近 {len(recent)} 条消息\033[0m")
+        for role, content in recent:
+            print(f"  {role:11} │ {content}")
+    except Exception as e:
+        print(f"  读取失败：{e}")
+
+
+def _cmd_status(state: ChatState) -> None:
+    elapsed = int(time.time() - state.started_at)
+    print(f"""
+\033[1;36mSession 状态:\033[0m
+  session_id : {state.session_id or '(未保存)'}
+  agent      : {state.agent_name}
+  provider   : {state.provider_name or '(默认)'}
+  model      : {state.model_name or '(默认)'}
+  turns      : {state.turn_count}
+  elapsed    : {elapsed}s
+""")
+
+
+def _handle_command(state: ChatState, line: str) -> bool:
+    """处理 / 命令。返回 True 表示继续循环，False 表示退出。"""
+    parts = line.strip().split(maxsplit=1)
+    cmd = parts[0].lower()
+    arg = parts[1] if len(parts) > 1 else ""
+
+    if cmd in ("/exit", "/quit"):
+        return False
+    elif cmd == "/help":
+        _print_help()
+    elif cmd == "/new":
+        state.session_id = ""
+        state.turn_count = 0
+        state.started_at = time.time()
+        print("\033[1;32m→ 新 session 已开始\033[0m")
+    elif cmd == "/session":
+        if arg:
+            state.session_id = arg
+            print(f"\033[1;32m→ 切换到 session: {arg}\033[0m")
+        else:
+            print(f"  当前 session: {state.session_id or '(无)'}")
+    elif cmd == "/status":
+        _cmd_status(state)
+    elif cmd == "/agent":
+        if not arg:
+            _cmd_list_agents(state)
+        else:
+            agents = state.container.config.agents.agents
+            if arg in agents:
+                state.agent_name = arg
+                print(f"\033[1;32m→ 切换到 agent: {arg}\033[0m")
+            else:
+                print(f"  无 agent '{arg}'")
+    elif cmd == "/model":
+        if not arg:
+            _cmd_list_models(state)
+        else:
+            state.model_name = arg
+            print(f"\033[1;32m→ 切换到 model: {arg}\033[0m")
+    elif cmd == "/clear":
+        print("\033[2J\033[H", end="")
+    elif cmd == "/history":
+        try:
+            n = int(arg) if arg else 5
+            _cmd_history(state, n)
+        except ValueError:
+            print("  /history [n]，n 必须是整数")
+    elif cmd == "/save":
+        # session 自动持久化在每次 turn，无需手动保存
+        print("  session 已在每次 turn 自动保存")
+    else:
+        print(f"  未知命令：{cmd}（输入 /help 查看）")
+    return True
+
+
+def _run_turn(state: ChatState, user_input: str) -> None:
+    """跑一轮对话（同步阻塞）。"""
+    t0 = time.time()
+    try:
+        # 把 user_input 作为 task
+        result = state.orchestrator.run_agent_sync(
+            state.agent_name,
+            user_input,
+            context="",
+            session_id=state.session_id,
+        )
+        elapsed = time.time() - t0
+        # 显示结果
+        if result.success:
+            content = (result.content or "").strip()
+            print(f"\n\033[1;32m{content}\033[0m")
+        else:
+            err = result.error or "(无错误信息)"
+            print(f"\n\033[1;31m✗ 失败: {err[:300]}\033[0m")
+        print(f"\033[2m  耗时: {elapsed:.1f}s | 迭代: {result.iterations} | 工具: {result.total_tool_calls}\033[0m")
+        # 保存 session_id（Orchestrator 内部会创建/复用）
+        if not state.session_id:
+            state.session_id = result.session_id if hasattr(result, "session_id") and result.session_id else f"chat-{int(state.started_at)}"
+    except KeyboardInterrupt:
+        print("\n\033[1;33m（已中断）\033[0m")
+    except Exception as e:
+        elapsed = time.time() - t0
+        print(f"\n\033[1;31m✗ 异常: {type(e).__name__}: {str(e)[:200]}\033[0m")
+        print(f"\033[2m  耗时: {elapsed:.1f}s\033[0m")
+
+
+def cmd_chat(
+    config: AppConfig,
+    agent_name: str = "",
+    provider_name: str = "",
+    model_name: str = "",
+    query: str = "",
+    session_id: str = "",
+) -> int:
+    """进入 chat REPL 或单次 query。"""
+    container = AgentSystemContainer(config=config, project_root=project_root)
+
+    # 选 agent
+    if not agent_name:
+        agent_name = _resolve_agent(config)
+
+    # 验证 agent 存在
+    if agent_name not in config.agents.agents:
+        print(f"  ✗ Agent '{agent_name}' 不存在")
+        return 1
+
+    state = ChatState(
+        container=container,
+        orchestrator=container.build_orchestrator(),
+        session_service=container.session_service(),
+        agent_name=agent_name,
+        provider_name=provider_name,
+        model_name=model_name,
+        session_id=session_id,
+    )
+
+    # 单次 query 模式（--query，非交互）
+    if query:
+        state.turn_count = 1
+        _print_turn_header(state)
+        print(query)
+        _run_turn(state, query)
+        return 0
+
+    # REPL 模式
+    print(BANNER)
+    _cmd_status(state)
+    print("\n输入 /help 查看命令。Ctrl+C 中断当前 turn，/exit 退出。\n")
+
+    while True:
+        try:
+            _print_turn_header(state)
+            line = input()
+        except EOFError:
+            print("\n")
+            break
+        except KeyboardInterrupt:
+            print("\n\033[1;33m（用 /exit 退出）\033[0m")
+            continue
+
+        line = line.strip()
+        if not line:
+            continue
+        if line.startswith("/"):
+            if not _handle_command(state, line):
+                break
+        else:
+            state.turn_count += 1
+            _run_turn(state, line)
+
+    print("\n\033[1;36m→ Session 已保存。退出 chat。\033[0m")
+    return 0

package/interfaces/cli/_impl/commands/common.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+project_root = Path(__file__).resolve().parents[4]
+
+
+def bar() -> None:
+    print("  " + "-" * 56)
+
+
+def mask(key: str) -> str:
+    if not key:
+        return ""
+    if len(key) <= 8:
+        return key[:2] + "***"
+    return key[:4] + "***" + key[-4:]

package/interfaces/cli/_impl/commands/cron.py

@@ -0,0 +1,145 @@
+"""定时任务 CLI 命令。"""
+
+from __future__ import annotations
+
+from application.container import AgentSystemContainer
+from config.config import load_config
+from interfaces.cli._impl.commands.common import project_root
+
+
+def _service():
+    return AgentSystemContainer(config=load_config(), project_root=project_root).cron_service()
+
+
+def cmd_cron_list(args=None):
+    jobs = _service().list_jobs()
+    if not jobs:
+        print("\n  没有定时任务。用 lbs cron create 创建。\n")
+        return 0
+    print(f"\n  定时任务 ({len(jobs)} 个)")
+    print(f"  {'='*70}")
+    for job in jobs:
+        status = "✓" if job.enabled else "⏸"
+        print(f"\n  {status} {job.name} ({job.job_id})")
+        print(f"     schedule: {job.schedule}")
+        print(f"     agent: {job.agent_name}")
+        print(f"     task: {job.task[:80]}")
+        print(f"     next_run: {job.next_run_at or '(无)'}")
+        print(f"     last_run: {job.last_run_at or '(从未)'}  success: {'✓' if job.last_success else '✗' if job.last_run_at else '-'}")
+        print(f"     runs: {job.run_count}  fails: {job.fail_count}")
+    print()
+    return 0
+
+
+def cmd_cron_create(args=None):
+    name = getattr(args, "name", "") or ""
+    schedule = getattr(args, "schedule", "") or ""
+    agent = getattr(args, "agent", "") or ""
+    task = getattr(args, "task", "") or ""
+    context = getattr(args, "context", "") or ""
+    if not schedule or not agent or not task:
+        print("  用法: lbs cron create --name <名称> --schedule <计划> --agent <agent名> --task <任务>")
+        print("  schedule 示例: 30m / every 2h / daily / 0 9 * * *")
+        return 1
+    try:
+        job = _service().create(name=name or f"{agent}-task", schedule=schedule, agent=agent, task=task, context=context)
+        print(f"\n  ✓ 创建成功: {job.job_id}")
+        print(f"     name: {job.name}")
+        print(f"     schedule: {job.schedule}")
+        print(f"     agent: {job.agent_name}")
+        print(f"     next_run: {job.next_run_at}\n")
+        return 0
+    except Exception as exc:
+        print(f"\n  ✗ 创建失败: {exc}\n")
+        return 1
+
+
+def _toggle(action: str, args=None):
+    job_id = getattr(args, "job_id", "") or ""
+    ok = getattr(_service(), action)(job_id)
+    labels = {"remove": "已删除", "pause": "已暂停", "resume": "已恢复", "trigger": "已触发"}
+    if ok:
+        suffix = " (将在下次 tick 执行)" if action == "trigger" else ""
+        print(f"\n  ✓ {labels[action]}: {job_id}{suffix}\n")
+        return 0
+    print(f"\n  ✗ 未找到: {job_id}\n")
+    return 1
+
+
+def cmd_cron_remove(args=None):
+    return _toggle("remove", args)
+
+
+def cmd_cron_pause(args=None):
+    return _toggle("pause", args)
+
+
+def cmd_cron_resume(args=None):
+    return _toggle("resume", args)
+
+
+def cmd_cron_trigger(args=None):
+    return _toggle("trigger", args)
+
+
+def cmd_cron_tick(args=None):
+    service = _service()
+    due = service.due_jobs()
+    if not due:
+        print("\n  没有到期的任务。\n")
+        return 0
+    print(f"\n  到期任务: {len(due)} 个，开始执行...")
+    results = service.tick()
+    print("\n  执行完成:")
+    for result in results:
+        status = "✓" if result["success"] else "✗"
+        print(f"    {status} {result['name']}: {result.get('output', result.get('error', ''))[:100]}")
+        print(f"       next_run: {result.get('next_run', '(无)')}")
+    print()
+    return 0
+
+
+
+def cmd_cron_logs(args=None):
+    """Usage: lbs cron logs [job_id] [lines]"""
+    parts = (args or "").strip().split()
+    job_id = parts[0] if parts else None
+    limit = int(parts[1]) if len(parts) > 1 else 20
+    all_jobs = _service().list_jobs()
+    if not all_jobs:
+        print("  暂无 cron 日志")
+        return 0
+    if job_id:
+        jobs = [j for j in all_jobs if j.job_id == job_id or job_id in j.job_id]
+        if not jobs:
+            print(f"  ❌ 未找到任务: {job_id}")
+            return 1
+    else:
+        jobs = all_jobs
+    print(f"\n  Cron 执行日志 (最近 {limit} 条)")
+    print(f"  {'='*50}")
+    for job in jobs:
+        print(f"  任务: {job.name} ({job.job_id})")
+        for run in (getattr(job, 'runs', []) or [])[-limit:]:
+            icon = "✅" if run.get("success") else "❌"
+            # Print fields that exist
+            info = f"  {icon} {run.get('at', run.get('timestamp', '?'))}"
+            if 'duration_ms' in run:
+                info += f"  {run['duration_ms']}ms"
+            if 'error' in run:
+                info += f"  {run['error'][:60]}"
+            print(info)
+        print()
+    return 0
+
+
+def cmd_cron_status(args=None):
+    status = _service().status()
+    print("\n  Cron 系统状态")
+    print(f"  {'='*40}")
+    print(f"  总任务数: {status['total_jobs']}")
+    print(f"  启用: {status['enabled']}")
+    print(f"  当前到期: {status['due_now']}")
+    print(f"  总执行次数: {status['total_runs']}")
+    print(f"  总失败次数: {status['total_failures']}\n")
+    return 0