echo-agent 0.1.0__tar.gz → 0.2.1__tar.gz

echo_agent-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Echo Agent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

echo_agent-0.2.1/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: echo-agent
+Version: 0.2.1
+Summary: A modular AI agent framework with multi-channel support
+Author: Echo Agent contributors
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,assistant,chatbot,runtime
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: croniter>=1.4
+Requires-Dist: loguru>=0.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40; extra == 'all'
+Requires-Dist: boto3>=1.34; extra == 'all'
+Requires-Dist: cryptography>=41.0; extra == 'all'
+Requires-Dist: faiss-cpu>=1.7; extra == 'all'
+Requires-Dist: google-generativeai>=0.8; extra == 'all'
+Requires-Dist: openai>=1.30; extra == 'all'
+Requires-Dist: psutil>=5.9; extra == 'all'
+Requires-Dist: tiktoken>=0.7; extra == 'all'
+Provides-Extra: allproviders
+Requires-Dist: anthropic>=0.40; extra == 'allproviders'
+Requires-Dist: boto3>=1.34; extra == 'allproviders'
+Requires-Dist: google-generativeai>=0.8; extra == 'allproviders'
+Requires-Dist: openai>=1.30; extra == 'allproviders'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40; extra == 'anthropic'
+Provides-Extra: bedrock
+Requires-Dist: anthropic>=0.40; extra == 'bedrock'
+Requires-Dist: boto3>=1.34; extra == 'bedrock'
+Provides-Extra: container
+Requires-Dist: docker>=7.0; extra == 'container'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: gemini
+Requires-Dist: google-generativeai>=0.8; extra == 'gemini'
+Provides-Extra: openai
+Requires-Dist: openai>=1.30; extra == 'openai'
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.20; extra == 'otel'
+Requires-Dist: opentelemetry-exporter-otlp>=1.20; extra == 'otel'
+Requires-Dist: opentelemetry-sdk>=1.20; extra == 'otel'
+Provides-Extra: process
+Requires-Dist: psutil>=5.9; extra == 'process'
+Provides-Extra: skills
+Requires-Dist: caldav>=1.3; extra == 'skills'
+Requires-Dist: croniter>=1.4; extra == 'skills'
+Requires-Dist: duckduckgo-search>=7.0; extra == 'skills'
+Requires-Dist: edge-tts>=7.0; extra == 'skills'
+Requires-Dist: faster-whisper>=1.0; extra == 'skills'
+Requires-Dist: feedparser>=6.0; extra == 'skills'
+Requires-Dist: icalendar>=5.0; extra == 'skills'
+Requires-Dist: markdown>=3.6; extra == 'skills'
+Requires-Dist: openpyxl>=3.1; extra == 'skills'
+Requires-Dist: pillow>=10.0; extra == 'skills'
+Requires-Dist: psutil>=5.9; extra == 'skills'
+Requires-Dist: pymupdf>=1.24; extra == 'skills'
+Requires-Dist: pytesseract>=0.3; extra == 'skills'
+Requires-Dist: python-docx>=1.1; extra == 'skills'
+Requires-Dist: python-pptx>=1.0; extra == 'skills'
+Requires-Dist: pyyaml>=6.0; extra == 'skills'
+Requires-Dist: trafilatura>=2.0; extra == 'skills'
+Provides-Extra: tokenizers
+Requires-Dist: tiktoken>=0.7; extra == 'tokenizers'
+Provides-Extra: vector
+Requires-Dist: faiss-cpu>=1.7; extra == 'vector'
+Provides-Extra: weixin
+Requires-Dist: cryptography>=41.0; extra == 'weixin'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# Echo Agent
+
+**记得住过去，学得会未来的开源 AI Agent**
+
+<a href="https://github.com/fuyuxiang/echo-agent">
+  <img src="docs/assets/echo-agent.png" alt="Echo Agent" width="720" />
+</a>
+
+<br/>
+
+[![PyPI](https://img.shields.io/pypi/v/echo-agent)](https://pypi.org/project/echo-agent/)
+[![Downloads](https://static.pepy.tech/badge/echo-agent)](https://pepy.tech/project/echo-agent)
+[![GitHub stars](https://img.shields.io/github/stars/fuyuxiang/echo-agent?style=social)](https://github.com/fuyuxiang/echo-agent)
+
+[中文](README.md) · [English](README.en.md)
+
+</div>
+
+---
+
+## 什么是 Echo Agent
+
+Echo Agent 是一个可自托管的长期运行 AI Agent。与一次性问答不同，它能：
+
+- **跨会话记忆** — 四层认知记忆结构，自动衰减与矛盾检测，解决长期运行下的记忆膨胀问题，对话不再从零开始
+- **自进化技能** — 从真实执行轨迹中生成候选改进，经评测验证后才生效，支持回滚
+- **多入口归一** — CLI、Gateway、Webhook、Cron 及 Telegram / Discord / Slack / 微信 / 飞书 / 钉钉等 12 个通道共享同一份状态
+- **安全可控** — 高风险工具调用经统一审批，凭证加密存储，执行日志可审计
+
+一句话：**让 Agent 带着记忆和不断进化的技能，长期为你工作。**
+
+---
+
+## 快速开始
+
+环境要求：Python 3.11+，至少一个模型 API Key。
+
+```bash
+# 安装
+pip install "echo-agent[all]"
+
+# 配置模型 API Key（任选其一）
+export OPENAI_API_KEY="sk-..."
+# 也支持 ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENROUTER_API_KEY，
+# 以及 AWS Bedrock（使用标准 AWS 凭证）
+
+# 交互式配置向导（数据默认存放在 ~/.echo-agent）
+echo-agent setup
+
+# 启动
+echo-agent run
+```
+
+<details>
+<summary>国内镜像 / Windows / 一键脚本</summary>
+
+```bash
+# 阿里云镜像加速
+pip install "echo-agent[all]" -i https://mirrors.aliyun.com/pypi/simple/
+```
+
+```powershell
+# Windows（PowerShell）
+pip install "echo-agent[all]"
+$env:OPENAI_API_KEY = "sk-..."
+echo-agent setup
+echo-agent run
+```
+
+```bash
+# 一键安装脚本（仅支持 Linux / macOS / WSL2，会从源码安装到 ~/.echo-agent
+# 并可注册 systemd 服务；建议先审查脚本内容再执行）
+curl -fsSL -o install.sh https://raw.githubusercontent.com/fuyuxiang/echo-agent/master/scripts/install.sh
+less install.sh && bash install.sh
+```
+
+</details>
+
+---
+
+## 架构总览
+
+<div align="center">
+  <img src="docs/assets/architecture.png" alt="Echo Agent 架构图" width="820" />
+</div>
+
+---
+
+## 核心能力
+
+| 模块 | 说明 |
+|------|------|
+| **Agent Loop** | 接收事件 → 构建上下文 → 调用模型 → 执行工具，跨入口共享同一条执行路径 |
+| **认知记忆** | Working / Episodic / Semantic / Archival 四层，配合衰减、矛盾检测与重要性重排 |
+| **混合检索** | BM25 + FAISS 向量融合召回，按查询特征自适应权重，FAISS 缺失时自动降级 |
+| **自进化引擎** | 轨迹记录 → 候选生成 → 评测对照 → 晋升/驳回，支持冷却期与一键回滚 |
+| **模型路由** | 主推理、上下文压缩、向量嵌入、风险审批可独立配置 provider 与模型 |
+| **工具审批** | 三档策略 `manual` / `smart` / `off`，无人值守通道默认拒绝高风险调用 |
+| **跨进程互操作** | A2A JSON-RPC + MCP 客户端（含 OAuth），支持动态工具注册 |
+| **本地优先** | 会话、记忆、轨迹、凭证默认存放工作区，凭证加密落盘 |
+
+---
+
+## 适用场景
+
+- Agent 跑在本机或自有服务器，需要完整审计与可追溯
+- 对话、偏好与任务经验需要跨会话长期沉淀
+- 希望 Agent 技能从真实使用中持续改进，而非出厂定型
+- 多入口（CLI、Webhook、消息机器人）需共享同一份记忆与权限
+- 高风险工具需要强制审批，避免误操作
+- 需同时接入多家模型 provider，按任务类型分配
+
+---
+
+## 开发与贡献
+
+从源码安装（开发模式）：
+
+```bash
+git clone https://github.com/fuyuxiang/echo-agent.git   # 国内可用 https://gitee.com/fuyuxiang/echo-agent.git
+cd echo-agent
+uv venv venv --python 3.11 && source venv/bin/activate
+uv pip install -e ".[all,dev]"
+
+# 提交前检查
+ruff check .
+pytest
+```
+
+PR 前请确保 lint 和测试通过（CI 会在 PR 上自动运行同样的检查），并同步更新中英文 README。
+
+**参与方向：** 通道适配器 · 内置工具 · MCP 集成 · 技能示例 · 评测数据集 · 文档完善 · 部署模板
+
+**社区：**
+- QQ群：[47572014](https://qm.qq.com/q/JWOPDBNssw)
+
+---
+
+## 协议
+
+[MIT License](LICENSE)
+
+---
+
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=fuyuxiang/echo-agent&type=Date)](https://star-history.com/#fuyuxiang/echo-agent&Date)

echo_agent-0.2.1/README.md

@@ -0,0 +1,150 @@
+<div align="center">
+
+# Echo Agent
+
+**记得住过去，学得会未来的开源 AI Agent**
+
+<a href="https://github.com/fuyuxiang/echo-agent">
+  <img src="docs/assets/echo-agent.png" alt="Echo Agent" width="720" />
+</a>
+
+<br/>
+
+[![PyPI](https://img.shields.io/pypi/v/echo-agent)](https://pypi.org/project/echo-agent/)
+[![Downloads](https://static.pepy.tech/badge/echo-agent)](https://pepy.tech/project/echo-agent)
+[![GitHub stars](https://img.shields.io/github/stars/fuyuxiang/echo-agent?style=social)](https://github.com/fuyuxiang/echo-agent)
+
+[中文](README.md) · [English](README.en.md)
+
+</div>
+
+---
+
+## 什么是 Echo Agent
+
+Echo Agent 是一个可自托管的长期运行 AI Agent。与一次性问答不同，它能：
+
+- **跨会话记忆** — 四层认知记忆结构，自动衰减与矛盾检测，解决长期运行下的记忆膨胀问题，对话不再从零开始
+- **自进化技能** — 从真实执行轨迹中生成候选改进，经评测验证后才生效，支持回滚
+- **多入口归一** — CLI、Gateway、Webhook、Cron 及 Telegram / Discord / Slack / 微信 / 飞书 / 钉钉等 12 个通道共享同一份状态
+- **安全可控** — 高风险工具调用经统一审批，凭证加密存储，执行日志可审计
+
+一句话：**让 Agent 带着记忆和不断进化的技能，长期为你工作。**
+
+---
+
+## 快速开始
+
+环境要求：Python 3.11+，至少一个模型 API Key。
+
+```bash
+# 安装
+pip install "echo-agent[all]"
+
+# 配置模型 API Key（任选其一）
+export OPENAI_API_KEY="sk-..."
+# 也支持 ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENROUTER_API_KEY，
+# 以及 AWS Bedrock（使用标准 AWS 凭证）
+
+# 交互式配置向导（数据默认存放在 ~/.echo-agent）
+echo-agent setup
+
+# 启动
+echo-agent run
+```
+
+<details>
+<summary>国内镜像 / Windows / 一键脚本</summary>
+
+```bash
+# 阿里云镜像加速
+pip install "echo-agent[all]" -i https://mirrors.aliyun.com/pypi/simple/
+```
+
+```powershell
+# Windows（PowerShell）
+pip install "echo-agent[all]"
+$env:OPENAI_API_KEY = "sk-..."
+echo-agent setup
+echo-agent run
+```
+
+```bash
+# 一键安装脚本（仅支持 Linux / macOS / WSL2，会从源码安装到 ~/.echo-agent
+# 并可注册 systemd 服务；建议先审查脚本内容再执行）
+curl -fsSL -o install.sh https://raw.githubusercontent.com/fuyuxiang/echo-agent/master/scripts/install.sh
+less install.sh && bash install.sh
+```
+
+</details>
+
+---
+
+## 架构总览
+
+<div align="center">
+  <img src="docs/assets/architecture.png" alt="Echo Agent 架构图" width="820" />
+</div>
+
+---
+
+## 核心能力
+
+| 模块 | 说明 |
+|------|------|
+| **Agent Loop** | 接收事件 → 构建上下文 → 调用模型 → 执行工具，跨入口共享同一条执行路径 |
+| **认知记忆** | Working / Episodic / Semantic / Archival 四层，配合衰减、矛盾检测与重要性重排 |
+| **混合检索** | BM25 + FAISS 向量融合召回，按查询特征自适应权重，FAISS 缺失时自动降级 |
+| **自进化引擎** | 轨迹记录 → 候选生成 → 评测对照 → 晋升/驳回，支持冷却期与一键回滚 |
+| **模型路由** | 主推理、上下文压缩、向量嵌入、风险审批可独立配置 provider 与模型 |
+| **工具审批** | 三档策略 `manual` / `smart` / `off`，无人值守通道默认拒绝高风险调用 |
+| **跨进程互操作** | A2A JSON-RPC + MCP 客户端（含 OAuth），支持动态工具注册 |
+| **本地优先** | 会话、记忆、轨迹、凭证默认存放工作区，凭证加密落盘 |
+
+---
+
+## 适用场景
+
+- Agent 跑在本机或自有服务器，需要完整审计与可追溯
+- 对话、偏好与任务经验需要跨会话长期沉淀
+- 希望 Agent 技能从真实使用中持续改进，而非出厂定型
+- 多入口（CLI、Webhook、消息机器人）需共享同一份记忆与权限
+- 高风险工具需要强制审批，避免误操作
+- 需同时接入多家模型 provider，按任务类型分配
+
+---
+
+## 开发与贡献
+
+从源码安装（开发模式）：
+
+```bash
+git clone https://github.com/fuyuxiang/echo-agent.git   # 国内可用 https://gitee.com/fuyuxiang/echo-agent.git
+cd echo-agent
+uv venv venv --python 3.11 && source venv/bin/activate
+uv pip install -e ".[all,dev]"
+
+# 提交前检查
+ruff check .
+pytest
+```
+
+PR 前请确保 lint 和测试通过（CI 会在 PR 上自动运行同样的检查），并同步更新中英文 README。
+
+**参与方向：** 通道适配器 · 内置工具 · MCP 集成 · 技能示例 · 评测数据集 · 文档完善 · 部署模板
+
+**社区：**
+- QQ群：[47572014](https://qm.qq.com/q/JWOPDBNssw)
+
+---
+
+## 协议
+
+[MIT License](LICENSE)
+
+---
+
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=fuyuxiang/echo-agent&type=Date)](https://star-history.com/#fuyuxiang/echo-agent&Date)

echo_agent-0.2.1/echo_agent/__main__.py

@@ -0,0 +1,252 @@
+"""Echo Agent CLI entry point — argument parsing and command dispatch.
+
+All bootstrap and lifecycle logic lives in :mod:`echo_agent.app`.
+"""
+
+from __future__ import annotations
+
+import argparse
+import asyncio
+
+# Backward-compat re-exports: external code and older docs referenced these
+# names on the script module before the composition root moved to app.py.
+from echo_agent.app import (  # noqa: F401
+    BootstrapResult as _BootstrapResult,
+    bootstrap as _bootstrap,
+    run as _run,
+    run_gateway as _run_gateway,
+)
+
+
+def _run_eval(args) -> None:
+    from pathlib import Path as _Path
+
+    config_path = args.config or getattr(args, "top_config", None)
+    workspace = args.workspace or getattr(args, "top_workspace", None)
+
+    from echo_agent.config.loader import load_config, resolve_config_file
+    config_file = resolve_config_file(config_path)
+    config = load_config(config_path=config_file)
+
+    dataset_path = args.dataset or config.evaluation.dataset_path
+    path = _Path(dataset_path)
+    if not path.exists():
+        print(f"Dataset not found: {path}")
+        print("Create a YAML file with test cases. Example:")
+        print("  - id: test_001")
+        print("    input: 'Hello'")
+        print("    expected_contains: ['hello', 'hi']")
+        return
+
+    from echo_agent.evaluation import EvalRunner, EvalDataset
+
+    dataset = EvalDataset.from_path(path)
+    if args.tag:
+        cases = dataset.filter_by_tag(args.tag)
+        dataset = EvalDataset(cases)
+
+    if not dataset.cases:
+        print("No test cases found.")
+        return
+
+    async def run():
+        from echo_agent.app import bootstrap
+
+        overrides = {"workspace": workspace} if workspace else None
+        ctx = await bootstrap(config_path=config_path, overrides=overrides)
+        await ctx.bus.start()
+        await ctx.agent.start()
+
+        try:
+            runner = EvalRunner(ctx.agent, parallel=args.parallel, timeout=config.evaluation.timeout_per_case)
+            report = await runner.run_dataset(dataset)
+
+            from echo_agent.evaluation.reporter import EvalReporter
+            reporter = EvalReporter()
+            print(reporter.to_table(report))
+
+            if args.output:
+                _Path(args.output).write_text(reporter.to_json(report), encoding="utf-8")
+                print(f"\nResults saved to {args.output}")
+        finally:
+            from echo_agent.app import AppRuntime
+            await AppRuntime._stop_step("agent", ctx.agent.stop())
+            await AppRuntime._stop_step("bus", ctx.bus.stop())
+            await AppRuntime._stop_step("storage", ctx.storage.close())
+
+    asyncio.run(run())
+
+
+def main() -> None:
+    try:
+        _dispatch()
+    except Exception as e:
+        from echo_agent.config.loader import ConfigError
+        if isinstance(e, ConfigError):
+            import sys
+            print(f"配置错误 / Configuration error:\n{e}", file=sys.stderr)
+            sys.exit(1)
+        raise
+
+
+def _dispatch() -> None:
+    parser = argparse.ArgumentParser(prog="echo-agent", description="Echo Agent — modular AI agent framework")
+    subparsers = parser.add_subparsers(dest="command")
+
+    # run
+    run_parser = subparsers.add_parser("run", help="Start the agent")
+    run_parser.add_argument("-c", "--config", help="Path to config file")
+    run_parser.add_argument("-w", "--workspace", help="Workspace directory")
+
+    # setup
+    setup_parser = subparsers.add_parser("setup", help="Run the setup wizard")
+    setup_parser.add_argument(
+        "section", nargs="?", default=None,
+        help="Setup section: language, model, permissions, terminal, agent, tools, channel, gateway, observability, evolution, doctor",
+    )
+    setup_parser.add_argument("-c", "--config", help="Path to config file")
+    setup_parser.add_argument("-w", "--workspace", help="Workspace directory")
+    setup_parser.add_argument("--lang", choices=["en", "zh", "auto"], default=None,
+                              help="Override interface language (default: auto-detect from OS)")
+    setup_parser.add_argument("--flow", choices=["quickstart", "full"], default=None,
+                              help="Skip the menu and run a specific flow")
+
+    # status
+    status_parser = subparsers.add_parser("status", help="Show current configuration status")
+    status_parser.add_argument("-c", "--config", help="Path to config file")
+    status_parser.add_argument("-w", "--workspace", help="Workspace directory")
+
+    # gateway
+    gw_parser = subparsers.add_parser("gateway", help="Start the gateway server")
+    gw_parser.add_argument("-c", "--config", help="Path to config file")
+    gw_parser.add_argument("-w", "--workspace", help="Workspace directory")
+    gw_parser.add_argument("--host", help="Gateway host")
+    gw_parser.add_argument("--port", type=int, help="Gateway port")
+
+    # eval
+    eval_parser = subparsers.add_parser("eval", help="Run evaluation test suite")
+    eval_parser.add_argument("--dataset", "-d", default="", help="Path to eval dataset (YAML/JSON)")
+    eval_parser.add_argument("--tag", "-t", default="", help="Filter cases by tag")
+    eval_parser.add_argument("--parallel", "-p", type=int, default=3, help="Parallel cases")
+    eval_parser.add_argument("--output", "-o", default="", help="Output file for results")
+    eval_parser.add_argument("-c", "--config", help="Path to config file")
+    eval_parser.add_argument("-w", "--workspace", help="Workspace directory")
+
+    # service
+    svc_parser = subparsers.add_parser("service", help="Manage systemd service (Linux)")
+    svc_parser.add_argument("action", choices=["install", "uninstall", "start", "stop", "restart", "status", "logs"], help="Service action")
+    svc_parser.add_argument("-w", "--workspace", help="Workspace directory (used by install)")
+
+    # plugin
+    plugin_parser = subparsers.add_parser("plugin", help="Manage plugins")
+    plugin_parser.add_argument("action", choices=["list", "info", "enable", "disable", "check"], help="Plugin action")
+    plugin_parser.add_argument("name", nargs="?", default="", help="Plugin name (for info/enable/disable)")
+    plugin_parser.add_argument("-c", "--config", help="Path to config file")
+    plugin_parser.add_argument("-w", "--workspace", help="Workspace directory")
+
+    # evolution
+    evo_parser = subparsers.add_parser("evolution", help="Manage the self-evolving skill harness")
+    evo_parser.add_argument(
+        "action",
+        choices=[
+            "status", "run", "list-candidates", "show-candidate",
+            "promote", "rollback", "init-dataset",
+        ],
+        help="Evolution action",
+    )
+    evo_parser.add_argument("target", nargs="?", default="", help="Skill name (rollback) or candidate id (show-candidate/promote)")
+    evo_parser.add_argument("--status", dest="status_filter", default="", help="Filter list-candidates by status")
+    evo_parser.add_argument("-c", "--config", help="Path to config file")
+    evo_parser.add_argument("-w", "--workspace", help="Workspace directory")
+
+    # top-level flags for backward compat
+    parser.add_argument("-c", "--config", help="Path to config file", dest="top_config")
+    parser.add_argument("-w", "--workspace", help="Workspace directory", dest="top_workspace")
+
+    args = parser.parse_args()
+
+    if args.command == "setup":
+        from echo_agent.cli.setup import run_setup_wizard
+        lang_arg = getattr(args, "lang", None)
+        if lang_arg == "auto":
+            lang_arg = None
+        run_setup_wizard(
+            section=args.section,
+            config_path=args.config or args.top_config,
+            workspace=args.workspace or args.top_workspace,
+            lang=lang_arg,
+            flow=getattr(args, "flow", None),
+        )
+        return
+
+    if args.command == "status":
+        from echo_agent.cli.status import show_status
+        show_status(config_path=args.config or args.top_config, workspace=args.workspace or args.top_workspace)
+        return
+
+    if args.command == "gateway":
+        from echo_agent.app import run_gateway
+        try:
+            asyncio.run(run_gateway(config_path=args.config or args.top_config, host=args.host, port=args.port, workspace=args.workspace or args.top_workspace))
+        except KeyboardInterrupt:
+            pass
+        return
+
+    if args.command == "eval":
+        _run_eval(args)
+        return
+
+    if args.command == "service":
+        from echo_agent.cli.service import run_action
+        run_action(args.action, workspace=args.workspace or args.top_workspace)
+        return
+
+    if args.command == "plugin":
+        from echo_agent.cli.plugins_cmd import run_plugin_command
+        run_plugin_command(
+            action=args.action,
+            name=args.name,
+            config_path=args.config or args.top_config,
+            workspace=args.workspace or args.top_workspace,
+        )
+        return
+
+    if args.command == "evolution":
+        from echo_agent.cli.evolution_cmd import run_evolution_command
+        target = getattr(args, "target", "") or ""
+        skill = ""
+        candidate_id = ""
+        if args.action == "rollback":
+            skill = target
+        elif args.action in ("show-candidate", "promote"):
+            candidate_id = target
+        try:
+            run_evolution_command(
+                action=args.action,
+                skill=skill,
+                status_filter=getattr(args, "status_filter", "") or "",
+                candidate_id=candidate_id,
+                config_path=args.config or args.top_config,
+                workspace=args.workspace or args.top_workspace,
+            )
+        except KeyboardInterrupt:
+            pass
+        return
+
+    # "run" command or no command (backward compat)
+    config_path = getattr(args, "config", None) or args.top_config
+    workspace = getattr(args, "workspace", None) or args.top_workspace
+
+    from echo_agent.cli.setup import prompt_first_run_setup
+    if prompt_first_run_setup(config_path=config_path, workspace=workspace):
+        return
+
+    from echo_agent.app import run
+    try:
+        asyncio.run(run(config_path=config_path, workspace=workspace))
+    except KeyboardInterrupt:
+        pass
+
+
+if __name__ == "__main__":
+    main()

{echo_agent-0.1.0 → echo_agent-0.2.1}/echo_agent/a2a/protocol.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import json
 from typing import Any, Callable, Awaitable
 
 from loguru import logger