# 统一 `Agent` method 执行路径

`Agent` method 的调用只有一条执行路径。无论是用户从 UI 触发，还是模型
把它选为工具，执行都落在同一个 runtime-block 包装里。

## 执行路径

```text
Web UI
  POST /api/function/{name}
    openprogram.webui.routes.chat.post_function
      dispatcher.dispatch_forced_tool_call(...)
        dispatcher._wrap_agentic_runtime_block(...)
          Agent method wrapper
            runtime.exec(...)
```

模型自己选择工具时不经过 REST endpoint，但进入同一套 dispatcher 工具执行与
runtime-block 包装。

<div id="rest-endpoint"></div>

## REST 端点

`POST /api/function/{name}` 接受：

```json
{
  "session_id": "...",
  "project_id": "...",
  "kwargs": { "task": "..." }
}
```

`session_id` 是可选的。若省略，服务端会创建一个会话。
已有会话可以省略 `project_id`；新会话若存在待绑定的 Project，则首次函数调用
必须携带它。执行目录使用选中的 Project，未选择时回落到配置的默认 Project。

为兼容起见，较旧的调用方可能在顶层直接提交扁平的函数参数。服务端会把这些字段
转换成 `kwargs`，并忽略 `session_id`、`project_id` 等控制键。

响应为：

```json
{
  "session_id": "...",
  "msg_id": "..."
}
```

## `/run` 不是执行 API

输入式的 `/run ...` 聊天命令不是函数执行 API。React 发起的函数调用直接调用
`POST /api/function/{name}`，重试 UI 同样如此。

后端解析器把 `/run ...` 当作普通用户文本，而不将其转换为 `action="run"`。
`/api/run/{name}` 与 WebSocket 的 `action="run"` 都不存在。

部分实现注释和类型名仍写着 `/run` 或 `runtime block`，这是因为该 UI 组件的
命名早于统一 endpoint。这些属于历史措辞，并不定义一条独立的执行路径。
清理命名时的搜索目标：

- `rg "/run|api/run|action=run|action=\"run\"" openprogram web`
- `rg "runtime block|RuntimeBlock" web openprogram`