@better-agent/core 0.1.0-beta.1

package/dist/server/routes.mjs

@@ -0,0 +1,399 @@
+import { defineRoute } from "../api.mjs";
+import { invalidRequest, jsonErrorResponse, jsonResponse, noContentResponse, parseAfterFromRequest, requestsEventStream, toSseResponse, toValidationIssue } from "./http.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import Ajv from "ajv";
+import { isPlainRecord, safeJsonParse } from "@better-agent/shared/utils";
+
+//#region src/server/routes.ts
+const ajv = new Ajv({
+	allErrors: true,
+	allowUnionTypes: true
+});
+const runSchema = {
+	type: "object",
+	required: ["input"],
+	properties: {
+		input: { oneOf: [
+			{ type: "string" },
+			{ type: "array" },
+			{ type: "object" }
+		] },
+		context: true,
+		output: {
+			type: "object",
+			additionalProperties: true,
+			properties: {
+				schema: { type: "object" },
+				name: { type: "string" },
+				strict: { type: "boolean" }
+			},
+			required: ["schema"]
+		},
+		modalities: {
+			type: "array",
+			minItems: 1,
+			items: { enum: [
+				"text",
+				"image",
+				"video",
+				"audio",
+				"file",
+				"embedding"
+			] }
+		},
+		modelOptions: { type: "object" },
+		conversationId: {
+			type: "string",
+			pattern: "\\S"
+		},
+		conversationReplay: { anyOf: [{
+			type: "object",
+			additionalProperties: false,
+			properties: { omitUnsupportedParts: { type: "boolean" } }
+		}, {
+			type: "object",
+			additionalProperties: false,
+			properties: {
+				omitUnsupportedParts: { type: "boolean" },
+				prepareInput: { type: "null" }
+			}
+		}] },
+		replaceHistory: { type: "boolean" },
+		maxSteps: {
+			type: "integer",
+			minimum: 1
+		},
+		advanced: {
+			type: "object",
+			additionalProperties: false,
+			properties: {
+				clientToolResultTimeoutMs: {
+					type: "number",
+					exclusiveMinimum: 0
+				},
+				toolApprovalTimeoutMs: {
+					type: "number",
+					exclusiveMinimum: 0
+				}
+			}
+		}
+	},
+	additionalProperties: true
+};
+const toolResultSchema = {
+	type: "object",
+	required: [
+		"runId",
+		"toolCallId",
+		"status"
+	],
+	properties: {
+		runId: {
+			type: "string",
+			pattern: "\\S"
+		},
+		toolCallId: {
+			type: "string",
+			pattern: "\\S"
+		},
+		status: { enum: ["success", "error"] },
+		result: true,
+		error: { type: "string" }
+	},
+	additionalProperties: true,
+	allOf: [{
+		if: { properties: { status: { const: "success" } } },
+		then: {
+			required: ["result"],
+			not: { required: ["error"] }
+		}
+	}, {
+		if: { properties: { status: { const: "error" } } },
+		then: {
+			required: ["error"],
+			not: { required: ["result"] }
+		}
+	}]
+};
+const toolApprovalSchema = {
+	type: "object",
+	required: [
+		"runId",
+		"toolCallId",
+		"decision"
+	],
+	properties: {
+		runId: {
+			type: "string",
+			pattern: "\\S"
+		},
+		toolCallId: {
+			type: "string",
+			pattern: "\\S"
+		},
+		decision: { enum: ["approved", "denied"] },
+		note: { type: "string" },
+		actorId: { type: "string" }
+	},
+	additionalProperties: true
+};
+const validateRunRequestBody = ajv.compile(runSchema);
+const validateToolResultBody = ajv.compile(toolResultSchema);
+const validateToolApprovalBody = ajv.compile(toolApprovalSchema);
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+const isStoredStreamEvent = (event) => {
+	if (!isPlainRecord(event)) return false;
+	return typeof event.type === "string" && isFiniteNumber(event.timestamp) && isFiniteNumber(event.seq);
+};
+/**
+* Creates the built-in server route table.
+*/
+const createServerRoutes = (deps) => {
+	const routes = [
+		defineRoute({
+			method: "POST",
+			pattern: "/:name/run",
+			async handler(ctx) {
+				if (!(ctx.request.headers.get("content-type") ?? "").toLowerCase().includes("application/json")) return new Response(JSON.stringify({
+					code: "UNSUPPORTED_MEDIA_TYPE",
+					message: "Content-Type must include application/json.",
+					status: 415
+				}), {
+					status: 415,
+					headers: { "content-type": "application/json" }
+				});
+				const text = await ctx.request.text();
+				if (text.length === 0) return invalidRequest([toValidationIssue("Request body must be valid JSON.")]);
+				const parsed = safeJsonParse(text);
+				if (parsed.isErr() || !isPlainRecord(parsed.value)) return invalidRequest([toValidationIssue("Request body must be a JSON object.")]);
+				if (!validateRunRequestBody(parsed.value)) return invalidRequest(validateRunRequestBody.errors?.map((error) => toValidationIssue(error.message ?? "Request validation failed.", error.instancePath || "/")) ?? []);
+				const runOptions = {
+					input: parsed.value.input,
+					signal: ctx.request.signal,
+					...parsed.value.context !== void 0 ? { context: parsed.value.context } : {},
+					...parsed.value.output !== void 0 ? { output: parsed.value.output } : {},
+					...parsed.value.modalities !== void 0 ? { modalities: parsed.value.modalities } : {},
+					...parsed.value.modelOptions !== void 0 ? { modelOptions: parsed.value.modelOptions } : {},
+					...parsed.value.conversationId !== void 0 ? { conversationId: parsed.value.conversationId } : {},
+					...parsed.value.conversationReplay !== void 0 ? { conversationReplay: parsed.value.conversationReplay } : {},
+					...parsed.value.replaceHistory !== void 0 ? { replaceHistory: parsed.value.replaceHistory } : {},
+					...parsed.value.maxSteps !== void 0 ? { maxSteps: parsed.value.maxSteps } : {},
+					...parsed.value.advanced !== void 0 ? { advanced: parsed.value.advanced } : {}
+				};
+				if (!requestsEventStream(ctx.request)) return jsonResponse(await deps.runtime.run(ctx.params.name, runOptions));
+				const streamed = deps.runtime.stream(ctx.params.name, runOptions);
+				streamed.result.catch(() => {});
+				return toSseResponse({
+					events: streamed.events,
+					runId: streamed.runId,
+					streamId: streamed.runId,
+					signal: ctx.request.signal,
+					heartbeatMs: deps.sseHeartbeatMs,
+					onDisconnect: deps.onRequestDisconnect === "continue" ? void 0 : async () => {
+						await deps.runtime.abortRun(streamed.runId);
+					}
+				});
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			pattern: "/:name/conversations/:id",
+			async handler(ctx) {
+				const rawId = ctx.params.id;
+				const id = typeof rawId === "string" ? (() => {
+					try {
+						return decodeURIComponent(rawId);
+					} catch {
+						return rawId;
+					}
+				})() : rawId;
+				if (!id || id.trim().length === 0) return invalidRequest([toValidationIssue("Conversation id is required.", "/id")]);
+				if (!deps.runtime.loadConversation) return jsonErrorResponse({
+					code: "NOT_IMPLEMENTED",
+					message: "Conversation loading is not implemented by this runtime.",
+					status: 501
+				});
+				const result = await deps.runtime.loadConversation(ctx.params.name, id);
+				if (!result) return noContentResponse();
+				return jsonResponse(result);
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			pattern: "/:name/stream-events/resume",
+			async handler(ctx) {
+				const streamId = ctx.query.get("streamId");
+				if (!streamId) return invalidRequest([toValidationIssue("streamId is required.", "/streamId")]);
+				const events = await deps.runtime.resumeStream({
+					streamId,
+					afterSeq: parseAfterFromRequest(ctx.request)
+				});
+				if (!events) return noContentResponse();
+				return toSseResponse({
+					events: (async function* () {
+						for await (const event of events) {
+							if (!isStoredStreamEvent(event)) throw BetterAgentError.fromCode("VALIDATION_FAILED", "Stored stream event is invalid.", {
+								context: { streamId },
+								trace: [{ at: "core.server.resumeStreamEvents.validateEvent" }]
+							});
+							yield event;
+						}
+					})(),
+					streamId,
+					useEventIds: true,
+					signal: ctx.request.signal,
+					heartbeatMs: deps.sseHeartbeatMs
+				});
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			pattern: "/:name/conversations/:id/resume",
+			async handler(ctx) {
+				const rawId = ctx.params.id;
+				const id = typeof rawId === "string" ? (() => {
+					try {
+						return decodeURIComponent(rawId);
+					} catch {
+						return rawId;
+					}
+				})() : rawId;
+				if (!id || id.trim().length === 0) return invalidRequest([toValidationIssue("Conversation id is required.", "/id")]);
+				const events = await deps.runtime.resumeConversation(ctx.params.name, {
+					conversationId: id,
+					afterSeq: parseAfterFromRequest(ctx.request)
+				});
+				if (!events) return noContentResponse();
+				return toSseResponse({
+					events: (async function* () {
+						for await (const event of events) {
+							if (!isStoredStreamEvent(event)) throw BetterAgentError.fromCode("VALIDATION_FAILED", "Stored stream event is invalid.", {
+								context: { streamId: id },
+								trace: [{ at: "core.server.resumeStreamEvents.validateEvent" }]
+							});
+							yield event;
+						}
+					})(),
+					signal: ctx.request.signal,
+					useEventIds: true,
+					heartbeatMs: deps.sseHeartbeatMs
+				});
+			}
+		}),
+		defineRoute({
+			method: "POST",
+			pattern: "/:name/runs/:runId/abort",
+			async handler(ctx) {
+				const runId = ctx.params.runId;
+				if (!runId || runId.trim().length === 0) return invalidRequest([toValidationIssue("runId is required.", "/runId")]);
+				await deps.runtime.abortRun(runId);
+				return noContentResponse();
+			}
+		}),
+		defineRoute({
+			method: "POST",
+			pattern: "/:name/run/tool-result",
+			async handler(ctx) {
+				if (!(ctx.request.headers.get("content-type") ?? "").toLowerCase().includes("application/json")) return new Response(JSON.stringify({
+					code: "UNSUPPORTED_MEDIA_TYPE",
+					message: "Content-Type must include application/json.",
+					status: 415
+				}), {
+					status: 415,
+					headers: { "content-type": "application/json" }
+				});
+				const text = await ctx.request.text();
+				if (text.length === 0) return invalidRequest([toValidationIssue("Request body must be valid JSON.")]);
+				const parsed = safeJsonParse(text);
+				if (parsed.isErr() || !isPlainRecord(parsed.value)) return invalidRequest([toValidationIssue("Request body must be a JSON object.")]);
+				if (!validateToolResultBody(parsed.value)) return invalidRequest(validateToolResultBody.errors?.map((error) => toValidationIssue(error.message ?? "Request validation failed.", error.instancePath || "/")) ?? []);
+				if (!await deps.runtime.submitToolResult(parsed.value)) return jsonErrorResponse({
+					code: "NOT_FOUND",
+					message: "No pending client tool call found for runId/toolCallId.",
+					status: 404
+				});
+				return noContentResponse();
+			}
+		}),
+		defineRoute({
+			method: "POST",
+			pattern: "/:name/run/tool-approval",
+			async handler(ctx) {
+				if (!(ctx.request.headers.get("content-type") ?? "").toLowerCase().includes("application/json")) return new Response(JSON.stringify({
+					code: "UNSUPPORTED_MEDIA_TYPE",
+					message: "Content-Type must include application/json.",
+					status: 415
+				}), {
+					status: 415,
+					headers: { "content-type": "application/json" }
+				});
+				const text = await ctx.request.text();
+				if (text.length === 0) return invalidRequest([toValidationIssue("Request body must be valid JSON.")]);
+				const parsed = safeJsonParse(text);
+				if (parsed.isErr() || !isPlainRecord(parsed.value)) return invalidRequest([toValidationIssue("Request body must be a JSON object.")]);
+				if (!validateToolApprovalBody(parsed.value)) return invalidRequest(validateToolApprovalBody.errors?.map((error) => toValidationIssue(error.message ?? "Request validation failed.", error.instancePath || "/")) ?? []);
+				if (!await deps.runtime.submitToolApproval(parsed.value)) return jsonErrorResponse({
+					code: "NOT_FOUND",
+					message: "No pending tool approval found for runId/toolCallId.",
+					status: 404
+				});
+				return noContentResponse();
+			}
+		})
+	];
+	const seenRouteKeys = new Set(routes.map((route) => `${route.method} ${route.pattern}`));
+	for (const endpoint of deps.pluginRuntime?.endpoints ?? []) {
+		const routeKey = `${endpoint.method} ${endpoint.path}`;
+		if (seenRouteKeys.has(routeKey)) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Plugin endpoint '${routeKey}' conflicts with an existing server route.`, {
+			context: {
+				pluginId: endpoint.pluginId,
+				method: endpoint.method,
+				path: endpoint.path
+			},
+			trace: [{ at: "core.server.createServer.pluginEndpointConflict" }]
+		});
+		seenRouteKeys.add(routeKey);
+		routes.push(defineRoute({
+			method: endpoint.method,
+			pattern: endpoint.path,
+			...endpoint.public === true ? { public: true } : {},
+			async handler(ctx) {
+				return endpoint.handler({
+					request: ctx.request,
+					params: ctx.params,
+					query: ctx.query
+				});
+			}
+		}));
+	}
+	return routes;
+};
+/**
+* Runs plugin guards for one matched built-in route.
+*/
+const runPluginGuards = async (params) => {
+	const { pluginRuntime, match, request } = params;
+	if (!pluginRuntime?.hasGuards) return null;
+	const guardMode = match.route.pattern === "/:name/conversations/:id" ? "load_conversation" : match.route.pattern === "/:name/stream-events/resume" ? "resume_stream" : match.route.pattern === "/:name/conversations/:id/resume" ? "resume_conversation" : match.route.pattern === "/:name/runs/:runId/abort" ? "abort_run" : match.route.pattern === "/:name/run" ? requestsEventStream(request) ? "stream" : "run" : null;
+	if (!guardMode || typeof match.params.name !== "string") return null;
+	let input = {};
+	const contentType = request.headers.get("content-type") ?? "";
+	if (request.method === "POST" && contentType.toLowerCase().includes("application/json")) {
+		const text = await request.clone().text();
+		if (text.length > 0) {
+			const parsed = safeJsonParse(text);
+			if (!parsed.isErr() && isPlainRecord(parsed.value)) input = parsed.value;
+		}
+	}
+	return pluginRuntime.dispatchRun({
+		mode: guardMode,
+		agentName: match.params.name,
+		input,
+		request,
+		plugins: pluginRuntime.plugins
+	});
+};
+
+//#endregion
+export { createServerRoutes, runPluginGuards };
+//# sourceMappingURL=routes.mjs.map

package/dist/server/routes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.mjs","names":[],"sources":["../../src/server/routes.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { isPlainRecord, safeJsonParse } from \"@better-agent/shared/utils\";\nimport Ajv from \"ajv\";\nimport { type RouteEntry, defineRoute } from \"../api\";\nimport type { StreamEvent } from \"../persistence\";\nimport type { PluginGuardMode, PluginRuntime } from \"../plugins\";\nimport type { Modality } from \"../providers\";\nimport type { BetterAgentRuntime } from \"../run\";\nimport {\n    invalidRequest,\n    jsonErrorResponse,\n    jsonResponse,\n    noContentResponse,\n    parseAfterFromRequest,\n    requestsEventStream,\n    toSseResponse,\n    toValidationIssue,\n} from \"./http\";\nimport type { ToolApprovalBody, ToolResultBody } from \"./types\";\n\ninterface ServerRouteDeps {\n    runtime: BetterAgentRuntime;\n    pluginRuntime: PluginRuntime | null;\n    sseHeartbeatMs?: number;\n    onRequestDisconnect?: \"abort\" | \"continue\";\n}\n\nconst ajv = new Ajv({ allErrors: true, allowUnionTypes: true });\nconst modalities: Modality[] = [\"text\", \"image\", \"video\", \"audio\", \"file\", \"embedding\"];\n\nconst runSchema = {\n    type: \"object\",\n    required: [\"input\"],\n    properties: {\n        input: { oneOf: [{ type: \"string\" }, { type: \"array\" }, { type: \"object\" }] },\n        context: true,\n        output: {\n            type: \"object\",\n            additionalProperties: true,\n            properties: {\n                schema: { type: \"object\" },\n                name: { type: \"string\" },\n                strict: { type: \"boolean\" },\n            },\n            required: [\"schema\"],\n        },\n        modalities: {\n            type: \"array\",\n            minItems: 1,\n            items: { enum: modalities },\n        },\n        modelOptions: { type: \"object\" },\n        conversationId: { type: \"string\", pattern: \"\\\\S\" },\n        conversationReplay: {\n            anyOf: [\n                {\n                    type: \"object\",\n                    additionalProperties: false,\n                    properties: {\n                        omitUnsupportedParts: { type: \"boolean\" },\n                    },\n                },\n                {\n                    type: \"object\",\n                    additionalProperties: false,\n                    properties: {\n                        omitUnsupportedParts: { type: \"boolean\" },\n                        prepareInput: { type: \"null\" },\n                    },\n                },\n            ],\n        },\n        replaceHistory: { type: \"boolean\" },\n        maxSteps: { type: \"integer\", minimum: 1 },\n        advanced: {\n            type: \"object\",\n            additionalProperties: false,\n            properties: {\n                clientToolResultTimeoutMs: { type: \"number\", exclusiveMinimum: 0 },\n                toolApprovalTimeoutMs: { type: \"number\", exclusiveMinimum: 0 },\n            },\n        },\n    },\n    additionalProperties: true,\n} as const;\n\nconst toolResultSchema = {\n    type: \"object\",\n    required: [\"runId\", \"toolCallId\", \"status\"],\n    properties: {\n        runId: { type: \"string\", pattern: \"\\\\S\" },\n        toolCallId: { type: \"string\", pattern: \"\\\\S\" },\n        status: { enum: [\"success\", \"error\"] },\n        result: true,\n        error: { type: \"string\" },\n    },\n    additionalProperties: true,\n    allOf: [\n        {\n            if: { properties: { status: { const: \"success\" } } },\n            // biome-ignore lint/suspicious/noThenProperty: JSON Schema conditional keyword\n            then: {\n                required: [\"result\"],\n                not: { required: [\"error\"] },\n            },\n        },\n        {\n            if: { properties: { status: { const: \"error\" } } },\n            // biome-ignore lint/suspicious/noThenProperty: JSON Schema conditional keyword\n            then: {\n                required: [\"error\"],\n                not: { required: [\"result\"] },\n            },\n        },\n    ],\n} as const;\n\nconst toolApprovalSchema = {\n    type: \"object\",\n    required: [\"runId\", \"toolCallId\", \"decision\"],\n    properties: {\n        runId: { type: \"string\", pattern: \"\\\\S\" },\n        toolCallId: { type: \"string\", pattern: \"\\\\S\" },\n        decision: { enum: [\"approved\", \"denied\"] },\n        note: { type: \"string\" },\n        actorId: { type: \"string\" },\n    },\n    additionalProperties: true,\n} as const;\n\nconst validateRunRequestBody = ajv.compile(runSchema);\nconst validateToolResultBody = ajv.compile(toolResultSchema);\nconst validateToolApprovalBody = ajv.compile(toolApprovalSchema);\n\nconst isFiniteNumber = (value: unknown): value is number =>\n    typeof value === \"number\" && Number.isFinite(value);\n\n// Guard persisted events before re-emitting them as SSE payloads.\nconst isStoredStreamEvent = (event: unknown): event is StreamEvent => {\n    if (!isPlainRecord(event)) {\n        return false;\n    }\n\n    return (\n        typeof event.type === \"string\" &&\n        isFiniteNumber(event.timestamp) &&\n        isFiniteNumber(event.seq)\n    );\n};\n\n/**\n * Creates the built-in server route table.\n */\nexport const createServerRoutes = (deps: ServerRouteDeps): RouteEntry[] => {\n    const routes: RouteEntry[] = [\n        defineRoute({\n            method: \"POST\",\n            pattern: \"/:name/run\",\n            async handler(ctx) {\n                const contentType = ctx.request.headers.get(\"content-type\") ?? \"\";\n                if (!contentType.toLowerCase().includes(\"application/json\")) {\n                    return new Response(\n                        JSON.stringify({\n                            code: \"UNSUPPORTED_MEDIA_TYPE\",\n                            message: \"Content-Type must include application/json.\",\n                            status: 415,\n                        }),\n                        {\n                            status: 415,\n                            headers: { \"content-type\": \"application/json\" },\n                        },\n                    );\n                }\n\n                const text = await ctx.request.text();\n                if (text.length === 0) {\n                    return invalidRequest([toValidationIssue(\"Request body must be valid JSON.\")]);\n                }\n\n                const parsed = safeJsonParse(text);\n                if (parsed.isErr() || !isPlainRecord(parsed.value)) {\n                    return invalidRequest([\n                        toValidationIssue(\"Request body must be a JSON object.\"),\n                    ]);\n                }\n\n                if (!validateRunRequestBody(parsed.value)) {\n                    return invalidRequest(\n                        validateRunRequestBody.errors?.map((error) =>\n                            toValidationIssue(\n                                error.message ?? \"Request validation failed.\",\n                                error.instancePath || \"/\",\n                            ),\n                        ) ?? [],\n                    );\n                }\n\n                const runOptions = {\n                    input: parsed.value.input,\n                    signal: ctx.request.signal,\n                    ...(parsed.value.context !== undefined\n                        ? { context: parsed.value.context }\n                        : {}),\n                    ...(parsed.value.output !== undefined ? { output: parsed.value.output } : {}),\n                    ...(parsed.value.modalities !== undefined\n                        ? { modalities: parsed.value.modalities }\n                        : {}),\n                    ...(parsed.value.modelOptions !== undefined\n                        ? { modelOptions: parsed.value.modelOptions }\n                        : {}),\n                    ...(parsed.value.conversationId !== undefined\n                        ? { conversationId: parsed.value.conversationId }\n                        : {}),\n                    ...(parsed.value.conversationReplay !== undefined\n                        ? { conversationReplay: parsed.value.conversationReplay }\n                        : {}),\n                    ...(parsed.value.replaceHistory !== undefined\n                        ? { replaceHistory: parsed.value.replaceHistory }\n                        : {}),\n                    ...(parsed.value.maxSteps !== undefined\n                        ? { maxSteps: parsed.value.maxSteps }\n                        : {}),\n                    ...(parsed.value.advanced !== undefined\n                        ? { advanced: parsed.value.advanced }\n                        : {}),\n                };\n                if (!requestsEventStream(ctx.request)) {\n                    return jsonResponse(\n                        await deps.runtime.run(ctx.params.name, runOptions as never),\n                    );\n                }\n\n                const streamed = deps.runtime.stream(ctx.params.name, runOptions as never);\n                void streamed.result.catch(() => {});\n                return toSseResponse({\n                    events: streamed.events,\n                    runId: streamed.runId,\n                    streamId: streamed.runId,\n                    signal: ctx.request.signal,\n                    heartbeatMs: deps.sseHeartbeatMs,\n                    onDisconnect:\n                        deps.onRequestDisconnect === \"continue\"\n                            ? undefined\n                            : async () => {\n                                  await deps.runtime.abortRun(streamed.runId);\n                              },\n                });\n            },\n        }),\n        defineRoute({\n            method: \"GET\",\n            pattern: \"/:name/conversations/:id\",\n            async handler(ctx) {\n                const rawId = ctx.params.id;\n                const id =\n                    typeof rawId === \"string\"\n                        ? (() => {\n                              try {\n                                  return decodeURIComponent(rawId);\n                              } catch {\n                                  return rawId;\n                              }\n                          })()\n                        : rawId;\n                if (!id || id.trim().length === 0) {\n                    return invalidRequest([\n                        toValidationIssue(\"Conversation id is required.\", \"/id\"),\n                    ]);\n                }\n                if (!deps.runtime.loadConversation) {\n                    return jsonErrorResponse({\n                        code: \"NOT_IMPLEMENTED\",\n                        message: \"Conversation loading is not implemented by this runtime.\",\n                        status: 501,\n                    });\n                }\n\n                const result = await deps.runtime.loadConversation(ctx.params.name, id);\n                if (!result) {\n                    return noContentResponse();\n                }\n\n                return jsonResponse(result);\n            },\n        }),\n        defineRoute({\n            method: \"GET\",\n            pattern: \"/:name/stream-events/resume\",\n            async handler(ctx) {\n                const streamId = ctx.query.get(\"streamId\");\n                if (!streamId) {\n                    return invalidRequest([\n                        toValidationIssue(\"streamId is required.\", \"/streamId\"),\n                    ]);\n                }\n\n                const events = await deps.runtime.resumeStream({\n                    streamId,\n                    afterSeq: parseAfterFromRequest(ctx.request),\n                });\n                if (!events) {\n                    return noContentResponse();\n                }\n\n                return toSseResponse({\n                    events: (async function* () {\n                        for await (const event of events) {\n                            if (!isStoredStreamEvent(event)) {\n                                throw BetterAgentError.fromCode(\n                                    \"VALIDATION_FAILED\",\n                                    \"Stored stream event is invalid.\",\n                                    {\n                                        context: { streamId },\n                                        trace: [\n                                            {\n                                                at: \"core.server.resumeStreamEvents.validateEvent\",\n                                            },\n                                        ],\n                                    },\n                                );\n                            }\n\n                            yield event as StreamEvent;\n                        }\n                    })(),\n                    streamId,\n                    useEventIds: true,\n                    signal: ctx.request.signal,\n                    heartbeatMs: deps.sseHeartbeatMs,\n                });\n            },\n        }),\n        defineRoute({\n            method: \"GET\",\n            pattern: \"/:name/conversations/:id/resume\",\n            async handler(ctx) {\n                const rawId = ctx.params.id;\n                const id =\n                    typeof rawId === \"string\"\n                        ? (() => {\n                              try {\n                                  return decodeURIComponent(rawId);\n                              } catch {\n                                  return rawId;\n                              }\n                          })()\n                        : rawId;\n                if (!id || id.trim().length === 0) {\n                    return invalidRequest([\n                        toValidationIssue(\"Conversation id is required.\", \"/id\"),\n                    ]);\n                }\n\n                const events = await deps.runtime.resumeConversation(ctx.params.name, {\n                    conversationId: id,\n                    afterSeq: parseAfterFromRequest(ctx.request),\n                });\n                if (!events) {\n                    return noContentResponse();\n                }\n\n                return toSseResponse({\n                    events: (async function* () {\n                        for await (const event of events) {\n                            if (!isStoredStreamEvent(event)) {\n                                throw BetterAgentError.fromCode(\n                                    \"VALIDATION_FAILED\",\n                                    \"Stored stream event is invalid.\",\n                                    {\n                                        context: { streamId: id },\n                                        trace: [\n                                            {\n                                                at: \"core.server.resumeStreamEvents.validateEvent\",\n                                            },\n                                        ],\n                                    },\n                                );\n                            }\n\n                            yield event as StreamEvent;\n                        }\n                    })(),\n                    signal: ctx.request.signal,\n                    useEventIds: true,\n                    heartbeatMs: deps.sseHeartbeatMs,\n                });\n            },\n        }),\n        defineRoute({\n            method: \"POST\",\n            pattern: \"/:name/runs/:runId/abort\",\n            async handler(ctx) {\n                const runId = ctx.params.runId;\n                if (!runId || runId.trim().length === 0) {\n                    return invalidRequest([toValidationIssue(\"runId is required.\", \"/runId\")]);\n                }\n\n                await deps.runtime.abortRun(runId);\n                return noContentResponse();\n            },\n        }),\n        defineRoute({\n            method: \"POST\",\n            pattern: \"/:name/run/tool-result\",\n            async handler(ctx) {\n                const contentType = ctx.request.headers.get(\"content-type\") ?? \"\";\n                if (!contentType.toLowerCase().includes(\"application/json\")) {\n                    return new Response(\n                        JSON.stringify({\n                            code: \"UNSUPPORTED_MEDIA_TYPE\",\n                            message: \"Content-Type must include application/json.\",\n                            status: 415,\n                        }),\n                        {\n                            status: 415,\n                            headers: { \"content-type\": \"application/json\" },\n                        },\n                    );\n                }\n\n                const text = await ctx.request.text();\n                if (text.length === 0) {\n                    return invalidRequest([toValidationIssue(\"Request body must be valid JSON.\")]);\n                }\n\n                const parsed = safeJsonParse(text);\n                if (parsed.isErr() || !isPlainRecord(parsed.value)) {\n                    return invalidRequest([\n                        toValidationIssue(\"Request body must be a JSON object.\"),\n                    ]);\n                }\n\n                if (!validateToolResultBody(parsed.value)) {\n                    return invalidRequest(\n                        validateToolResultBody.errors?.map((error) =>\n                            toValidationIssue(\n                                error.message ?? \"Request validation failed.\",\n                                error.instancePath || \"/\",\n                            ),\n                        ) ?? [],\n                    );\n                }\n\n                const accepted = await deps.runtime.submitToolResult(\n                    parsed.value as ToolResultBody,\n                );\n                if (!accepted) {\n                    return jsonErrorResponse({\n                        code: \"NOT_FOUND\",\n                        message: \"No pending client tool call found for runId/toolCallId.\",\n                        status: 404,\n                    });\n                }\n\n                return noContentResponse();\n            },\n        }),\n        defineRoute({\n            method: \"POST\",\n            pattern: \"/:name/run/tool-approval\",\n            async handler(ctx) {\n                const contentType = ctx.request.headers.get(\"content-type\") ?? \"\";\n                if (!contentType.toLowerCase().includes(\"application/json\")) {\n                    return new Response(\n                        JSON.stringify({\n                            code: \"UNSUPPORTED_MEDIA_TYPE\",\n                            message: \"Content-Type must include application/json.\",\n                            status: 415,\n                        }),\n                        {\n                            status: 415,\n                            headers: { \"content-type\": \"application/json\" },\n                        },\n                    );\n                }\n\n                const text = await ctx.request.text();\n                if (text.length === 0) {\n                    return invalidRequest([toValidationIssue(\"Request body must be valid JSON.\")]);\n                }\n\n                const parsed = safeJsonParse(text);\n                if (parsed.isErr() || !isPlainRecord(parsed.value)) {\n                    return invalidRequest([\n                        toValidationIssue(\"Request body must be a JSON object.\"),\n                    ]);\n                }\n\n                if (!validateToolApprovalBody(parsed.value)) {\n                    return invalidRequest(\n                        validateToolApprovalBody.errors?.map((error) =>\n                            toValidationIssue(\n                                error.message ?? \"Request validation failed.\",\n                                error.instancePath || \"/\",\n                            ),\n                        ) ?? [],\n                    );\n                }\n\n                const accepted = await deps.runtime.submitToolApproval(\n                    parsed.value as ToolApprovalBody,\n                );\n                if (!accepted) {\n                    return jsonErrorResponse({\n                        code: \"NOT_FOUND\",\n                        message: \"No pending tool approval found for runId/toolCallId.\",\n                        status: 404,\n                    });\n                }\n\n                return noContentResponse();\n            },\n        }),\n    ];\n\n    const seenRouteKeys = new Set(routes.map((route) => `${route.method} ${route.pattern}`));\n\n    for (const endpoint of deps.pluginRuntime?.endpoints ?? []) {\n        const routeKey = `${endpoint.method} ${endpoint.path}`;\n        if (seenRouteKeys.has(routeKey)) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Plugin endpoint '${routeKey}' conflicts with an existing server route.`,\n                {\n                    context: {\n                        pluginId: endpoint.pluginId,\n                        method: endpoint.method,\n                        path: endpoint.path,\n                    },\n                    trace: [{ at: \"core.server.createServer.pluginEndpointConflict\" }],\n                },\n            );\n        }\n\n        seenRouteKeys.add(routeKey);\n        routes.push(\n            defineRoute({\n                method: endpoint.method,\n                pattern: endpoint.path,\n                ...(endpoint.public === true ? { public: true } : {}),\n                async handler(ctx) {\n                    return endpoint.handler({\n                        request: ctx.request,\n                        params: ctx.params,\n                        query: ctx.query,\n                    });\n                },\n            }),\n        );\n    }\n\n    return routes;\n};\n\n/**\n * Runs plugin guards for one matched built-in route.\n */\nexport const runPluginGuards = async (params: {\n    pluginRuntime: PluginRuntime | null;\n    match: { route: RouteEntry; params: Record<string, string> };\n    request: Request;\n}): Promise<Response | null> => {\n    const { pluginRuntime, match, request } = params;\n    if (!pluginRuntime?.hasGuards) {\n        return null;\n    }\n\n    const guardMode: PluginGuardMode | null =\n        match.route.pattern === \"/:name/conversations/:id\"\n            ? \"load_conversation\"\n            : match.route.pattern === \"/:name/stream-events/resume\"\n              ? \"resume_stream\"\n              : match.route.pattern === \"/:name/conversations/:id/resume\"\n                ? \"resume_conversation\"\n                : match.route.pattern === \"/:name/runs/:runId/abort\"\n                  ? \"abort_run\"\n                  : match.route.pattern === \"/:name/run\"\n                    ? requestsEventStream(request)\n                        ? \"stream\"\n                        : \"run\"\n                    : null;\n\n    if (!guardMode || typeof match.params.name !== \"string\") {\n        return null;\n    }\n\n    let input: Record<string, unknown> = {};\n    const contentType = request.headers.get(\"content-type\") ?? \"\";\n    const shouldParseJsonBody =\n        request.method === \"POST\" && contentType.toLowerCase().includes(\"application/json\");\n\n    if (shouldParseJsonBody) {\n        const text = await request.clone().text();\n        if (text.length > 0) {\n            const parsed = safeJsonParse(text);\n            if (!parsed.isErr() && isPlainRecord(parsed.value)) {\n                input = parsed.value;\n            }\n        }\n    }\n\n    return pluginRuntime.dispatchRun({\n        mode: guardMode,\n        agentName: match.params.name,\n        input,\n        request,\n        plugins: pluginRuntime.plugins,\n    });\n};\n"],"mappings":"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"}

package/dist/server/types.d.mts

@@ -0,0 +1,31 @@
+import { PluginRuntime } from "../plugins/types.mjs";
+import { BetterAgentRuntime } from "../run/types.mjs";
+//#region src/server/types.d.ts
+/**
+ * Server configuration.
+ */
+interface CreateServerConfig {
+  /** Runtime used to execute agent operations. */
+  runtime: BetterAgentRuntime;
+  /** Optional plugin runtime used for guards and plugin routes. */
+  pluginRuntime?: PluginRuntime | null;
+  /** Optional bearer token required for non-public routes. */
+  secret?: string;
+  /** Base path for all routes, for example `"/api"`. */
+  basePath?: string;
+  /** Advanced server controls. */
+  advanced?: {
+    /** Heartbeat interval for SSE responses. */sseHeartbeatMs?: number; /** How streaming runs react when the client disconnects. */
+    onRequestDisconnect?: "abort" | "continue";
+  };
+}
+/**
+ * Built-in server instance.
+ */
+interface BetterAgentServer {
+  /** Handles one incoming HTTP request. */
+  handle(request: Request): Promise<Response>;
+}
+//#endregion
+export { BetterAgentServer, CreateServerConfig };
+//# sourceMappingURL=types.d.mts.map

package/dist/server/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/server/types.ts"],"mappings":";;;;;;UAaiB,kBAAA;EAAA;EAEb,OAAA,EAAS,kBAAA;;EAET,aAAA,GAAgB,aAAA;EAFhB;EAIA,MAAA;EAFA;EAIA,QAAA;EAFA;EAIA,QAAA;IAAA,4CAEI,cAAA,WAEA;IAAA,mBAAA;EAAA;AAAA;;;;UAOS,iBAAA;EAEa;EAA1B,MAAA,CAAO,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,QAAA;AAAA"}

package/dist/tools/constants.d.mts

@@ -0,0 +1,12 @@
+//#region src/tools/constants.d.ts
+/**
+ * Symbol used to attach an optional per-run cleanup hook to a tool.
+ */
+declare const TOOL_CLEANUP: unique symbol;
+/**
+ * Symbol used to store the resolved JSON Schema for a tool.
+ */
+declare const TOOL_JSON_SCHEMA: unique symbol;
+//#endregion
+export { TOOL_CLEANUP, TOOL_JSON_SCHEMA };
+//# sourceMappingURL=constants.d.mts.map

package/dist/tools/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","names":[],"sources":["../../src/tools/constants.ts"],"mappings":";;AAGA;;cAAa,YAAA;;;AAKb;cAAa,gBAAA"}

package/dist/tools/constants.mjs

@@ -0,0 +1,13 @@
+//#region src/tools/constants.ts
+/**
+* Symbol used to attach an optional per-run cleanup hook to a tool.
+*/
+const TOOL_CLEANUP = Symbol.for("better-agent.tool.cleanup");
+/**
+* Symbol used to store the resolved JSON Schema for a tool.
+*/
+const TOOL_JSON_SCHEMA = Symbol.for("better-agent.tool.json_schema");
+
+//#endregion
+export { TOOL_CLEANUP, TOOL_JSON_SCHEMA };
+//# sourceMappingURL=constants.mjs.map

package/dist/tools/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../src/tools/constants.ts"],"sourcesContent":["/**\n * Symbol used to attach an optional per-run cleanup hook to a tool.\n */\nexport const TOOL_CLEANUP = Symbol.for(\"better-agent.tool.cleanup\");\n\n/**\n * Symbol used to store the resolved JSON Schema for a tool.\n */\nexport const TOOL_JSON_SCHEMA = Symbol.for(\"better-agent.tool.json_schema\");\n"],"mappings":";;;;AAGA,MAAa,eAAe,OAAO,IAAI,4BAA4B;;;;AAKnE,MAAa,mBAAmB,OAAO,IAAI,gCAAgC"}

package/dist/tools/define-tool.d.mts

@@ -0,0 +1,25 @@
+import { ResolvableSchema } from "../schema/types.mjs";
+import { ToolContract, ToolContractConfig } from "./types.mjs";
+
+//#region src/tools/define-tool.d.ts
+/**
+ * Defines a tool contract.
+ *
+ * Call `.server(...)` for server execution or `.client()` for client-handled tools.
+ *
+ * @param def Tool definition.
+ * @returns A tool contract.
+ *
+ * @example
+ * ```ts
+ * const getWeather = defineTool({
+ *   name: "get_weather",
+ *   description: "Get current weather",
+ *   schema: { type: "object", properties: { city: { type: "string" } } },
+ * }).server(async ({ city }) => ({ city, temperature: 26 }));
+ * ```
+ */
+declare const defineTool: <const N extends string, const S extends ResolvableSchema, TContext = any>(def: ToolContractConfig<S, N, TContext>) => ToolContract<S, N, TContext>;
+//#endregion
+export { defineTool };
+//# sourceMappingURL=define-tool.d.mts.map

package/dist/tools/define-tool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.mts","names":[],"sources":["../../src/tools/define-tool.ts"],"mappings":";;;;;;;AAsBA;;;;;;;;;;;;;;cAAa,UAAA,2CAEO,gBAAA,kBAER,GAAA,EAEH,kBAAA,CAAmB,CAAA,EAAG,CAAA,EAAG,QAAA,MAC/B,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,QAAA"}

package/dist/tools/define-tool.mjs

@@ -0,0 +1,76 @@
+import { TOOL_CLEANUP, TOOL_JSON_SCHEMA } from "./constants.mjs";
+import { validateToolDefinition } from "./validation.mjs";
+
+//#region src/tools/define-tool.ts
+/**
+* Defines a tool contract.
+*
+* Call `.server(...)` for server execution or `.client()` for client-handled tools.
+*
+* @param def Tool definition.
+* @returns A tool contract.
+*
+* @example
+* ```ts
+* const getWeather = defineTool({
+*   name: "get_weather",
+*   description: "Get current weather",
+*   schema: { type: "object", properties: { city: { type: "string" } } },
+* }).server(async ({ city }) => ({ city, temperature: 26 }));
+* ```
+*/
+const defineTool = (def) => {
+	const resolvedSchema = validateToolDefinition(def);
+	const name = def.name;
+	const description = def.description;
+	const schema = def.schema;
+	const strict = def.strict;
+	const approval = def.approval;
+	const toolErrorMode = def.toolErrorMode;
+	const onToolError = def.onToolError;
+	const cleanup = def[TOOL_CLEANUP];
+	return {
+		name,
+		description,
+		schema,
+		[TOOL_JSON_SCHEMA]: resolvedSchema,
+		server: ((handler, options) => {
+			return {
+				name: options?.as ?? name,
+				kind: "server",
+				description,
+				schema,
+				strict,
+				approval,
+				toolErrorMode,
+				onToolError,
+				handler,
+				[TOOL_CLEANUP]: cleanup,
+				[TOOL_JSON_SCHEMA]: resolvedSchema
+			};
+		}),
+		client: ((options) => {
+			return {
+				name: options?.as ?? name,
+				kind: "client",
+				description,
+				schema,
+				strict,
+				approval,
+				toolErrorMode,
+				onToolError,
+				[TOOL_CLEANUP]: cleanup,
+				[TOOL_JSON_SCHEMA]: resolvedSchema
+			};
+		}),
+		strict,
+		approval,
+		toolErrorMode,
+		onToolError,
+		[TOOL_CLEANUP]: cleanup
+	};
+};
+
+//#endregion
+export { defineTool };
+//# sourceMappingURL=define-tool.mjs.map

package/dist/tools/define-tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.mjs","names":[],"sources":["../../src/tools/define-tool.ts"],"sourcesContent":["import type { ResolvableSchema } from \"../schema\";\nimport { TOOL_CLEANUP, TOOL_JSON_SCHEMA } from \"./constants\";\nimport type { ToolContract, ToolContractConfig } from \"./types\";\nimport { validateToolDefinition } from \"./validation\";\n\n/**\n * Defines a tool contract.\n *\n * Call `.server(...)` for server execution or `.client()` for client-handled tools.\n *\n * @param def Tool definition.\n * @returns A tool contract.\n *\n * @example\n * ```ts\n * const getWeather = defineTool({\n *   name: \"get_weather\",\n *   description: \"Get current weather\",\n *   schema: { type: \"object\", properties: { city: { type: \"string\" } } },\n * }).server(async ({ city }) => ({ city, temperature: 26 }));\n * ```\n */\nexport const defineTool = <\n    const N extends string,\n    const S extends ResolvableSchema,\n    // biome-ignore lint/suspicious/noExplicitAny: reusable tools default to loose run context unless explicitly narrowed\n    TContext = any,\n>(\n    def: ToolContractConfig<S, N, TContext>,\n): ToolContract<S, N, TContext> => {\n    // Resolve once at definition time so server/client variants share the same schema payload.\n    const resolvedSchema = validateToolDefinition(def);\n    const name = def.name;\n    const description = def.description;\n    const schema = def.schema;\n    const strict = def.strict;\n    const approval = def.approval;\n    const toolErrorMode = def.toolErrorMode;\n    const onToolError = def.onToolError;\n    const cleanup = def[TOOL_CLEANUP];\n\n    return {\n        name,\n        description,\n        schema,\n        [TOOL_JSON_SCHEMA]: resolvedSchema,\n        server: ((handler, options) => {\n            const toolName = options?.as ?? name;\n            return {\n                name: toolName,\n                kind: \"server\" as const,\n                description,\n                schema,\n                strict,\n                approval,\n                toolErrorMode,\n                onToolError,\n                handler,\n                [TOOL_CLEANUP]: cleanup,\n                [TOOL_JSON_SCHEMA]: resolvedSchema,\n            };\n        }) as ToolContract<S, N, TContext>[\"server\"],\n        client: ((options) => {\n            const toolName = options?.as ?? name;\n            return {\n                name: toolName,\n                kind: \"client\" as const,\n                description,\n                schema,\n                strict,\n                approval,\n                toolErrorMode,\n                onToolError,\n                [TOOL_CLEANUP]: cleanup,\n                [TOOL_JSON_SCHEMA]: resolvedSchema,\n            };\n        }) as ToolContract<S, N, TContext>[\"client\"],\n        strict,\n        approval,\n        toolErrorMode,\n        onToolError,\n        [TOOL_CLEANUP]: cleanup,\n    };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,cAMT,QAC+B;CAE/B,MAAM,iBAAiB,uBAAuB,IAAI;CAClD,MAAM,OAAO,IAAI;CACjB,MAAM,cAAc,IAAI;CACxB,MAAM,SAAS,IAAI;CACnB,MAAM,SAAS,IAAI;CACnB,MAAM,WAAW,IAAI;CACrB,MAAM,gBAAgB,IAAI;CAC1B,MAAM,cAAc,IAAI;CACxB,MAAM,UAAU,IAAI;AAEpB,QAAO;EACH;EACA;EACA;GACC,mBAAmB;EACpB,UAAU,SAAS,YAAY;AAE3B,UAAO;IACH,MAFa,SAAS,MAAM;IAG5B,MAAM;IACN;IACA;IACA;IACA;IACA;IACA;IACA;KACC,eAAe;KACf,mBAAmB;IACvB;;EAEL,UAAU,YAAY;AAElB,UAAO;IACH,MAFa,SAAS,MAAM;IAG5B,MAAM;IACN;IACA;IACA;IACA;IACA;IACA;KACC,eAAe;KACf,mBAAmB;IACvB;;EAEL;EACA;EACA;EACA;GACC,eAAe;EACnB"}