@robota-sdk/agent-transport-http 3.0.0-beta.63 → 3.0.0-beta.77

package/README.md

@@ -1,78 +1,47 @@
 # @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.
+HTTP transport (built on [Hono](https://hono.dev)) for the Robota SDK. It exposes a running
+`IInteractiveSession` over HTTP routes so a browser, another service, or any HTTP client can
+drive an agent session.
 
 ## Installation
 
 ```bash
+npm install @robota-sdk/agent-transport-http
+# or
 pnpm add @robota-sdk/agent-transport-http
 ```
 
 ## Usage
 
+`createAgentRoutes` builds the agent route handlers from a `sessionFactory` that resolves an
+`IInteractiveSession` per request (e.g. by auth token or session id). `createHttpTransport`
+wraps them as a mountable transport with an optional `basePath`.
+
+<!-- doc-example-skip: requires the host app's hono dependency -->
+
 ```typescript
 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;
+app.route(
+  '/agent',
+  createAgentRoutes({
+    // Resolve (or create) the session for this request.
+    sessionFactory: (c) => resolveSessionForRequest(c),
+  }),
+);
 ```
 
-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`:
-
-```typescript
-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();
-```
+## Exports
 
-## Dependencies
+| Symbol                  | Kind      | Description                                               |
+| ----------------------- | --------- | --------------------------------------------------------- |
+| `createHttpTransport`   | function  | `(options?: IHttpTransportOptions)` — mountable transport |
+| `createAgentRoutes`     | function  | `(options: IAgentRoutesOptions)` — Hono agent routes      |
+| `IHttpTransportOptions` | interface | `{ basePath?: string }`                                   |
+| `IAgentRoutesOptions`   | interface | `{ sessionFactory: TSessionFactory }`                     |
+| `TSessionFactory`       | type      | Resolves an `IInteractiveSession` per request             |
 
-- `@robota-sdk/agent-sdk` — `InteractiveSession`
-- `hono` — HTTP framework
+See [docs/SPEC.md](./docs/SPEC.md) for the full contract and route surface.

package/dist/node/index.cjs

@@ -1,148 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  createAgentRoutes: () => createAgentRoutes,
-  createHttpTransport: () => createHttpTransport
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/routes.ts
-var import_hono = require("hono");
-var import_streaming = require("hono/streaming");
-function createAgentRoutes(options) {
-  const { sessionFactory } = options;
-  const app = new import_hono.Hono();
-  app.post("/submit", async (c) => {
-    const session = await sessionFactory(c);
-    const body = await c.req.json();
-    if (!body.prompt || typeof body.prompt !== "string") {
-      return c.json({ error: "prompt is required" }, 400);
-    }
-    return (0, import_streaming.streamSSE)(c, async (stream) => {
-      const cleanup = [];
-      const subscribe = (event, handler) => {
-        session.on(event, handler);
-        cleanup.push(() => session.off(event, handler));
-      };
-      let completed = false;
-      const done = new Promise((resolve) => {
-        subscribe("text_delta", (delta) => {
-          stream.writeSSE({ event: "text_delta", data: JSON.stringify({ delta }) });
-        });
-        subscribe("tool_start", (state) => {
-          stream.writeSSE({ event: "tool_start", data: JSON.stringify(state) });
-        });
-        subscribe("tool_end", (state) => {
-          stream.writeSSE({ event: "tool_end", data: JSON.stringify(state) });
-        });
-        subscribe("thinking", (isThinking) => {
-          stream.writeSSE({ event: "thinking", data: JSON.stringify({ isThinking }) });
-          if (!isThinking && completed) {
-            resolve();
-          }
-        });
-        subscribe("complete", (result) => {
-          completed = true;
-          stream.writeSSE({ event: "complete", data: JSON.stringify(result) });
-        });
-        subscribe("interrupted", (result) => {
-          completed = true;
-          stream.writeSSE({ event: "interrupted", data: JSON.stringify(result) });
-        });
-        subscribe("error", (error) => {
-          completed = true;
-          stream.writeSSE({ event: "error", data: JSON.stringify({ message: error.message }) });
-        });
-      });
-      await session.submit(body.prompt);
-      await done;
-      for (const fn of cleanup) fn();
-    });
-  });
-  app.post("/command", async (c) => {
-    const session = await sessionFactory(c);
-    const body = await c.req.json();
-    if (!body.name || typeof body.name !== "string") {
-      return c.json({ error: "name is required" }, 400);
-    }
-    const result = await session.executeCommand(body.name, body.args ?? "");
-    if (!result) {
-      return c.json({ error: `Unknown command: ${body.name}` }, 404);
-    }
-    return c.json(result);
-  });
-  app.post("/abort", async (c) => {
-    const session = await sessionFactory(c);
-    session.abort();
-    return c.json({ ok: true });
-  });
-  app.post("/cancel-queue", async (c) => {
-    const session = await sessionFactory(c);
-    session.cancelQueue();
-    return c.json({ ok: true });
-  });
-  app.get("/messages", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json(session.getMessages());
-  });
-  app.get("/context", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json(session.getContextState());
-  });
-  app.get("/executing", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json({ executing: session.isExecuting() });
-  });
-  app.get("/pending", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json({ pending: session.getPendingPrompt() });
-  });
-  return app;
-}
-
-// src/http-transport.ts
-function createHttpTransport(options) {
-  let session = null;
-  let app = null;
-  return {
-    name: "http",
-    attach(s) {
-      session = s;
-    },
-    async start() {
-      if (!session) throw new Error("No session attached. Call attach() first.");
-      app = createAgentRoutes({ sessionFactory: () => session });
-    },
-    async stop() {
-      app = null;
-    },
-    getApp() {
-      if (!app) throw new Error("Transport not started. Call start() first.");
-      return app;
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createAgentRoutes,
-  createHttpTransport
-});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("hono"),t=require("hono/streaming");function n(n){let{sessionFactory:r}=n,i=new e.Hono;return i.post(`/submit`,async e=>{let n=await r(e),i=await e.req.json();return!i.prompt||typeof i.prompt!=`string`?e.json({error:`prompt is required`},400):(0,t.streamSSE)(e,async e=>{let t=[],r=(e,r)=>{n.on(e,r),t.push(()=>n.off(e,r))},a=!1,o=new Promise(t=>{r(`text_delta`,t=>{e.writeSSE({event:`text_delta`,data:JSON.stringify({delta:t})})}),r(`tool_start`,t=>{e.writeSSE({event:`tool_start`,data:JSON.stringify(t)})}),r(`tool_end`,t=>{e.writeSSE({event:`tool_end`,data:JSON.stringify(t)})}),r(`thinking`,n=>{e.writeSSE({event:`thinking`,data:JSON.stringify({isThinking:n})}),!n&&a&&t()}),r(`complete`,t=>{a=!0,e.writeSSE({event:`complete`,data:JSON.stringify(t)})}),r(`interrupted`,t=>{a=!0,e.writeSSE({event:`interrupted`,data:JSON.stringify(t)})}),r(`error`,t=>{a=!0,e.writeSSE({event:`error`,data:JSON.stringify({message:t.message})})})});await n.submit(i.prompt),await o;for(let e of t)e()})}),i.post(`/command`,async e=>{let t=await r(e),n=await e.req.json();if(!n.name||typeof n.name!=`string`)return e.json({error:`name is required`},400);let i=await t.executeCommand(n.name,n.args??``);return i?e.json(i):e.json({error:`Unknown command: ${n.name}`},404)}),i.post(`/abort`,async e=>((await r(e)).abort(),e.json({ok:!0}))),i.post(`/cancel-queue`,async e=>((await r(e)).cancelQueue(),e.json({ok:!0}))),i.get(`/messages`,async e=>{let t=await r(e);return e.json(t.getMessages())}),i.get(`/context`,async e=>{let t=await r(e);return e.json(t.getContextState())}),i.get(`/executing`,async e=>{let t=await r(e);return e.json({executing:t.isExecuting()})}),i.get(`/pending`,async e=>{let t=await r(e);return e.json({pending:t.getPendingPrompt()})}),i}function r(e){let t=null,r=null;return{name:`http`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);r=n({sessionFactory:()=>t})},async stop(){r=null},getApp(){if(!r)throw Error(`Transport not started. Call start() first.`);return r}}}exports.createAgentRoutes=n,exports.createHttpTransport=r;

package/dist/node/index.d.ts

@@ -1,18 +1,12 @@
-import { Context, Hono } from 'hono';
-import { InteractiveSession, ITransportAdapter } from '@robota-sdk/agent-sdk';
+import { Context, Hono } from "hono";
+import { IInteractiveSession, ITransportAdapter } from "@robota-sdk/agent-interface-transport";
 
-/**
- * HTTP transport adapter — exposes InteractiveSession over REST API.
- *
- * Built on Hono for Cloudflare Workers + Node.js + AWS Lambda compatibility.
- * Each endpoint maps 1:1 to an InteractiveSession API method.
- */
-
-/** Callback that resolves an InteractiveSession from the request context. */
-type ISessionFactory = (c: Context) => InteractiveSession | Promise<InteractiveSession>;
+//#region src/routes.d.ts
+/** Callback that resolves an IInteractiveSession from the request context. */
+type TSessionFactory = (c: Context) => IInteractiveSession | Promise<IInteractiveSession>;
 interface IAgentRoutesOptions {
-    /** Resolve an InteractiveSession per request (e.g., by auth token, session ID). */
-    sessionFactory: ISessionFactory;
+  /** Resolve an IInteractiveSession per request (e.g., by auth token, session ID). */
+  sessionFactory: TSessionFactory;
 }
 /**
  * Create a Hono router with all agent HTTP endpoints.
@@ -25,20 +19,15 @@ interface IAgentRoutesOptions {
  * ```
  */
 declare function createAgentRoutes(options: IAgentRoutesOptions): Hono;
-
-/**
- * ITransportAdapter implementation for HTTP transport.
- *
- * Wraps createAgentRoutes into the unified ITransportAdapter interface
- * while exposing the underlying Hono app via getApp().
- */
-
+//#endregion
+//#region src/http-transport.d.ts
 interface IHttpTransportOptions {
-    /** Optional: base path prefix for routes. */
-    basePath?: string;
+  /** Optional: base path prefix for routes. */
+  basePath?: string;
 }
-declare function createHttpTransport(options?: IHttpTransportOptions): ITransportAdapter & {
-    getApp(): Hono;
+declare function createHttpTransport(options?: IHttpTransportOptions): ITransportAdapter<IInteractiveSession> & {
+  getApp(): Hono;
 };
-
-export { type IAgentRoutesOptions, type IHttpTransportOptions, type ISessionFactory, createAgentRoutes, createHttpTransport };
+//#endregion
+export { type IAgentRoutesOptions, type IHttpTransportOptions, type TSessionFactory, createAgentRoutes, createHttpTransport };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/routes.ts","../../src/http-transport.ts"],"mappings":";;;;;KAcY,eAAA,IAAmB,CAAA,EAAG,OAAA,KAAY,mBAAA,GAAsB,OAAA,CAAQ,mBAAA;AAAA,UAE3D,mBAAA;EAF0D;EAIzE,cAAA,EAAgB,eAAe;AAAA;;;;;AAJ8D;AAE/F;;;;AAEiC;iBAajB,iBAAA,CAAkB,OAAA,EAAS,mBAAA,GAAsB,IAAI;;;UCnBpD,qBAAA;EDE2D;ECA1E,QAAQ;AAAA;AAAA,iBAGM,mBAAA,CACd,OAAA,GAAU,qBAAA,GACT,iBAAA,CAAkB,mBAAA;EAAyB,MAAA,IAAU,IAAA;AAAA"}

package/dist/node/index.js

@@ -1,120 +1,2 @@
-// src/routes.ts
-import { Hono } from "hono";
-import { streamSSE } from "hono/streaming";
-function createAgentRoutes(options) {
-  const { sessionFactory } = options;
-  const app = new Hono();
-  app.post("/submit", async (c) => {
-    const session = await sessionFactory(c);
-    const body = await c.req.json();
-    if (!body.prompt || typeof body.prompt !== "string") {
-      return c.json({ error: "prompt is required" }, 400);
-    }
-    return streamSSE(c, async (stream) => {
-      const cleanup = [];
-      const subscribe = (event, handler) => {
-        session.on(event, handler);
-        cleanup.push(() => session.off(event, handler));
-      };
-      let completed = false;
-      const done = new Promise((resolve) => {
-        subscribe("text_delta", (delta) => {
-          stream.writeSSE({ event: "text_delta", data: JSON.stringify({ delta }) });
-        });
-        subscribe("tool_start", (state) => {
-          stream.writeSSE({ event: "tool_start", data: JSON.stringify(state) });
-        });
-        subscribe("tool_end", (state) => {
-          stream.writeSSE({ event: "tool_end", data: JSON.stringify(state) });
-        });
-        subscribe("thinking", (isThinking) => {
-          stream.writeSSE({ event: "thinking", data: JSON.stringify({ isThinking }) });
-          if (!isThinking && completed) {
-            resolve();
-          }
-        });
-        subscribe("complete", (result) => {
-          completed = true;
-          stream.writeSSE({ event: "complete", data: JSON.stringify(result) });
-        });
-        subscribe("interrupted", (result) => {
-          completed = true;
-          stream.writeSSE({ event: "interrupted", data: JSON.stringify(result) });
-        });
-        subscribe("error", (error) => {
-          completed = true;
-          stream.writeSSE({ event: "error", data: JSON.stringify({ message: error.message }) });
-        });
-      });
-      await session.submit(body.prompt);
-      await done;
-      for (const fn of cleanup) fn();
-    });
-  });
-  app.post("/command", async (c) => {
-    const session = await sessionFactory(c);
-    const body = await c.req.json();
-    if (!body.name || typeof body.name !== "string") {
-      return c.json({ error: "name is required" }, 400);
-    }
-    const result = await session.executeCommand(body.name, body.args ?? "");
-    if (!result) {
-      return c.json({ error: `Unknown command: ${body.name}` }, 404);
-    }
-    return c.json(result);
-  });
-  app.post("/abort", async (c) => {
-    const session = await sessionFactory(c);
-    session.abort();
-    return c.json({ ok: true });
-  });
-  app.post("/cancel-queue", async (c) => {
-    const session = await sessionFactory(c);
-    session.cancelQueue();
-    return c.json({ ok: true });
-  });
-  app.get("/messages", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json(session.getMessages());
-  });
-  app.get("/context", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json(session.getContextState());
-  });
-  app.get("/executing", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json({ executing: session.isExecuting() });
-  });
-  app.get("/pending", async (c) => {
-    const session = await sessionFactory(c);
-    return c.json({ pending: session.getPendingPrompt() });
-  });
-  return app;
-}
-
-// src/http-transport.ts
-function createHttpTransport(options) {
-  let session = null;
-  let app = null;
-  return {
-    name: "http",
-    attach(s) {
-      session = s;
-    },
-    async start() {
-      if (!session) throw new Error("No session attached. Call attach() first.");
-      app = createAgentRoutes({ sessionFactory: () => session });
-    },
-    async stop() {
-      app = null;
-    },
-    getApp() {
-      if (!app) throw new Error("Transport not started. Call start() first.");
-      return app;
-    }
-  };
-}
-export {
-  createAgentRoutes,
-  createHttpTransport
-};
+import{Hono as e}from"hono";import{streamSSE as t}from"hono/streaming";function n(n){let{sessionFactory:r}=n,i=new e;return i.post(`/submit`,async e=>{let n=await r(e),i=await e.req.json();return!i.prompt||typeof i.prompt!=`string`?e.json({error:`prompt is required`},400):t(e,async e=>{let t=[],r=(e,r)=>{n.on(e,r),t.push(()=>n.off(e,r))},a=!1,o=new Promise(t=>{r(`text_delta`,t=>{e.writeSSE({event:`text_delta`,data:JSON.stringify({delta:t})})}),r(`tool_start`,t=>{e.writeSSE({event:`tool_start`,data:JSON.stringify(t)})}),r(`tool_end`,t=>{e.writeSSE({event:`tool_end`,data:JSON.stringify(t)})}),r(`thinking`,n=>{e.writeSSE({event:`thinking`,data:JSON.stringify({isThinking:n})}),!n&&a&&t()}),r(`complete`,t=>{a=!0,e.writeSSE({event:`complete`,data:JSON.stringify(t)})}),r(`interrupted`,t=>{a=!0,e.writeSSE({event:`interrupted`,data:JSON.stringify(t)})}),r(`error`,t=>{a=!0,e.writeSSE({event:`error`,data:JSON.stringify({message:t.message})})})});await n.submit(i.prompt),await o;for(let e of t)e()})}),i.post(`/command`,async e=>{let t=await r(e),n=await e.req.json();if(!n.name||typeof n.name!=`string`)return e.json({error:`name is required`},400);let i=await t.executeCommand(n.name,n.args??``);return i?e.json(i):e.json({error:`Unknown command: ${n.name}`},404)}),i.post(`/abort`,async e=>((await r(e)).abort(),e.json({ok:!0}))),i.post(`/cancel-queue`,async e=>((await r(e)).cancelQueue(),e.json({ok:!0}))),i.get(`/messages`,async e=>{let t=await r(e);return e.json(t.getMessages())}),i.get(`/context`,async e=>{let t=await r(e);return e.json(t.getContextState())}),i.get(`/executing`,async e=>{let t=await r(e);return e.json({executing:t.isExecuting()})}),i.get(`/pending`,async e=>{let t=await r(e);return e.json({pending:t.getPendingPrompt()})}),i}function r(e){let t=null,r=null;return{name:`http`,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);r=n({sessionFactory:()=>t})},async stop(){r=null},getApp(){if(!r)throw Error(`Transport not started. Call start() first.`);return r}}}export{n as createAgentRoutes,r as createHttpTransport};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/routes.ts","../../src/http-transport.ts"],"sourcesContent":["/**\n * HTTP transport adapter — exposes IInteractiveSession over REST API.\n *\n * Built on Hono for Cloudflare Workers + Node.js + AWS Lambda compatibility.\n * Each endpoint maps 1:1 to an IInteractiveSession API method.\n */\n\nimport { Hono } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport type { IInteractiveSession } from '@robota-sdk/agent-interface-transport';\nimport type { Context } from 'hono';\n\n/** Callback that resolves an IInteractiveSession from the request context. */\nexport type TSessionFactory = (c: Context) => IInteractiveSession | Promise<IInteractiveSession>;\n\nexport interface IAgentRoutesOptions {\n  /** Resolve an IInteractiveSession per request (e.g., by auth token, session ID). */\n  sessionFactory: TSessionFactory;\n}\n\n/**\n * Create a Hono router with all agent HTTP endpoints.\n *\n * Usage:\n * ```typescript\n * const routes = createAgentRoutes({ sessionFactory });\n * app.route('/agent', routes);          // mount on existing app\n * export default routes;                // or use standalone (CF Workers)\n * ```\n */\nexport function createAgentRoutes(options: IAgentRoutesOptions): Hono {\n  const { sessionFactory } = options;\n  const app = new Hono();\n\n  // POST /submit — execute prompt, stream events via SSE\n  app.post('/submit', async (c) => {\n    const session = await sessionFactory(c);\n    const body = await c.req.json<{ prompt: string }>();\n\n    if (!body.prompt || typeof body.prompt !== 'string') {\n      return c.json({ error: 'prompt is required' }, 400);\n    }\n\n    return streamSSE(c, async (stream) => {\n      const cleanup: Array<() => void> = [];\n\n      const subscribe = <T>(event: string, handler: (data: T) => void): void => {\n        session.on(event as 'text_delta', handler as () => void);\n        cleanup.push(() => session.off(event as 'text_delta', handler as () => void));\n      };\n\n      let completed = false;\n      const done = new Promise<void>((resolve) => {\n        subscribe('text_delta', (delta: string) => {\n          stream.writeSSE({ event: 'text_delta', data: JSON.stringify({ delta }) });\n        });\n\n        subscribe('tool_start', (state) => {\n          stream.writeSSE({ event: 'tool_start', data: JSON.stringify(state) });\n        });\n\n        subscribe('tool_end', (state) => {\n          stream.writeSSE({ event: 'tool_end', data: JSON.stringify(state) });\n        });\n\n        subscribe('thinking', (isThinking: boolean) => {\n          stream.writeSSE({ event: 'thinking', data: JSON.stringify({ isThinking }) });\n          if (!isThinking && completed) {\n            resolve();\n          }\n        });\n\n        subscribe('complete', (result) => {\n          completed = true;\n          stream.writeSSE({ event: 'complete', data: JSON.stringify(result) });\n        });\n\n        subscribe('interrupted', (result) => {\n          completed = true;\n          stream.writeSSE({ event: 'interrupted', data: JSON.stringify(result) });\n        });\n\n        subscribe('error', (error: Error) => {\n          completed = true;\n          stream.writeSSE({ event: 'error', data: JSON.stringify({ message: error.message }) });\n        });\n      });\n\n      await session.submit(body.prompt);\n      await done;\n\n      for (const fn of cleanup) fn();\n    });\n  });\n\n  // POST /command — execute system command\n  app.post('/command', async (c) => {\n    const session = await sessionFactory(c);\n    const body = await c.req.json<{ name: string; args?: string }>();\n\n    if (!body.name || typeof body.name !== 'string') {\n      return c.json({ error: 'name is required' }, 400);\n    }\n\n    const result = await session.executeCommand(body.name, body.args ?? '');\n    if (!result) {\n      return c.json({ error: `Unknown command: ${body.name}` }, 404);\n    }\n    return c.json(result);\n  });\n\n  // POST /abort — abort current execution\n  app.post('/abort', async (c) => {\n    const session = await sessionFactory(c);\n    session.abort();\n    return c.json({ ok: true });\n  });\n\n  // POST /cancel-queue — cancel queued prompt\n  app.post('/cancel-queue', async (c) => {\n    const session = await sessionFactory(c);\n    session.cancelQueue();\n    return c.json({ ok: true });\n  });\n\n  // GET /messages — get message history\n  app.get('/messages', async (c) => {\n    const session = await sessionFactory(c);\n    return c.json(session.getMessages());\n  });\n\n  // GET /context — get context window state\n  app.get('/context', async (c) => {\n    const session = await sessionFactory(c);\n    return c.json(session.getContextState());\n  });\n\n  // GET /executing — check if currently executing\n  app.get('/executing', async (c) => {\n    const session = await sessionFactory(c);\n    return c.json({ executing: session.isExecuting() });\n  });\n\n  // GET /pending — get pending queued prompt\n  app.get('/pending', async (c) => {\n    const session = await sessionFactory(c);\n    return c.json({ pending: session.getPendingPrompt() });\n  });\n\n  return app;\n}\n","/**\n * ITransportAdapter implementation for HTTP transport.\n *\n * Wraps createAgentRoutes into the unified ITransportAdapter interface\n * while exposing the underlying Hono app via getApp().\n */\n\nimport { createAgentRoutes } from './routes.js';\n\nimport type { IInteractiveSession, ITransportAdapter } from '@robota-sdk/agent-interface-transport';\nimport type { Hono } from 'hono';\n\nexport interface IHttpTransportOptions {\n  /** Optional: base path prefix for routes. */\n  basePath?: string;\n}\n\nexport function createHttpTransport(\n  options?: IHttpTransportOptions,\n): ITransportAdapter<IInteractiveSession> & { getApp(): Hono } {\n  let session: IInteractiveSession | null = null;\n  let app: Hono | null = null;\n\n  return {\n    name: 'http',\n    attach(s: IInteractiveSession) {\n      session = s;\n    },\n    async start() {\n      if (!session) throw new Error('No session attached. Call attach() first.');\n      app = createAgentRoutes({ sessionFactory: () => session! });\n    },\n    async stop() {\n      app = null;\n    },\n    getApp() {\n      if (!app) throw new Error('Transport not started. Call start() first.');\n      return app;\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@robota-sdk/agent-transport-http",
-  "version": "3.0.0-beta.63",
-  "description": "HTTP transport adapter for exposing InteractiveSession over REST API",
+  "version": "3.0.0-beta.77",
+  "description": "HTTP (Hono) transport for the Robota SDK",
   "type": "module",
   "main": "dist/node/index.js",
   "types": "dist/node/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/node/index.d.ts",
+      "source": "./src/index.ts",
       "node": {
         "import": "./dist/node/index.js",
         "require": "./dist/node/index.cjs"
@@ -26,31 +27,34 @@
   "bugs": {
     "url": "https://github.com/woojubb/robota/issues"
   },
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "dependencies": {
-    "hono": "^4.7.0",
-    "@robota-sdk/agent-sdk": "3.0.0-beta.63"
+    "hono": "^4.12.25",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.77"
   },
   "devDependencies": {
-    "rimraf": "^5.0.5",
-    "tsup": "^8.0.1",
-    "typescript": "^5.3.3",
-    "vitest": "^1.6.1"
+    "rimraf": "^5.0.10",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.6"
   },
-  "license": "MIT",
+  "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --out-dir dist/node --clean",
-    "build:js": "tsup src/index.ts --format esm,cjs --out-dir dist/node --clean",
-    "build:types": "tsup src/index.ts --format esm,cjs --dts-only --out-dir dist/node",
+    "build": "tsdown",
+    "build:js": "tsdown --no-dts",
+    "build:types": "tsdown --dts",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src/ --ext .ts",
     "clean": "rimraf dist"
   }
 }

