pi-roundtable-sandbox 0.7.4 → 0.7.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.7.5
+
+- `ScopedSandboxDelegator` limits a title to 200 characters by default again, and accepts `maxTitleChars`, `maxReportChars` and `diagnosticChars`.
+
 ## 0.7.4
 
 - Let `SandboxResearchWorker` run the host's own web tools (`tools`, `scope`, `aborted`), and make `ScopedSandboxDelegator` refuse and fail with readable reasons (scrubbed) instead of generic text, with no title limit.

package/README.md

@@ -316,6 +316,7 @@ Its default limit is two jobs per channel, 4,000 task characters, 80,000 report
 A refusal reads "title and task are required", "the task is N characters; keep it within 4000" or "this channel already has N delegated tasks running; wait for one to report back".
 A failed job reports its error message scrubbed of credentials and bounded with `scrubDiagnostic`, or "the worker ran out of time" after the deadline.
 Configure `maxRunning` (1–10) and `timeoutMs` (1–1,200 seconds) explicitly when preserving an application's existing limits.
+A title is limited to 200 characters; `maxTitleChars` changes that, `maxReportChars` replaces the 80,000-character report bound and `diagnosticChars` the 600-character failure reason (each a whole number of at least 1, or `Infinity`).
 `run(task, context)` receives only bound channel/author/signal, and `deliver(job, result)` posts through the application's background-report adapter.
 `runningChannels`, `idle` and `dispose` support host lifecycle handling; jobs are process-local and are cancelled on disposal.
 `SandboxResearchWorker` is an optional host subscription adapter with explicit `modelRuntime`, `agentDir`, `workDir`, `model`, `thinking`, `search`, and `extractFetched` options.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-sandbox",
-	"version": "0.7.4",
+	"version": "0.7.5",
 	"description": "Sealed guest channels and an allow-listed credential broker for pi-roundtable",
 	"type": "module",
 	"license": "MIT",
@@ -52,7 +52,7 @@
 		"@biomejs/biome": "2.5.15",
 		"@types/bun": "1.4.2",
 		"discord.js": "14.27.0",
-		"pi-roundtable": "0.7.4",
+		"pi-roundtable": "0.7.5",
 		"typebox": "1.3.34",
 		"typescript": "7.0.2"
 	}

package/src/scoped-delegator.ts

@@ -8,11 +8,18 @@ import { DelegationError } from "pi-roundtable";
 import { scrubDiagnostic } from "pi-roundtable/kit";
 
 const MAX_TASK_CHARS = 4_000;
+const MAX_TITLE_CHARS = 200;
 
 export interface ScopedDelegatorOptions {
 	target: string;
 	maxRunning?: number;
 	timeoutMs?: number;
+	/** Longest title, in characters; default 200. A host whose callers already send longer ones raises it. */
+	maxTitleChars?: number;
+	/** Longest research report, in characters, or `Infinity`; default 80,000. */
+	maxReportChars?: number;
+	/** Longest failure reason kept, in characters, or `Infinity`; default 600. */
+	diagnosticChars?: number;
 	run(
 		task: string,
 		context: {
@@ -44,6 +51,24 @@ export class ScopedSandboxDelegator {
 			(options.timeoutMs ?? 600_000) > 1_200_000
 		)
 			throw new Error("Invalid delegation target/budget");
+		if (
+			options.maxTitleChars !== undefined &&
+			!Number.isSafeInteger(options.maxTitleChars) &&
+			options.maxTitleChars !== Number.POSITIVE_INFINITY
+		)
+			throw new Error("Invalid delegation title limit");
+		if (options.maxTitleChars !== undefined && options.maxTitleChars < 1)
+			throw new Error("Invalid delegation title limit");
+		for (const [name, value] of [
+			["maxReportChars", options.maxReportChars],
+			["diagnosticChars", options.diagnosticChars],
+		] as const)
+			if (
+				value !== undefined &&
+				value !== Number.POSITIVE_INFINITY &&
+				(!Number.isSafeInteger(value) || value < 1)
+			)
+				throw new Error(`Invalid delegation ${name}`);
 		this.#options = options;
 	}
 	start(
@@ -59,6 +84,11 @@ export class ScopedSandboxDelegator {
 		const task = request.task.trim();
 		if (!request.title.trim() || !task)
 			throw new DelegationError("title and task are required");
+		const maxTitle = this.#options.maxTitleChars ?? MAX_TITLE_CHARS;
+		if (request.title.length > maxTitle)
+			throw new DelegationError(
+				`the title is ${request.title.length} characters; keep it within ${maxTitle}`,
+			);
 		if (task.length > MAX_TASK_CHARS)
 			throw new DelegationError(
 				`the task is ${task.length} characters; keep it within ${MAX_TASK_CHARS}`,
@@ -93,7 +123,10 @@ export class ScopedSandboxDelegator {
 					signal,
 				});
 				signal.throwIfAborted();
-				if (typeof report !== "string" || report.length > 80_000)
+				if (
+					typeof report !== "string" ||
+					report.length > (this.#options.maxReportChars ?? 80_000)
+				)
 					throw new Error("Research report too large");
 				result = { ok: true, report };
 			} catch (error) {
@@ -102,6 +135,7 @@ export class ScopedSandboxDelegator {
 					? "the worker ran out of time"
 					: scrubDiagnostic(
 							error instanceof Error ? error.message : String(error),
+							this.#options.diagnosticChars,
 						);
 				result = { ok: false, error: reason || "the task failed" };
 			}