@rcrsr/rill-agent-http 0.18.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Bremer
+
+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/dist/index.d.ts

@@ -0,0 +1,52 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { Hono } from 'hono';
+
+export interface HandlerDescription {
+	readonly name: string;
+	readonly description?: string | undefined;
+	readonly params: ReadonlyArray<{
+		readonly name: string;
+		readonly type: string;
+		readonly required: boolean;
+		readonly description?: string | undefined;
+		readonly defaultValue?: unknown;
+	}>;
+}
+export interface RunRequest {
+	readonly params?: Record<string, unknown> | undefined;
+	readonly timeout?: number | undefined;
+}
+export interface RunContext {
+	readonly sessionVars?: Record<string, string> | undefined;
+	readonly onLog?: ((message: string) => void) | undefined;
+	readonly onChunk?: ((chunk: unknown) => Promise<void>) | undefined;
+}
+export interface RunResponse {
+	readonly state: "completed" | "error";
+	readonly result: unknown;
+	readonly streamed?: boolean | undefined;
+}
+export interface AgentRouter {
+	run(agentName: string, request: RunRequest, context?: RunContext): Promise<RunResponse>;
+	describe(agentName: string): HandlerDescription | null;
+	agents(): string[];
+	defaultAgent(): string;
+	dispose(): Promise<void>;
+}
+export interface HttpHarness {
+	listen(port?: number): Promise<void>;
+	close(): Promise<void>;
+	readonly app: Hono;
+}
+/**
+ * Create an HTTP harness wrapping an AgentRouter.
+ *
+ * Routes:
+ *   GET  /agents            — list agents with descriptions
+ *   POST /agents/:name/run  — execute a named agent
+ *   POST /run               — execute the default agent
+ */
+export declare function httpHarness(router: AgentRouter): HttpHarness;
+
+export {};

package/dist/index.js

@@ -0,0 +1,109 @@
+// src/index.ts
+import { validateParams, routerErrorToStatus } from "@rcrsr/rill-agent";
+
+// ../../shared/hono-kit/src/index.ts
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+function assertJsonObject(parsed) {
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("Request body must be a JSON object");
+  }
+  return parsed;
+}
+function createHarnessLifecycle(options) {
+  const app = new Hono();
+  let server;
+  async function listen(port) {
+    if (server !== void 0) {
+      throw new Error("Server is already listening");
+    }
+    return new Promise((resolve) => {
+      server = serve({ fetch: app.fetch, port }, () => {
+        options?.serverTweaks?.(server);
+        resolve();
+      });
+    });
+  }
+  async function close() {
+    if (server !== void 0) {
+      server.close();
+      server = void 0;
+    }
+  }
+  return { app, listen, close };
+}
+
+// src/index.ts
+function httpHarness(router) {
+  const lifecycle = createHarnessLifecycle();
+  const { app } = lifecycle;
+  app.get("/agents", (c) => {
+    const names = router.agents();
+    const agents = names.map((name) => ({
+      name,
+      description: router.describe(name),
+      default: name === router.defaultAgent()
+    }));
+    return c.json({ agents });
+  });
+  app.post("/agents/:name/run", async (c) => {
+    const name = c.req.param("name");
+    let body;
+    try {
+      const parsed = await c.req.json();
+      body = assertJsonObject(parsed);
+    } catch {
+      return c.json({ error: "Request body must be a JSON object" }, 400);
+    }
+    const params = body["params"] ?? {};
+    const validationError = validateParams(params, name, router);
+    if (validationError !== null) {
+      return c.json({ error: validationError }, 400);
+    }
+    const request = {
+      params,
+      ...typeof body["timeout"] === "number" ? { timeout: body["timeout"] } : {}
+    };
+    try {
+      const response = await router.run(name, request);
+      return c.json(response);
+    } catch (err) {
+      const status = routerErrorToStatus(err);
+      const message = err instanceof Error ? err.message : String(err);
+      return c.json({ error: message }, status);
+    }
+  });
+  app.post("/run", async (c) => {
+    let body;
+    try {
+      const parsed = await c.req.json();
+      body = assertJsonObject(parsed);
+    } catch {
+      return c.json({ error: "Request body must be a JSON object" }, 400);
+    }
+    const params = body["params"] ?? {};
+    const defaultName = router.defaultAgent();
+    const validationError = validateParams(params, defaultName, router);
+    if (validationError !== null) {
+      return c.json({ error: validationError }, 400);
+    }
+    const request = {
+      params,
+      ...typeof body["timeout"] === "number" ? { timeout: body["timeout"] } : {}
+    };
+    try {
+      const response = await router.run("", request);
+      return c.json(response);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return c.json({ error: message }, 500);
+    }
+  });
+  async function listen(port = 3e3) {
+    return lifecycle.listen(port);
+  }
+  return { listen, close: lifecycle.close, app };
+}
+export {
+  httpHarness
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rcrsr/rill-agent-http",
+  "version": "0.18.5",
+  "description": "rill agent HTTP harness — Hono-based HTTP server wrapping AgentRouter",
+  "license": "MIT",
+  "author": "Andre Bremer",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.12",
+    "hono": "^4.12.10",
+    "@rcrsr/rill-agent": "~0.18.5"
+  },
+  "devDependencies": {
+    "dts-bundle-generator": "^9.5.1",
+    "tsup": "^8.5.0",
+    "@rcrsr/rill-agent-hono-kit": "^0.18.5"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rcrsr/rill-agent.git",
+    "directory": "packages/agent/http"
+  },
+  "scripts": {
+    "build": "tsup && dts-bundle-generator --config dts-bundle-generator.config.cjs && node -e \"const fs=require('fs');const walk=(d)=>fs.readdirSync(d,{withFileTypes:true}).flatMap(e=>e.isDirectory()?walk(d+'/'+e.name):[d+'/'+e.name]);const hits=walk('dist').filter(f=>fs.readFileSync(f,'utf8').includes('@rcrsr/rill-agent-hono-kit'));if(hits.length){console.error('hono-kit leak in dist:',hits);process.exit(1);}\"",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --config ../../../eslint.config.js src/",
+    "check": "pnpm run build && pnpm run test && pnpm run lint"
+  }
+}