API Reference

SDK HTTP 端点

Downcity 为 RemoteAgent 暴露的最小 HTTP session 接口集合

SDK HTTP 端点

这组 SDK 路由不属于 Agent 自身。

它们由 @downcity/server 提供的 AgentHTTP 暴露，可作为独立 HTTP server 启动，也可挂到 Downcity gateway 等任何 Hono server 上。

当前核心包括：

  • GET /api/sdk/sessions
  • POST /api/sdk/sessions
  • GET /api/sdk/sessions/:sessionId
  • PUT /api/sdk/sessions/:sessionId/model
  • POST /api/sdk/sessions/:sessionId/prompt
  • GET /api/sdk/sessions/:sessionId/events
  • GET /api/sdk/sessions/:sessionId/messages
  • GET /api/sdk/sessions/:sessionId/system
  • GET /api/sdk/sessions/:sessionId/approvals
  • GET / POST /api/sdk/sessions/:sessionId/approval-mode
  • POST /api/sdk/sessions/:sessionId/approval
  • POST /api/sdk/sessions/:sessionId/fork
  • POST /api/sdk/sessions/:sessionId/archive
  • GET / DELETE /api/sdk/archived-sessions
  • POST /api/plugins/action

设计目标

这套接口不是一个通用“大而全 API”，而是一组尽量小、围绕 session 使用面展开的 SDK 路由。

它的重点不是扩展成复杂平台 API，而是保证本地 Agent 和 RemoteAgent 之间的能力面对齐。

典型使用方式

downcity agent start

Session Mutation

Session.subscribe() 返回的 Mutation 类型与 UI 使用方式

AgentRPC

Agent 的 RPC 传输层 — 跨进程会话访问

目录

SDK HTTP 端点设计目标典型使用方式