@vincemakes/kiso-server 0.41.2 → 0.42.0

package/README.md

@@ -96,5 +96,8 @@ here once: `id: <seq>` / `event: <type>` / `data: <WireEvent>`, an `: open`
 preamble, `Last-Event-ID` and `?after`, a keepalive; `in_flight` and
 `open_run` are 409, `draining` 503, `forbidden` 403. Wire events are the
 projection in `@vincemakes/kiso-protocol` — never the durable event.
-`authorize` is required: there is no default that allows.
-
+`authorize` is required: there is no default that allows. `prepareInput`
+may answer a request itself — write the product's own status and body to
+the response it receives and return `{ handled: true }`; nothing is opened
+and no run starts (a gate, a quota, an attachment check, in the product's
+own shape).

package/dist/http.d.ts

@@ -33,14 +33,23 @@ export interface HttpHandlerOptions {
     readonly authorize: (req: IncomingMessage, sessionId: string) => Promise<boolean> | boolean;
     /** Frames a product adds beside a wire event on the same connection. */
     readonly augment?: (event: Event, sessionId: string) => readonly WireFrame[] | Promise<readonly WireFrame[]>;
-    /** The product's turn preparation; default: `body.input` as given. */
-    readonly prepareInput?: (body: Readonly<Record<string, unknown>>, req: IncomingMessage, sessionId: string) => WireInput | Promise<WireInput>;
+    /** The product's turn preparation; default: `body.input` as given.
+     *  0.42.0: it may instead ANSWER the request itself — write the
+     *  product's own status and body to `res` and return `{ handled: true }`;
+     *  the handler then returns without opening a run, a session, or a 400
+     *  (a gate, a quota, an attachment check, an empty message — the
+     *  product's refusals in the product's shape). */
+    readonly prepareInput?: (body: Readonly<Record<string, unknown>>, req: IncomingMessage, sessionId: string, res: ServerResponse) => WireInput | Handled | Promise<WireInput | Handled>;
     readonly projection?: ProjectionOptions;
     /** `: keepalive` comments on an idle stream. Default 15 s; 0 disables. */
     readonly keepaliveMs?: number;
     /** Request-body cap in bytes. Default 1 MiB. */
     readonly bodyLimit?: number;
 }
+/** What `prepareInput` returns when it answered the request itself. */
+export interface Handled {
+    readonly handled: true;
+}
 export interface HttpHandler {
     /** True when the request was an agent route and has been answered. */
     readonly handle: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;

package/dist/http.js

@@ -54,9 +54,9 @@ export function createHttpHandler(service, options) {
             throw new BadRequest("body must be a JSON object");
         return parsed;
     };
-    const inputOf = async (body, req, sessionId) => {
+    const inputOf = async (body, req, sessionId, res) => {
         if (options.prepareInput !== undefined)
-            return options.prepareInput(body, req, sessionId);
+            return options.prepareInput(body, req, sessionId, res);
         const input = body["input"];
         if (typeof input === "string") {
             if (input.trim() === "")
@@ -191,7 +191,9 @@ export function createHttpHandler(service, options) {
             if (action === "run" || action === "resume") {
                 let handle;
                 if (action === "run") {
-                    const input = await inputOf(body, req, sessionId);
+                    const input = await inputOf(body, req, sessionId, res);
+                    if (isHandled(input))
+                        return true; // the product answered; nothing opened
                     const source = body["source"];
                     handle = await service.run(sessionId, input, {
                         ...(source === "user" || source === "suggestion" || source === "tool_result" ? { source: source } : {}),
@@ -245,6 +247,9 @@ export function createHttpHandler(service, options) {
     };
     return { handle };
 }
+function isHandled(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v) && v.handled === true;
+}
 class BadRequest extends Error {
     constructor(message) {
         super(message);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-server",
-	"version": "0.41.2",
+	"version": "0.42.0",
 	"description": "kiso server — the hosted-session service: many durable sessions in one process, observers with exact replay from a sequence number, approve / abort / resume routed to the right run, drain and close. No transport; a product supplies the agent factory.",
 	"type": "module",
 	"license": "MIT",
@@ -25,12 +25,12 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-core": "0.41.2",
-		"@vincemakes/kiso-protocol": "0.41.2",
-		"@vincemakes/kiso-runtime": "0.41.2"
+		"@vincemakes/kiso-core": "0.42.0",
+		"@vincemakes/kiso-protocol": "0.42.0",
+		"@vincemakes/kiso-runtime": "0.42.0"
 	},
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.41.2",
+		"@vincemakes/kiso-evals": "0.42.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"