异步业务工具
用具名异步函数连接现有 API。写工具每次调用都经过项目授权。
PYTHON / AGENT RUNTIMEALPHA 0.1.0
让业务拥有自己的 Agent 入口。
将已有 Python 服务接成可对话的工具。终端、上下文与取消由库处理，业务与权限仍由项目掌握。
本地源码可用 · 未发布到 PyPI · 无内置 shell 工具
命令演示 · 不执行请求
01 / THE EXECUTION PATH
一个循环，各自负责。
SDK 驱动唯一的模型与工具循环。Runtime 管理准入、预算与清理，项目逐次判断业务权限。
01项目绑定显式选择 Project 与可信插件
02上下文准入检查窗口、历史、schema 与预留
03模型循环模型与工具往返使用同一循环
04项目授权逐次检查；写操作默认拒绝
05清理与返回取消收尾，返回状态与元数据
流程高亮用于解释执行路径，不代表正在运行 Agent。未知写结果由项目核实，不自动重放。
02 / WHY A SEPARATE ENTRY
业务已经有了，入口可以复用。
适合已有 Python 服务的业务助手。开发代码、修改文件等需求，可直接选择成熟的编程 Agent。
| 接入工作 | 项目重复实现 | 本库的分工 |
|---|---|---|
| 连续交互 | 输入、输出、停止与消息队列 | 复用终端与取消收尾 |
| 业务执行 | 服务调用和访问权限 | 项目提供 Tool 与 authorize |
| 上下文管理 | 窗口、摘要、保存与恢复 | 统一检查，显式保存摘要 |
| 执行排查 | 阶段、循环次数和用量缺口 | 执行 ID 与安全元数据回调 |
03 / SMALL SURFACE, EXPLICIT BEHAVIOR
真实 CLI 输出 · 上下文诊断，不调用模型
接得进去，边界也看得见。
Alpha 阶段，API 保持小而明确。插件是可信的本地代码，不是操作系统沙箱。
上下文与摘要
指令、schema、历史和预留共同参与窗口估算。只有显式 /save 持久化摘要。
停止与会话控制
流式输出、队列暂停、项目作用域隔离。清理未完成时阻止新轮次。
安全执行元数据
通过 on_event 接出阶段、耗时与已知／未知用量。私有推理正文不进入界面与默认账本。
04 / GET STARTED
先接一个只读工具。
macOS / Linux，Python 3.13+ 与 uv。模型和凭据由你配置；本页不发出模型请求。
LOCAL CHECKOUT / SHELL
uv sync --locked --extra dev uv run --locked agent-entry --help uv run --locked agent-entry --diagnostics
在本地源码目录运行。诊断无需凭据；真实对话前设置环境变量中的模型与 API key，CLI 不自动加载 .env。
PROJECT API
from agent_entry_cli import Project, Tool, run_cli
# existing_api: your named async function
project = Project(root=project_root,
tools=(Tool(existing_api),))
run_cli(project)
上方 API 片段仅展示接口；完整可运行插件见接入说明。
05 / EXTEND YOUR PROJECT
从业务函数，到项目主助手。
业务适配留在项目里；只有多个项目都需要的通用能力，才进入公共库。
agent-entry-cli/
src/agent_entry_cli/
project.py · Project / Tool /
ToolCallruntime.py · Runtimeterminal.py · terminal interfaceconversation.py · context / summary
examples/
knowledge/ · read-only noteseval-harness/ · optional status
adapter
docs/
integration.mdterminal.mdarchitecture.md
scripts/
check_release.pyverify_distribution.pyverify_site.mjs
-
01 · 接入业务服务
注册异步 Tool；先核对真实只读范围，再加入受控写授权、幂等和结果核实。
-
02 · 复用运行时
用 Runtime 接自有界面或任务服务，项目管理用户身份、会话隔离与取消。
-
03 · 接出观测数据
通过 on_event 接有界队列，由项目导出安全元数据。MCP、Skills、多 Agent 尚未内置。
发布状态：源码已在 GitHub 公开，官方页已通过 GitHub Pages 部署。当前为 Alpha 0.1.0，尚未发布 PyPI 包或 GitHub Release。本项目没有内置定时任务。
YOUR PROJECT. YOUR TOOLS. YOUR POLICY.