mirror of
https://github.com/morluto/rea.git
synced 2026-11-06 14:56:32 +00:00
gensokyo-devandAkshad Jogi
9085222ca1
Add opt-in bounded output-schema advertisements while preserving the full default, canonical server validation and complete structured content. Verify real stdio discovery under a 1 MiB receive cap, all 5,367 libcrypto export coordinates, complete Evidence parity, whole-task serialization estimates and resource bounds. Fixes #2512. Integrates #7054 by Akshad Jogi with original authorship retained. Co-authored-by: Akshad Jogi <akshadjogi@gmail.com>
55 lines
2.3 KiB
TypeScript
55 lines
2.3 KiB
TypeScript
import { z } from "zod";
|
|
|
|
import { ConfigurationError } from "../domain/configurationErrors.js";
|
|
import { err, ok, type Result } from "../domain/result.js";
|
|
|
|
/**
|
|
* Per-schema budget for compact output advertisements. Output contracts are
|
|
* larger than input contracts across the catalog, and the complete frame is
|
|
* what a frame-capped host rejects. Measured on the complete contract catalog
|
|
* with the default compact input profile, 4 KiB bounds the output
|
|
* advertisement to ~276 KiB and the complete `tools/list` response to
|
|
* ~577 KiB, leaving margin under the one-megabyte frame reported in #2512. A
|
|
* larger budget admits substantially more full contracts; a much smaller one
|
|
* drops first-level property guidance for nearly every tool.
|
|
*/
|
|
export const COMPACT_OUTPUT_SCHEMA_BUDGET_BYTES = 4 * 1024;
|
|
|
|
/** Select whether tools/list carries the large output contracts. */
|
|
export const mcpOutputSchemaProfileSchema = z.enum(["full", "compact", "off"]);
|
|
|
|
export type McpOutputSchemaProfile = z.infer<
|
|
typeof mcpOutputSchemaProfileSchema
|
|
>;
|
|
|
|
/** Resolve the compact output advertisement, preserving every other choice. */
|
|
export const compactPresentationForMcpOutputSchemaProfile = (
|
|
profile: McpOutputSchemaProfile | undefined,
|
|
): { readonly budgetBytes: number } | undefined =>
|
|
profile === "compact"
|
|
? { budgetBytes: COMPACT_OUTPUT_SCHEMA_BUDGET_BYTES }
|
|
: undefined;
|
|
|
|
const profileConstraint =
|
|
'REA_MCP_OUTPUT_SCHEMA_PROFILE must be "full" (default), "compact", or "off". The compact profile advertises every output schema within a 4,096-byte budget; the off profile omits output schemas. Both keep canonical server-side validation and complete structured content.';
|
|
|
|
/** Parse the output schema advertisement selection at server composition. */
|
|
export const parseMcpOutputSchemaProfile = (
|
|
value: string | undefined,
|
|
): Result<McpOutputSchemaProfile | undefined, ConfigurationError> => {
|
|
if (value === undefined) return ok(undefined);
|
|
const parsed = mcpOutputSchemaProfileSchema.safeParse(value);
|
|
return parsed.success
|
|
? ok(parsed.data)
|
|
: err(
|
|
new ConfigurationError(profileConstraint, {
|
|
settings: [
|
|
{
|
|
setting: "REA_MCP_OUTPUT_SCHEMA_PROFILE",
|
|
constraint: profileConstraint,
|
|
},
|
|
],
|
|
}),
|
|
);
|
|
};
|