@robota-sdk/agent-transport-http 3.0.0-beta.43

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Robota Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @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
+
+```bash
+pnpm add @robota-sdk/agent-transport-http
+```
+
+## Usage
+
+```typescript
+import { createAgentRoutes } from '@robota-sdk/agent-transport-http';
+import { InteractiveSession, SystemCommandExecutor } from '@robota-sdk/agent-sdk';
+import { Hono } from 'hono';
+
+const app = new Hono();
+
+const routes = createAgentRoutes({
+  sessionFactory: (_req) => interactiveSession, // resolve per-request
+  commandExecutor,
+});
+
+// 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         |
+
+## Dependencies
+
+- `@robota-sdk/agent-sdk` — `InteractiveSession`, `SystemCommandExecutor`
+- `hono` — HTTP framework

package/dist/node/index.cjs

@@ -0,0 +1,123 @@
+"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
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/routes.ts
+var import_hono = require("hono");
+var import_streaming = require("hono/streaming");
+function createAgentRoutes(options) {
+  const { sessionFactory, commandExecutor } = 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 commandExecutor.execute(body.name, session, 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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAgentRoutes
+});

package/dist/node/index.d.cts

@@ -0,0 +1,31 @@
+import { Context, Hono } from 'hono';
+import { InteractiveSession, SystemCommandExecutor } from '@robota-sdk/agent-sdk';
+
+/**
+ * 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 or SystemCommandExecutor API.
+ */
+
+/** Callback that resolves an InteractiveSession from the request context. */
+type ISessionFactory = (c: Context) => InteractiveSession | Promise<InteractiveSession>;
+interface IAgentRoutesOptions {
+    /** Resolve an InteractiveSession per request (e.g., by auth token, session ID). */
+    sessionFactory: ISessionFactory;
+    /** System command executor. */
+    commandExecutor: SystemCommandExecutor;
+}
+/**
+ * Create a Hono router with all agent HTTP endpoints.
+ *
+ * Usage:
+ * ```typescript
+ * const routes = createAgentRoutes({ sessionFactory, commandExecutor });
+ * app.route('/agent', routes);          // mount on existing app
+ * export default routes;                // or use standalone (CF Workers)
+ * ```
+ */
+declare function createAgentRoutes(options: IAgentRoutesOptions): Hono;
+
+export { type IAgentRoutesOptions, type ISessionFactory, createAgentRoutes };

package/dist/node/index.d.ts

@@ -0,0 +1,31 @@
+import { Context, Hono } from 'hono';
+import { InteractiveSession, SystemCommandExecutor } from '@robota-sdk/agent-sdk';
+
+/**
+ * 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 or SystemCommandExecutor API.
+ */
+
+/** Callback that resolves an InteractiveSession from the request context. */
+type ISessionFactory = (c: Context) => InteractiveSession | Promise<InteractiveSession>;
+interface IAgentRoutesOptions {
+    /** Resolve an InteractiveSession per request (e.g., by auth token, session ID). */
+    sessionFactory: ISessionFactory;
+    /** System command executor. */
+    commandExecutor: SystemCommandExecutor;
+}
+/**
+ * Create a Hono router with all agent HTTP endpoints.
+ *
+ * Usage:
+ * ```typescript
+ * const routes = createAgentRoutes({ sessionFactory, commandExecutor });
+ * app.route('/agent', routes);          // mount on existing app
+ * export default routes;                // or use standalone (CF Workers)
+ * ```
+ */
+declare function createAgentRoutes(options: IAgentRoutesOptions): Hono;
+
+export { type IAgentRoutesOptions, type ISessionFactory, createAgentRoutes };

package/dist/node/index.js

@@ -0,0 +1,96 @@
+// src/routes.ts
+import { Hono } from "hono";
+import { streamSSE } from "hono/streaming";
+function createAgentRoutes(options) {
+  const { sessionFactory, commandExecutor } = 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 commandExecutor.execute(body.name, session, 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;
+}
+export {
+  createAgentRoutes
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@robota-sdk/agent-transport-http",
+  "version": "3.0.0-beta.43",
+  "description": "HTTP transport adapter for exposing InteractiveSession over REST API",
+  "type": "module",
+  "main": "dist/node/index.js",
+  "types": "dist/node/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "node": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.cjs"
+      },
+      "default": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "hono": "^4.7.0",
+    "@robota-sdk/agent-sdk": "3.0.0-beta.43"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.1"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --out-dir dist/node --clean",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ --ext .ts",
+    "clean": "rimraf dist"
+  }
+}