package/src/__tests__/http-transport.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createHttpTransport } from '../http-transport.js';
+import type { IInteractiveSession } from '@robota-sdk/agent-interface-transport';
+
+function createMockSession(): IInteractiveSession {
+  return {
+    submit: vi.fn(),
+    abort: vi.fn(),
+    cancelQueue: vi.fn(),
+    getMessages: vi.fn().mockReturnValue([]),
+    getContextState: vi
+      .fn()
+      .mockReturnValue({ usedPercentage: 0, usedTokens: 0, maxTokens: 200000 }),
+    isExecuting: vi.fn().mockReturnValue(false),
+    getPendingPrompt: vi.fn().mockReturnValue(null),
+    executeCommand: vi.fn().mockResolvedValue({ message: 'ok', success: true }),
+    listCommands: vi.fn().mockReturnValue([]),
+    on: vi.fn(),
+    off: vi.fn(),
+  } as unknown as IInteractiveSession;
+}
+
+describe('createHttpTransport', () => {
+  it('returns an adapter with name "http"', () => {
+    const transport = createHttpTransport();
+    expect(transport.name).toBe('http');
+  });
+
+  it('throws if start() is called without attach()', async () => {
+    const transport = createHttpTransport();
+    await expect(transport.start()).rejects.toThrow('No session attached');
+  });
+
+  it('throws if getApp() is called before start()', () => {
+    const transport = createHttpTransport();
+    expect(() => transport.getApp()).toThrow('Transport not started');
+  });
+
+  it('creates a Hono app after attach + start', async () => {
+    const transport = createHttpTransport();
+    transport.attach(createMockSession() as never);
+    await transport.start();
+    const app = transport.getApp();
+    expect(app).toBeDefined();
+    expect(typeof app.fetch).toBe('function');
+  });
+
+  it('nullifies app after stop()', async () => {
+    const transport = createHttpTransport();
+    transport.attach(createMockSession() as never);
+    await transport.start();
+    await transport.stop();
+    expect(() => transport.getApp()).toThrow('Transport not started');
+  });
+});