SDK HTTP 端点

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

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

它们由 city.http() 返回的 City HTTP transport 暴露。City 可以直接启动 HTTP server， 也可以将 router 挂载到 Downcity gateway 等宿主 server 上。

当前核心包括：

  • GET /api/sdk/sessions
  • POST /api/sdk/sessions
  • GET /api/sdk/sessions/:session_id
  • POST /api/sdk/sessions/:session_id/prompt
  • GET /api/sdk/sessions/:session_id/events
  • GET /api/sdk/sessions/:session_id/messages
  • GET /api/sdk/sessions/:session_id/system
  • GET /api/sdk/sessions/:session_id/interactions
  • GET /api/sdk/sessions/:session_id/status
  • POST /api/sdk/sessions/:session_id/set
  • POST /api/sdk/sessions/:session_id/respond
  • POST /api/sdk/sessions/:session_id/fork
  • POST /api/sdk/sessions/:session_id/archive
  • GET / DELETE /api/sdk/archived-sessions
  • POST /api/powers/action

设计目标

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

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

典型使用方式

downcity on