@orkestrel/toolbox 0.0.5 → 0.0.7

package/dist/src/server/index.js

@@ -1,4 +1,6 @@
-import { HEADER_TOKEN, defaultTimer, isAnswerPayload, serializeExpire, serializePending } from "@orkestrel/terminal";
+import { HEADER_TOKEN, defaultTimer, serializeExpire, serializePending } from "@orkestrel/terminal";
+import { isFormValues } from "@orkestrel/form";
+import { isNonEmptyString, isRecord } from "@orkestrel/contract";
 import { ContentTooLargeError, DEFAULT_BODY_LIMIT, collectRequestBody, openStream } from "@orkestrel/server";
 //#region src/server/constants.ts
 /**
@@ -18,13 +20,9 @@ var TERMINAL_KEEPALIVE_MS = 15e3;
 /**
 * Own one terminal SSE connection's replay, subscriptions, keepalive, and teardown.
 *
-* @example
-* ```ts
-* import { TerminalConnection } from '@orkestrel/toolbox/server'
-*
-* const connection = new TerminalConnection(manager, name, request, stream, accepts, timer, 15_000)
-* const response = connection.open()
-* ```
+* Internal to this module: `TerminalRoutes` builds the `accepts` predicate from its own token
+* option and opens the stream, so no consumer can construct one. Reach this behaviour through
+* `createTerminalRoutes`.
 */
 var TerminalConnection = class {
 	#manager;
@@ -43,7 +41,7 @@ var TerminalConnection = class {
 	/**
 	* Create a terminal stream connection.
 	*
-	* @param manager - Terminal manager supplying pending prompts and lifecycle events
+	* @param manager - Terminal manager supplying pending forms and lifecycle events
 	* @param name - Terminal endpoint streamed by this connection
 	* @param request - Request whose abort signal owns the connection lifetime
 	* @param stream - Open SSE stream
@@ -66,7 +64,7 @@ var TerminalConnection = class {
 		this.#tickHandler = this.#tick.bind(this);
 	}
 	/**
-	* Open the connection by replaying pending prompts, subscribing, and arming keepalive handling.
+	* Open the connection by replaying pending forms, subscribing, and arming keepalive handling.
 	*
 	* @returns The SSE response
 	*/
@@ -76,7 +74,7 @@ var TerminalConnection = class {
 			return this.#stream.response;
 		}
 		if (this.#cancel !== void 0) return this.#stream.response;
-		for (const prompt of this.#manager.pending(this.#name)) this.#write(serializePending(prompt));
+		for (const form of this.#manager.pending(this.#name)) this.#write(serializePending(form));
 		this.#manager.emitter.on("pending", this.#pendingHandler);
 		this.#manager.emitter.on("expire", this.#expireHandler);
 		this.#cancel = this.#timer(this.#tickHandler, this.#keepalive);
@@ -90,13 +88,13 @@ var TerminalConnection = class {
 			...wire.id === void 0 ? {} : { id: wire.id }
 		});
 	}
-	#pending(prompt) {
-		if (prompt.to !== this.#name) return;
+	#pending(form) {
+		if (form.to !== this.#name) return;
 		if (this.#stream.closed) {
 			this.#destroy();
 			return;
 		}
-		this.#write(serializePending(prompt));
+		this.#write(serializePending(form));
 	}
 	#expire(to, id) {
 		if (to !== this.#name) return;
@@ -222,11 +220,11 @@ var TerminalRoutes = class {
 		} catch {
 			return new Response(null, { status: 400 });
 		}
-		if (!isAnswerPayload(body)) return new Response(null, { status: 422 });
-		const result = this.#manager.answer(name, body.id, body.value);
-		if (result.success) return new Response(null, { status: 204 });
-		if (result.error === "terminal") return new Response(result.error, { status: 404 });
-		return new Response(result.error, { status: 422 });
+		if (!isRecord(body) || !isNonEmptyString(body.id) || !isFormValues(body.values)) return new Response(null, { status: 422 });
+		const result = this.#manager.answer(name, body.id, body.values);
+		if (result.success) return Response.json(result);
+		if (result.error.reason === "terminal") return Response.json(result, { status: 404 });
+		return Response.json(result, { status: 422 });
 	}
 };
 //#endregion
@@ -257,6 +255,6 @@ function createTerminalRoutes(manager, options) {
 	return new TerminalRoutes(manager, options).routes();
 }
 //#endregion
-export { TERMINAL_KEEPALIVE_MS, TERMINAL_ROUTES_PATH, TerminalConnection, TerminalRoutes, createTerminalRoutes };
+export { TERMINAL_KEEPALIVE_MS, TERMINAL_ROUTES_PATH, TerminalRoutes, createTerminalRoutes };
 
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@orkestrel/toolbox",
-	"version": "0.0.5",
+	"version": "0.0.7",
 	"description": "Concrete LLM-callable tools for the @orkestrel line — workflow authoring, workspace editing, sub-agent delegation, and more, over the @orkestrel/tool runtime, with pluggable stores. Part of the @orkestrel line.",
 	"keywords": [
 		"agent",
@@ -78,20 +78,22 @@
 		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test"
 	},
 	"dependencies": {
-		"@orkestrel/agent": "^0.0.15",
-		"@orkestrel/contract": "^0.0.11",
-		"@orkestrel/database": "^0.0.8",
-		"@orkestrel/relation": "^0.0.8",
-		"@orkestrel/server": "^0.0.12",
-		"@orkestrel/terminal": "^0.0.6",
-		"@orkestrel/tool": "^0.0.10",
-		"@orkestrel/workflow": "^0.0.11",
-		"@orkestrel/workspace": "^0.0.4"
+		"@orkestrel/agent": "^0.0.16",
+		"@orkestrel/contract": "^0.0.12",
+		"@orkestrel/database": "^0.0.10",
+		"@orkestrel/form": "^0.0.2",
+		"@orkestrel/relation": "^0.0.9",
+		"@orkestrel/server": "^0.0.13",
+		"@orkestrel/terminal": "^0.0.10",
+		"@orkestrel/tool": "^0.0.11",
+		"@orkestrel/workflow": "^0.0.13",
+		"@orkestrel/workspace": "^0.0.5"
 	},
 	"devDependencies": {
 		"@microsoft/api-extractor": "^7.58.12",
-		"@orkestrel/guide": "^0.0.10",
-		"@orkestrel/scaffold": "^0.0.30",
+		"@orkestrel/guide": "^0.0.12",
+		"@orkestrel/scaffold": "^0.0.40",
+		"@orkestrel/test": "^0.0.6",
 		"@types/node": "^26.1.2",
 		"@vitest/browser-playwright": "^4.1.10",
 		"oxfmt": "^0.62.0",