Downcity
API Reference

SDK HTTP Endpoints

The minimal HTTP interface a local Agent exposes for RemoteAgent

SDK HTTP Endpoints

The SDK routes currently exposed by a local Agent through agent.start({ http: { ... } }) include:

  • GET /api/sdk/sessions
  • POST /api/sdk/sessions
  • POST /api/sdk/sessions/:sessionId/prompt
  • GET /api/sdk/sessions/:sessionId/events
  • GET /api/sdk/sessions/:sessionId/messages
  • GET /api/sdk/sessions/:sessionId/system
  • POST /api/sdk/sessions/:sessionId/fork

Design goal

This is not meant to be a huge general-purpose platform API.

It is intentionally a small session-centered SDK surface.

The priority is not "grow a complex API platform." The priority is keeping the local Agent and RemoteAgent capability surfaces aligned.

Session Events

Which event types session.subscribe() emits and what each one means

Example: Minimal Local Agent

A minimal runnable local Agent SDK example

Table of Contents

SDK HTTP EndpointsDesign goal