@robota-sdk/agent-transport-http

@robota-sdk/agent-transport-http

Hono-based HTTP transport adapter for exposing InteractiveSession over REST API. Compatible with Cloudflare Workers, Node.js, and AWS Lambda.

Installation

pnpm add @robota-sdk/agent-transport-http

Usage

import { createAgentRoutes } from '@robota-sdk/agent-transport-http';
import type { InteractiveSession } from '@robota-sdk/agent-sdk';
import { Hono } from 'hono';

const app = new Hono();

const routes = createAgentRoutes({
  sessionFactory: (_req) => interactiveSession, // resolve per-request
});

// Mount under a prefix
app.route('/agent', routes);

// Or export directly for Cloudflare Workers
export default routes;

The sessionFactory callback receives the Hono request context and returns an InteractiveSession. Use this to resolve sessions by auth token, session ID, or any request-scoped data.

Endpoints

Method	Path	Request Body	Response	Description
POST	/submit	{ prompt: string }	SSE stream	Submit prompt, stream events
POST	/command	{ name: string, args: string }	ICommandResult JSON	Execute system command
POST	/abort	—	{ ok: true }	Abort current execution
POST	/cancel-queue	—	{ ok: true }	Cancel queued prompt
GET	/messages	—	TUniversalMessage[] JSON	Get message history
GET	/context	—	IContextWindowState JSON	Get context window state
GET	/executing	—	{ executing: boolean } JSON	Check if currently executing
GET	/pending	—	{ pending: string|null } JSON	Get queued prompt

SSE Event Types (POST /submit)

Event	Data	Description
text_delta	{ delta: string }	Streaming text chunk
tool_start	IToolState	Tool execution began
tool_end	IToolState	Tool execution finished
thinking	{ isThinking: boolean }	Execution state changed
complete	IExecutionResult	Prompt completed
interrupted	IExecutionResult	Execution was aborted
error	{ message: string }	Execution error

ITransportAdapter

The HTTP transport implements the ITransportAdapter interface from @robota-sdk/agent-sdk:

import { createHttpTransport } from '@robota-sdk/agent-transport-http';
import type { ITransportAdapter } from '@robota-sdk/agent-sdk';

const transport: ITransportAdapter = createHttpTransport();

transport.attach(interactiveSession);
await transport.start();

// Access the Hono app for serving
const app = transport.getApp();

Dependencies

• @robota-sdk/agent-sdk — InteractiveSession
• hono — HTTP framework