@better-agent/core 0.1.0-beta.1

package/dist/schema/resolve-json-schema.mjs

@@ -0,0 +1,167 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { err, ok } from "@better-agent/shared/neverthrow";
+import Ajv from "ajv";
+import Ajv2020 from "ajv/dist/2020.js";
+
+//#region src/schema/resolve-json-schema.ts
+const ajvDraft7 = new Ajv({
+	allErrors: true,
+	logger: false
+});
+const ajvDraft2020 = new Ajv2020({
+	allErrors: true,
+	logger: false
+});
+const compiledJsonSchemaCache = /* @__PURE__ */ new WeakMap();
+const resolvedStandardJsonSchemaCache = /* @__PURE__ */ new WeakMap();
+const createSchemaError = (params) => params.cause ? BetterAgentError.wrap({
+	err: params.cause,
+	message: params.message,
+	opts: {
+		code: "VALIDATION_FAILED",
+		context: {
+			...params.context ?? {},
+			...params.issues !== void 0 ? { issues: params.issues } : {}
+		},
+		trace: [{ at: params.traceAt }]
+	}
+}) : BetterAgentError.fromCode("VALIDATION_FAILED", params.message, {
+	context: {
+		...params.context ?? {},
+		...params.issues !== void 0 ? { issues: params.issues } : {}
+	},
+	trace: [{ at: params.traceAt }]
+});
+const compileJsonSchema = (schema, traceAt) => {
+	const cachedValidator = compiledJsonSchemaCache.get(schema);
+	if (cachedValidator) return ok(cachedValidator);
+	const schemaId = schema.$schema;
+	const targets = [];
+	if (typeof schemaId === "string") if (schemaId.includes("draft-07")) targets.push("draft-07");
+	else if (schemaId.includes("draft/2020-12")) targets.push("draft-2020-12");
+	else return err(createSchemaError({
+		message: "Tool schema uses an unsupported json_schema dialect.",
+		traceAt,
+		context: {
+			schemaType: "json_schema",
+			schemaDialect: schemaId
+		}
+	}));
+	else targets.push("draft-07", "draft-2020-12");
+	const attempts = [];
+	for (const target of targets) try {
+		const validator = target === "draft-2020-12" ? ajvDraft2020.compile(schema) : ajvDraft7.compile(schema);
+		compiledJsonSchemaCache.set(schema, validator);
+		return ok(validator);
+	} catch (cause) {
+		attempts.push({
+			target,
+			error: cause instanceof Error ? cause.message : String(cause)
+		});
+	}
+	return err(createSchemaError({
+		message: "Tool schema is not valid json_schema.",
+		traceAt,
+		context: {
+			schemaType: "json_schema",
+			attempts
+		}
+	}));
+};
+const getStandardRecord = (schema) => {
+	const standard = schema?.["~standard"];
+	return standard && typeof standard === "object" ? standard : void 0;
+};
+const hasStandardValidate = (schema) => typeof getStandardRecord(schema)?.validate === "function";
+const hasStandardJsonSchema = (schema) => {
+	const jsonSchema = getStandardRecord(schema)?.jsonSchema;
+	return !!jsonSchema && typeof jsonSchema === "object" && typeof jsonSchema.input === "function";
+};
+const resolveToJsonSchema = (schema) => {
+	const traceAt = "core.schema.resolveToJsonSchema";
+	const standard = getStandardRecord(schema);
+	if (hasStandardJsonSchema(schema)) {
+		const cachedSchema = resolvedStandardJsonSchemaCache.get(schema);
+		if (cachedSchema) return ok(cachedSchema);
+		const attempts = [];
+		for (const target of ["draft-07", "draft-2020-12"]) try {
+			const resolvedSchema = schema["~standard"].jsonSchema.input({ target });
+			resolvedStandardJsonSchemaCache.set(schema, resolvedSchema);
+			return ok(resolvedSchema);
+		} catch (cause) {
+			attempts.push({
+				target,
+				error: cause instanceof Error ? cause.message : String(cause)
+			});
+		}
+		return err(createSchemaError({
+			message: "Tool schema could not be resolved to json_schema.",
+			traceAt,
+			context: {
+				schemaType: "standard_schema",
+				standardVendor: schema["~standard"].vendor,
+				attempts
+			}
+		}));
+	}
+	if (standard !== void 0) return err(createSchemaError({
+		message: "Tool schema must be raw json_schema or a Standard JSON Schema with `~standard.jsonSchema.input()`.",
+		traceAt,
+		context: {
+			schemaType: "standard_schema",
+			standardVendor: typeof standard.vendor === "string" ? standard.vendor : void 0,
+			supportsJsonSchema: false
+		}
+	}));
+	if (!schema || typeof schema !== "object" || Array.isArray(schema)) return err(createSchemaError({
+		message: "Tool schema must be raw json_schema or a Standard JSON Schema with `~standard.jsonSchema.input()`.",
+		traceAt,
+		context: { schemaType: "json_schema" }
+	}));
+	const jsonSchema = schema;
+	const compiled = compileJsonSchema(jsonSchema, traceAt);
+	if (compiled.isErr()) return err(compiled.error);
+	return ok(jsonSchema);
+};
+const validateInput = async (schema, data, options) => {
+	const invalidMessage = options?.invalidMessage ?? "The provided data is invalid according to schema.";
+	if (hasStandardValidate(schema)) try {
+		const result = await schema["~standard"].validate(data);
+		if (result.issues && result.issues.length > 0) return err(createSchemaError({
+			message: invalidMessage,
+			traceAt: "core.schema.validateInput",
+			context: { issuesCount: result.issues.length },
+			issues: result.issues
+		}));
+		return ok("value" in result ? result.value : data);
+	} catch (cause) {
+		return err(createSchemaError({
+			message: "Schema validation failed.",
+			traceAt: "core.schema.validateInput",
+			cause
+		}));
+	}
+	const resolved = resolveToJsonSchema(schema);
+	if (resolved.isErr()) return err(resolved.error);
+	const compiled = compileJsonSchema(resolved.value, "core.schema.validateInput");
+	if (compiled.isErr()) return err(compiled.error);
+	try {
+		if (!compiled.value(data)) return err(createSchemaError({
+			message: invalidMessage,
+			traceAt: "core.schema.validateInput",
+			context: { issuesCount: compiled.value.errors?.length ?? 0 },
+			issues: compiled.value.errors ?? []
+		}));
+		return ok(data);
+	} catch (cause) {
+		return err(createSchemaError({
+			message: "Schema validation failed.",
+			traceAt: "core.schema.validateInput",
+			cause
+		}));
+	}
+};
+
+//#endregion
+export { resolveToJsonSchema, validateInput };
+//# sourceMappingURL=resolve-json-schema.mjs.map

package/dist/schema/resolve-json-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-json-schema.mjs","names":[],"sources":["../../src/schema/resolve-json-schema.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { type Result, err, ok } from \"@better-agent/shared/neverthrow\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport Ajv from \"ajv\";\nimport type { ValidateFunction } from \"ajv\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport type { ResolvableSchema, ValidatableSchema } from \"./types\";\n\ntype JsonSchemaTarget = \"draft-07\" | \"draft-2020-12\";\n\nconst ajvDraft7 = new Ajv({\n    allErrors: true,\n    logger: false,\n});\n\nconst ajvDraft2020 = new Ajv2020({\n    allErrors: true,\n    logger: false,\n});\n\nconst compiledJsonSchemaCache = new WeakMap<Record<string, unknown>, ValidateFunction>();\nconst resolvedStandardJsonSchemaCache = new WeakMap<object, Record<string, unknown>>();\n\nconst createSchemaError = (params: {\n    message: string;\n    traceAt: string;\n    context?: Record<string, unknown>;\n    issues?: readonly unknown[] | null;\n    cause?: unknown;\n}): BetterAgentError =>\n    params.cause\n        ? BetterAgentError.wrap({\n              err: params.cause,\n              message: params.message,\n              opts: {\n                  code: \"VALIDATION_FAILED\",\n                  context: {\n                      ...(params.context ?? {}),\n                      ...(params.issues !== undefined ? { issues: params.issues } : {}),\n                  },\n                  trace: [{ at: params.traceAt }],\n              },\n          })\n        : BetterAgentError.fromCode(\"VALIDATION_FAILED\", params.message, {\n              context: {\n                  ...(params.context ?? {}),\n                  ...(params.issues !== undefined ? { issues: params.issues } : {}),\n              },\n              trace: [{ at: params.traceAt }],\n          });\n\nconst compileJsonSchema = (\n    schema: Record<string, unknown>,\n    traceAt: string,\n): Result<ValidateFunction, BetterAgentError> => {\n    const cachedValidator = compiledJsonSchemaCache.get(schema);\n    if (cachedValidator) {\n        return ok(cachedValidator);\n    }\n\n    const schemaId = schema.$schema;\n    const targets: JsonSchemaTarget[] = [];\n\n    if (typeof schemaId === \"string\") {\n        if (schemaId.includes(\"draft-07\")) {\n            targets.push(\"draft-07\");\n        } else if (schemaId.includes(\"draft/2020-12\")) {\n            targets.push(\"draft-2020-12\");\n        } else {\n            return err(\n                createSchemaError({\n                    message: \"Tool schema uses an unsupported json_schema dialect.\",\n                    traceAt,\n                    context: {\n                        schemaType: \"json_schema\",\n                        schemaDialect: schemaId,\n                    },\n                }),\n            );\n        }\n    } else {\n        targets.push(\"draft-07\", \"draft-2020-12\");\n    }\n\n    const attempts: Array<Record<string, unknown>> = [];\n\n    for (const target of targets) {\n        try {\n            const validator =\n                target === \"draft-2020-12\"\n                    ? ajvDraft2020.compile(schema)\n                    : ajvDraft7.compile(schema);\n            compiledJsonSchemaCache.set(schema, validator);\n            return ok(validator);\n        } catch (cause) {\n            attempts.push({\n                target,\n                error: cause instanceof Error ? cause.message : String(cause),\n            });\n        }\n    }\n\n    return err(\n        createSchemaError({\n            message: \"Tool schema is not valid json_schema.\",\n            traceAt,\n            context: {\n                schemaType: \"json_schema\",\n                attempts,\n            },\n        }),\n    );\n};\n\nconst getStandardRecord = (schema: unknown): Record<string, unknown> | undefined => {\n    const standard = (schema as { \"~standard\"?: unknown })?.[\"~standard\"];\n    return standard && typeof standard === \"object\"\n        ? (standard as Record<string, unknown>)\n        : undefined;\n};\n\nconst hasStandardValidate = (schema: unknown): schema is StandardSchemaV1 =>\n    typeof getStandardRecord(schema)?.validate === \"function\";\n\nconst hasStandardJsonSchema = (\n    schema: unknown,\n): schema is {\n    \"~standard\": {\n        vendor?: string;\n        jsonSchema: {\n            input: (options: { target: JsonSchemaTarget }) => Record<string, unknown>;\n        };\n    };\n} => {\n    const jsonSchema = getStandardRecord(schema)?.jsonSchema;\n    return (\n        !!jsonSchema &&\n        typeof jsonSchema === \"object\" &&\n        typeof (jsonSchema as { input?: unknown }).input === \"function\"\n    );\n};\n\nexport const resolveToJsonSchema = (\n    schema: ResolvableSchema,\n): Result<Record<string, unknown>, BetterAgentError> => {\n    const traceAt = \"core.schema.resolveToJsonSchema\";\n    const standard = getStandardRecord(schema);\n\n    if (hasStandardJsonSchema(schema)) {\n        const cachedSchema = resolvedStandardJsonSchemaCache.get(schema);\n        if (cachedSchema) {\n            return ok(cachedSchema);\n        }\n\n        const attempts: Array<Record<string, unknown>> = [];\n\n        for (const target of [\"draft-07\", \"draft-2020-12\"] as const) {\n            try {\n                const resolvedSchema = schema[\"~standard\"].jsonSchema.input({ target });\n                resolvedStandardJsonSchemaCache.set(schema, resolvedSchema);\n                return ok(resolvedSchema);\n            } catch (cause) {\n                attempts.push({\n                    target,\n                    error: cause instanceof Error ? cause.message : String(cause),\n                });\n            }\n        }\n\n        return err(\n            createSchemaError({\n                message: \"Tool schema could not be resolved to json_schema.\",\n                traceAt,\n                context: {\n                    schemaType: \"standard_schema\",\n                    standardVendor: schema[\"~standard\"].vendor,\n                    attempts,\n                },\n            }),\n        );\n    }\n\n    if (standard !== undefined) {\n        return err(\n            createSchemaError({\n                message:\n                    \"Tool schema must be raw json_schema or a Standard JSON Schema with `~standard.jsonSchema.input()`.\",\n                traceAt,\n                context: {\n                    schemaType: \"standard_schema\",\n                    standardVendor:\n                        typeof standard.vendor === \"string\" ? standard.vendor : undefined,\n                    supportsJsonSchema: false,\n                },\n            }),\n        );\n    }\n\n    if (!schema || typeof schema !== \"object\" || Array.isArray(schema)) {\n        return err(\n            createSchemaError({\n                message:\n                    \"Tool schema must be raw json_schema or a Standard JSON Schema with `~standard.jsonSchema.input()`.\",\n                traceAt,\n                context: {\n                    schemaType: \"json_schema\",\n                },\n            }),\n        );\n    }\n\n    const jsonSchema = schema as Record<string, unknown>;\n    const compiled = compileJsonSchema(jsonSchema, traceAt);\n    if (compiled.isErr()) {\n        return err(compiled.error);\n    }\n\n    return ok(jsonSchema);\n};\n\nexport const validateInput = async <T>(\n    schema: ValidatableSchema,\n    data: unknown,\n    options?: {\n        invalidMessage?: string;\n    },\n): Promise<Result<T, BetterAgentError>> => {\n    const invalidMessage =\n        options?.invalidMessage ?? \"The provided data is invalid according to schema.\";\n\n    if (hasStandardValidate(schema)) {\n        try {\n            const result = await schema[\"~standard\"].validate(data);\n\n            if (result.issues && result.issues.length > 0) {\n                return err(\n                    createSchemaError({\n                        message: invalidMessage,\n                        traceAt: \"core.schema.validateInput\",\n                        context: {\n                            issuesCount: result.issues.length,\n                        },\n                        issues: result.issues,\n                    }),\n                );\n            }\n\n            return ok((\"value\" in result ? result.value : data) as T);\n        } catch (cause) {\n            return err(\n                createSchemaError({\n                    message: \"Schema validation failed.\",\n                    traceAt: \"core.schema.validateInput\",\n                    cause,\n                }),\n            );\n        }\n    }\n\n    const resolved = resolveToJsonSchema(schema);\n    if (resolved.isErr()) {\n        return err(resolved.error);\n    }\n\n    const compiled = compileJsonSchema(resolved.value, \"core.schema.validateInput\");\n    if (compiled.isErr()) {\n        return err(compiled.error);\n    }\n\n    try {\n        const valid = compiled.value(data);\n        if (!valid) {\n            return err(\n                createSchemaError({\n                    message: invalidMessage,\n                    traceAt: \"core.schema.validateInput\",\n                    context: {\n                        issuesCount: compiled.value.errors?.length ?? 0,\n                    },\n                    issues: compiled.value.errors ?? [],\n                }),\n            );\n        }\n\n        return ok(data as T);\n    } catch (cause) {\n        return err(\n            createSchemaError({\n                message: \"Schema validation failed.\",\n                traceAt: \"core.schema.validateInput\",\n                cause,\n            }),\n        );\n    }\n};\n"],"mappings":"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"}

package/dist/schema/types.d.mts

@@ -0,0 +1,27 @@
+import { StandardJSONSchemaV1, StandardSchemaV1, StandardTypedV1 } from "@standard-schema/spec";
+import { FromSchema } from "json-schema-to-ts";
+
+//#region src/schema/types.d.ts
+/** Any Standard Schema v1 instance. */
+type AnyStandardSchemaV1 = StandardSchemaV1<any, any>;
+/** Standard Schema v1 typed schema. */
+type StandardSchema<I = unknown, O = I> = StandardTypedV1<I, O>;
+/** Schema inputs that can be resolved to JSON Schema. */
+type ResolvableSchema<I = unknown, O = I> = StandardJSONSchemaV1<I, O> | Record<string, unknown>;
+/** Schema inputs that can be validated at runtime. */
+type ValidatableSchema<I = unknown, O = I> = StandardSchemaV1<I, O> | ResolvableSchema<I, O>;
+/** Infers the input type from a Standard Schema v1 typed schema. */
+type InferStandardInput<TSchema> = TSchema extends {
+  "~standard"?: {
+    types?: {
+      input?: infer I;
+    };
+  };
+} ? I : never;
+/**
+ * Infers the input type from either a Standard Schema v1 typed schema or a JSON Schema object.
+ */
+type InferSchemaInput<TSchema> = [InferStandardInput<TSchema>] extends [never] ? TSchema extends Record<string, unknown> ? FromSchema<TSchema> : unknown : InferStandardInput<TSchema>;
+//#endregion
+export { AnyStandardSchemaV1, InferSchemaInput, InferStandardInput, ResolvableSchema, StandardSchema, ValidatableSchema };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/schema/types.ts"],"mappings":";;;;;KASY,mBAAA,GAAsB,gBAAA;AAAlC;AAAA,KAGY,cAAA,kBAAgC,CAAA,IAAK,eAAA,CAAgB,CAAA,EAAG,CAAA;;KAGxD,gBAAA,kBAAkC,CAAA,IACxC,oBAAA,CAAqB,CAAA,EAAG,CAAA,IACxB,MAAA;;KAGM,iBAAA,kBAAmC,CAAA,IAAK,gBAAA,CAAiB,CAAA,EAAG,CAAA,IAAK,gBAAA,CAAiB,CAAA,EAAG,CAAA;;KAGrF,kBAAA,YAA8B,OAAA;EACtC,WAAA;IAAgB,KAAA;MAAU,KAAA;IAAA;EAAA;AAAA,IAExB,CAAA;;;;KAMM,gBAAA,aAA6B,kBAAA,CAAmB,OAAA,qBACtD,OAAA,SAAgB,MAAA,oBACZ,UAAA,CAAW,OAAA,cAEf,kBAAA,CAAmB,OAAA"}

package/dist/server/create-server.d.mts

@@ -0,0 +1,21 @@
+import { BetterAgentServer, CreateServerConfig } from "./types.mjs";
+
+//#region src/server/create-server.d.ts
+/**
+ * Creates a built-in HTTP server.
+ *
+ * When `secret` is set, non-public routes require `Authorization: Bearer <secret>`.
+ *
+ * @example
+ * ```ts
+ * const server = createServer({
+ *   runtime,
+ *   secret: "dev-secret",
+ *   basePath: "/api",
+ * });
+ * ```
+ */
+declare function createServer(config: CreateServerConfig): BetterAgentServer;
+//#endregion
+export { createServer };
+//# sourceMappingURL=create-server.d.mts.map

package/dist/server/create-server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.mts","names":[],"sources":["../../src/server/create-server.ts"],"mappings":";;;;;AAwBA;;;;;;;;;;;;iBAAgB,YAAA,CAAa,MAAA,EAAQ,kBAAA,GAAqB,iBAAA"}

package/dist/server/create-server.mjs

@@ -0,0 +1,107 @@
+import { createRouter } from "../api.mjs";
+import { jsonErrorResponse, methodNotAllowedResponse, notFoundResponse, toServerErrorResponse } from "./http.mjs";
+import { createServerRoutes, runPluginGuards } from "./routes.mjs";
+
+//#region src/server/create-server.ts
+/**
+* Creates a built-in HTTP server.
+*
+* When `secret` is set, non-public routes require `Authorization: Bearer <secret>`.
+*
+* @example
+* ```ts
+* const server = createServer({
+*   runtime,
+*   secret: "dev-secret",
+*   basePath: "/api",
+* });
+* ```
+*/
+function createServer(config) {
+	const sseHeartbeatMs = config.advanced?.sseHeartbeatMs;
+	const onRequestDisconnect = config.advanced?.onRequestDisconnect ?? (config.runtime.streamLifecycle === "detached" ? "continue" : "abort");
+	const basePath = typeof config.basePath === "string" && config.basePath.length > 0 ? config.basePath.replace(/\/$/, "") : "";
+	const deps = {
+		runtime: config.runtime,
+		pluginRuntime: config.pluginRuntime ?? null,
+		sseHeartbeatMs,
+		onRequestDisconnect
+	};
+	const router = createRouter(createServerRoutes(deps));
+	const getHeader = (headers, name) => {
+		if (!headers || typeof headers !== "object") return null;
+		if ("get" in headers && typeof headers.get === "function") {
+			const value = headers.get(name);
+			return typeof value === "string" ? value : null;
+		}
+		const record = headers;
+		const direct = record[name] ?? record[name.toLowerCase()] ?? record[name.toUpperCase()];
+		return typeof direct === "string" ? direct : null;
+	};
+	const toAbsoluteUrlString = (request) => {
+		try {
+			return new URL(request.url).toString();
+		} catch {
+			const host = getHeader(request.headers, "x-forwarded-host") ?? getHeader(request.headers, "host") ?? "localhost";
+			const protocol = getHeader(request.headers, "x-forwarded-proto") === "https" ? "https" : "http";
+			return new URL(request.url, `${protocol}://${host}`).toString();
+		}
+	};
+	const normalizeRequest = (request) => {
+		const hasHeadersGet = typeof request.headers?.get === "function";
+		const hasAbsoluteUrl = (() => {
+			try {
+				new URL(request.url);
+				return true;
+			} catch {
+				return false;
+			}
+		})();
+		if (request instanceof Request && hasHeadersGet && hasAbsoluteUrl) return request;
+		return new Request(toAbsoluteUrlString(request), {
+			method: request.method,
+			headers: request.headers,
+			body: request.method === "GET" || request.method === "HEAD" ? void 0 : request.body,
+			...request.method !== "GET" && request.method !== "HEAD" && request.body != null ? { duplex: "half" } : {},
+			signal: request.signal
+		});
+	};
+	return { async handle(request) {
+		try {
+			const normalizedRequest = normalizeRequest(request);
+			const url = new URL(normalizedRequest.url);
+			const path = !basePath || !url.pathname.startsWith(basePath) ? url.pathname : url.pathname.length > basePath.length && url.pathname[basePath.length] !== "/" ? url.pathname : url.pathname.slice(basePath.length) || "/";
+			const match = router.match(normalizedRequest.method, path);
+			if (!match) {
+				const pathMatch = router.matchPath(path);
+				if (pathMatch) return methodNotAllowedResponse(pathMatch.methods);
+				return notFoundResponse();
+			}
+			if (config.secret && match.route.public !== true) {
+				if (normalizedRequest.headers.get("authorization") !== `Bearer ${config.secret}`) return jsonErrorResponse({
+					code: "UNAUTHORIZED",
+					message: "Missing or invalid bearer token.",
+					status: 401
+				}, { headers: { "www-authenticate": "Bearer" } });
+			}
+			const guardResult = await runPluginGuards({
+				pluginRuntime: deps.pluginRuntime,
+				match,
+				request: normalizedRequest
+			});
+			if (guardResult) return guardResult;
+			return await match.route.handler({
+				request: normalizedRequest,
+				path,
+				params: match.params,
+				query: url.searchParams
+			});
+		} catch (error) {
+			return toServerErrorResponse(error);
+		}
+	} };
+}
+
+//#endregion
+export { createServer };
+//# sourceMappingURL=create-server.mjs.map

package/dist/server/create-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.mjs","names":[],"sources":["../../src/server/create-server.ts"],"sourcesContent":["import { type HttpMethod, createRouter } from \"../api\";\nimport {\n    jsonErrorResponse,\n    methodNotAllowedResponse,\n    notFoundResponse,\n    toServerErrorResponse,\n} from \"./http\";\nimport { createServerRoutes, runPluginGuards } from \"./routes\";\nimport type { BetterAgentServer, CreateServerConfig } from \"./types\";\n\n/**\n * Creates a built-in HTTP server.\n *\n * When `secret` is set, non-public routes require `Authorization: Bearer <secret>`.\n *\n * @example\n * ```ts\n * const server = createServer({\n *   runtime,\n *   secret: \"dev-secret\",\n *   basePath: \"/api\",\n * });\n * ```\n */\nexport function createServer(config: CreateServerConfig): BetterAgentServer {\n    const sseHeartbeatMs = config.advanced?.sseHeartbeatMs;\n    const onRequestDisconnect =\n        config.advanced?.onRequestDisconnect ??\n        (config.runtime.streamLifecycle === \"detached\" ? \"continue\" : \"abort\");\n    const basePath =\n        typeof config.basePath === \"string\" && config.basePath.length > 0\n            ? config.basePath.replace(/\\/$/, \"\")\n            : \"\";\n\n    const deps = {\n        runtime: config.runtime,\n        pluginRuntime: config.pluginRuntime ?? null,\n        sseHeartbeatMs,\n        onRequestDisconnect,\n    };\n    const routes = createServerRoutes(deps);\n    const router = createRouter(routes);\n\n    // Normalize incoming request-like inputs (objects or path-only URLs) into a standard Fetch Request so downstream handling can rely on consistent Request semantics.\n    const getHeader = (headers: unknown, name: string): string | null => {\n        if (!headers || typeof headers !== \"object\") {\n            return null;\n        }\n\n        if (\"get\" in headers && typeof headers.get === \"function\") {\n            const value = headers.get(name);\n            return typeof value === \"string\" ? value : null;\n        }\n\n        const record = headers as Record<string, unknown>;\n        const direct = record[name] ?? record[name.toLowerCase()] ?? record[name.toUpperCase()];\n        return typeof direct === \"string\" ? direct : null;\n    };\n\n    const toAbsoluteUrlString = (request: Request): string => {\n        try {\n            return new URL(request.url).toString();\n        } catch {\n            // Recover relative URLs by reconstructing an origin from forwarded or host headers.\n            const host =\n                getHeader(request.headers, \"x-forwarded-host\") ??\n                getHeader(request.headers, \"host\") ??\n                \"localhost\";\n            const protocol =\n                getHeader(request.headers, \"x-forwarded-proto\") === \"https\" ? \"https\" : \"http\";\n            return new URL(request.url, `${protocol}://${host}`).toString();\n        }\n    };\n\n    const normalizeRequest = (request: Request): Request => {\n        const hasHeadersGet = typeof request.headers?.get === \"function\";\n        const hasAbsoluteUrl = (() => {\n            try {\n                void new URL(request.url);\n                return true;\n            } catch {\n                return false;\n            }\n        })();\n\n        if (request instanceof Request && hasHeadersGet && hasAbsoluteUrl) {\n            return request;\n        }\n\n        return new Request(toAbsoluteUrlString(request), {\n            method: request.method,\n            headers: request.headers as HeadersInit | undefined,\n            body:\n                request.method === \"GET\" || request.method === \"HEAD\"\n                    ? undefined\n                    : (request as { body?: BodyInit | null }).body,\n            ...((request.method !== \"GET\" &&\n            request.method !== \"HEAD\" &&\n            (request as { body?: BodyInit | null }).body != null\n                ? { duplex: \"half\" }\n                : {}) as { duplex?: \"half\" }),\n            signal: request.signal,\n        });\n    };\n\n    return {\n        async handle(request) {\n            try {\n                const normalizedRequest = normalizeRequest(request);\n                const url = new URL(normalizedRequest.url);\n                // Normalize pathname by removing basePath only if it’s a true path-segment prefix (not partial like \"/app\" vs \"/apple\")\n                const path =\n                    !basePath || !url.pathname.startsWith(basePath)\n                        ? url.pathname\n                        : url.pathname.length > basePath.length &&\n                            url.pathname[basePath.length] !== \"/\"\n                          ? url.pathname\n                          : url.pathname.slice(basePath.length) || \"/\";\n\n                const match = router.match(normalizedRequest.method as HttpMethod, path);\n                if (!match) {\n                    const pathMatch = router.matchPath(path);\n                    if (pathMatch) {\n                        return methodNotAllowedResponse(pathMatch.methods);\n                    }\n\n                    return notFoundResponse();\n                }\n\n                // Built-in bearer auth is skipped only for routes explicitly marked public.\n                if (config.secret && match.route.public !== true) {\n                    if (\n                        normalizedRequest.headers.get(\"authorization\") !== `Bearer ${config.secret}`\n                    ) {\n                        return jsonErrorResponse(\n                            {\n                                code: \"UNAUTHORIZED\",\n                                message: \"Missing or invalid bearer token.\",\n                                status: 401,\n                            },\n                            {\n                                headers: {\n                                    \"www-authenticate\": \"Bearer\",\n                                },\n                            },\n                        );\n                    }\n                }\n\n                const guardResult = await runPluginGuards({\n                    pluginRuntime: deps.pluginRuntime,\n                    match,\n                    request: normalizedRequest,\n                });\n                if (guardResult) {\n                    return guardResult;\n                }\n\n                return await match.route.handler({\n                    request: normalizedRequest,\n                    path,\n                    params: match.params,\n                    query: url.searchParams,\n                });\n            } catch (error) {\n                return toServerErrorResponse(error);\n            }\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/server/http.mjs

@@ -0,0 +1,182 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { isPlainRecord } from "@better-agent/shared/utils";
+
+//#region src/server/http.ts
+/**
+* Creates a JSON response.
+*/
+const jsonResponse = (body, init) => new Response(JSON.stringify(body), {
+	...init,
+	headers: {
+		"content-type": "application/json",
+		...init?.headers ?? {}
+	}
+});
+/**
+* Creates a `204 No Content` response.
+*/
+const noContentResponse = () => new Response(null, { status: 204 });
+/**
+* Creates a `404 Not Found` response.
+*/
+const notFoundResponse = (message = "Route not found.") => jsonErrorResponse({
+	code: "NOT_FOUND",
+	message,
+	status: 404
+});
+/**
+* Creates a `405 Method Not Allowed` response.
+*/
+const methodNotAllowedResponse = (methods) => jsonErrorResponse({
+	code: "METHOD_NOT_ALLOWED",
+	message: "Request method is not allowed for this route.",
+	status: 405
+}, { headers: { allow: methods.join(", ") } });
+/**
+* Creates one validation issue.
+*/
+const toValidationIssue = (message, path = "/") => ({
+	message,
+	path
+});
+/**
+* Creates a `422 Validation Failed` response.
+*/
+const invalidRequest = (issues) => jsonErrorResponse({
+	code: "VALIDATION_FAILED",
+	message: "Request validation failed.",
+	status: 422,
+	issues
+});
+/**
+* Creates a JSON error response.
+*/
+const jsonErrorResponse = (params, init) => jsonResponse({
+	code: params.code,
+	message: params.message,
+	status: params.status,
+	...params.retryable !== void 0 ? { retryable: params.retryable } : {},
+	...params.issues !== void 0 ? { issues: params.issues } : {},
+	...params.traceId !== void 0 ? { traceId: params.traceId } : {},
+	...params.context !== void 0 ? { context: params.context } : {},
+	...params.trace !== void 0 ? { trace: params.trace } : {}
+}, {
+	...init,
+	status: params.status,
+	headers: { ...init?.headers ?? {} }
+});
+/**
+* Checks whether the request asked for `text/event-stream`.
+*/
+const requestsEventStream = (request) => (request.headers.get("accept") ?? "").includes("text/event-stream");
+/**
+* Creates an SSE response from an async iterable.
+*/
+const toSseResponse = (params) => {
+	const encoder = new TextEncoder();
+	let disconnectHandled = false;
+	const handleDisconnect = () => {
+		if (disconnectHandled) return;
+		disconnectHandled = true;
+		params.onDisconnect?.();
+	};
+	const stream = new ReadableStream({
+		async start(controller) {
+			const heartbeatMs = params.heartbeatMs ?? 15e3;
+			const heartbeat = setInterval(() => {
+				try {
+					controller.enqueue(encoder.encode(":\n\n"));
+				} catch {
+					clearInterval(heartbeat);
+				}
+			}, heartbeatMs);
+			const onAbort = () => {
+				clearInterval(heartbeat);
+				handleDisconnect();
+				try {
+					controller.close();
+				} catch {}
+			};
+			if (params.signal?.aborted) {
+				onAbort();
+				return;
+			}
+			params.signal?.addEventListener("abort", onAbort, { once: true });
+			try {
+				for await (const event of params.events) {
+					if (params.signal?.aborted) break;
+					const payload = params.useEventIds && isPlainRecord(event) && typeof event.seq === "number" && Number.isFinite(event.seq) ? `id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n` : `data: ${JSON.stringify(event)}\n\n`;
+					controller.enqueue(encoder.encode(payload));
+				}
+			} catch (error) {
+				const payload = JSON.stringify({
+					type: "error",
+					message: error instanceof Error ? error.message : "Stream failed"
+				});
+				controller.enqueue(encoder.encode(`event: error\ndata: ${payload}\n\n`));
+			} finally {
+				clearInterval(heartbeat);
+				params.signal?.removeEventListener("abort", onAbort);
+				try {
+					controller.close();
+				} catch {}
+			}
+		},
+		cancel() {
+			handleDisconnect();
+		}
+	});
+	return new Response(stream, { headers: {
+		"content-type": "text/event-stream",
+		"cache-control": "no-cache",
+		...params.streamId !== void 0 ? { "x-stream-id": params.streamId } : {},
+		...params.runId !== void 0 ? { "x-run-id": params.runId } : {}
+	} });
+};
+/**
+* Parses `Last-Event-ID` into an `afterSeq` value.
+*/
+const parseAfterFromRequest = (request) => {
+	const lastEventId = request.headers.get("last-event-id");
+	if (!lastEventId) return;
+	const after = Number(lastEventId);
+	return Number.isFinite(after) ? after : void 0;
+};
+const normalizeValidationIssues = (issues, fallbackMessage) => {
+	if (!Array.isArray(issues)) return [toValidationIssue(fallbackMessage)];
+	return issues.map((issue) => isPlainRecord(issue) && typeof issue.message === "string" ? {
+		message: issue.message,
+		path: typeof issue.path === "string" ? issue.path : typeof issue.instancePath === "string" ? issue.instancePath || "/" : "/"
+	} : toValidationIssue(fallbackMessage));
+};
+/**
+* Converts an unknown server error into a public HTTP response.
+*/
+const toServerErrorResponse = (error) => {
+	const wrapped = error instanceof BetterAgentError ? error : BetterAgentError.wrap({
+		err: error,
+		message: "Server request failed",
+		opts: {
+			code: "INTERNAL",
+			trace: [{ at: "core.server.handle" }]
+		}
+	});
+	const safeMessage = wrapped.code === "INTERNAL" ? "Server request failed." : wrapped.message;
+	const issues = wrapped.code === "VALIDATION_FAILED" ? normalizeValidationIssues(wrapped.context?.issues, wrapped.message) : void 0;
+	const safeContext = wrapped.code === "INTERNAL" ? void 0 : wrapped.context;
+	const safeTrace = wrapped.code === "INTERNAL" ? void 0 : wrapped.trace;
+	return jsonErrorResponse({
+		code: String(wrapped.code ?? "INTERNAL"),
+		message: safeMessage,
+		status: wrapped.status,
+		retryable: wrapped.retryable,
+		issues,
+		traceId: wrapped.traceId,
+		context: safeContext,
+		trace: safeTrace
+	});
+};
+
+//#endregion
+export { invalidRequest, jsonErrorResponse, jsonResponse, methodNotAllowedResponse, noContentResponse, notFoundResponse, parseAfterFromRequest, requestsEventStream, toServerErrorResponse, toSseResponse, toValidationIssue };
+//# sourceMappingURL=http.mjs.map

package/dist/server/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../../src/server/http.ts"],"sourcesContent":["import { BetterAgentError, type BetterAgentErrorTraceFrame } from \"@better-agent/shared/errors\";\nimport { isPlainRecord } from \"@better-agent/shared/utils\";\n\n/**\n * Validation issue returned in HTTP error payloads.\n */\nexport interface ValidationIssue {\n    message: string;\n    path?: string;\n}\n\n/**\n * Creates a JSON response.\n */\nexport const jsonResponse = (body: unknown, init?: ResponseInit): Response =>\n    new Response(JSON.stringify(body), {\n        ...init,\n        headers: {\n            \"content-type\": \"application/json\",\n            ...(init?.headers ?? {}),\n        },\n    });\n\n/**\n * Creates a `204 No Content` response.\n */\nexport const noContentResponse = (): Response => new Response(null, { status: 204 });\n\n/**\n * Creates a `404 Not Found` response.\n */\nexport const notFoundResponse = (message = \"Route not found.\"): Response =>\n    jsonErrorResponse({ code: \"NOT_FOUND\", message, status: 404 });\n\n/**\n * Creates a `405 Method Not Allowed` response.\n */\nexport const methodNotAllowedResponse = (methods: string[]): Response =>\n    jsonErrorResponse(\n        {\n            code: \"METHOD_NOT_ALLOWED\",\n            message: \"Request method is not allowed for this route.\",\n            status: 405,\n        },\n        {\n            headers: {\n                allow: methods.join(\", \"),\n            },\n        },\n    );\n\n/**\n * Creates one validation issue.\n */\nexport const toValidationIssue = (message: string, path = \"/\"): ValidationIssue => ({\n    message,\n    path,\n});\n\n/**\n * Creates a `422 Validation Failed` response.\n */\nexport const invalidRequest = (issues: ValidationIssue[]): Response =>\n    jsonErrorResponse({\n        code: \"VALIDATION_FAILED\",\n        message: \"Request validation failed.\",\n        status: 422,\n        issues,\n    });\n\n/**\n * Creates a JSON error response.\n */\nexport const jsonErrorResponse = (\n    params: {\n        code: string;\n        message: string;\n        status: number;\n        retryable?: boolean;\n        issues?: ValidationIssue[];\n        traceId?: string;\n        context?: Record<string, unknown>;\n        trace?: BetterAgentErrorTraceFrame[];\n    },\n    init?: ResponseInit,\n): Response =>\n    jsonResponse(\n        {\n            code: params.code,\n            message: params.message,\n            status: params.status,\n            ...(params.retryable !== undefined ? { retryable: params.retryable } : {}),\n            ...(params.issues !== undefined ? { issues: params.issues } : {}),\n            ...(params.traceId !== undefined ? { traceId: params.traceId } : {}),\n            ...(params.context !== undefined ? { context: params.context } : {}),\n            ...(params.trace !== undefined ? { trace: params.trace } : {}),\n        },\n        {\n            ...init,\n            status: params.status,\n            headers: {\n                ...(init?.headers ?? {}),\n            },\n        },\n    );\n\n/**\n * Checks whether the request asked for `text/event-stream`.\n */\nexport const requestsEventStream = (request: Request): boolean =>\n    (request.headers.get(\"accept\") ?? \"\").includes(\"text/event-stream\");\n\n/**\n * Creates an SSE response from an async iterable.\n */\nexport const toSseResponse = (params: {\n    events: AsyncIterable<unknown>;\n    streamId?: string;\n    runId?: string;\n    useEventIds?: boolean;\n    signal?: AbortSignal;\n    heartbeatMs?: number;\n    onDisconnect?: () => void | Promise<void>;\n}): Response => {\n    const encoder = new TextEncoder();\n    let disconnectHandled = false;\n    const handleDisconnect = () => {\n        if (disconnectHandled) return;\n        disconnectHandled = true;\n        void params.onDisconnect?.();\n    };\n    const stream = new ReadableStream({\n        async start(controller) {\n            const heartbeatMs = params.heartbeatMs ?? 15000;\n            const heartbeat = setInterval(() => {\n                try {\n                    controller.enqueue(encoder.encode(\":\\n\\n\"));\n                } catch {\n                    clearInterval(heartbeat);\n                }\n            }, heartbeatMs);\n            const onAbort = () => {\n                clearInterval(heartbeat);\n                handleDisconnect();\n                try {\n                    controller.close();\n                } catch {}\n            };\n\n            if (params.signal?.aborted) {\n                onAbort();\n                return;\n            }\n\n            params.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n            try {\n                for await (const event of params.events) {\n                    if (params.signal?.aborted) {\n                        break;\n                    }\n\n                    const payload =\n                        params.useEventIds &&\n                        isPlainRecord(event) &&\n                        typeof event.seq === \"number\" &&\n                        Number.isFinite(event.seq)\n                            ? `id: ${event.seq}\\ndata: ${JSON.stringify(event)}\\n\\n`\n                            : `data: ${JSON.stringify(event)}\\n\\n`;\n                    controller.enqueue(encoder.encode(payload));\n                }\n            } catch (error) {\n                const payload = JSON.stringify({\n                    type: \"error\",\n                    message: error instanceof Error ? error.message : \"Stream failed\",\n                });\n                controller.enqueue(encoder.encode(`event: error\\ndata: ${payload}\\n\\n`));\n            } finally {\n                clearInterval(heartbeat);\n                params.signal?.removeEventListener(\"abort\", onAbort);\n                try {\n                    controller.close();\n                } catch {}\n            }\n        },\n        cancel() {\n            handleDisconnect();\n        },\n    });\n\n    return new Response(stream, {\n        headers: {\n            \"content-type\": \"text/event-stream\",\n            \"cache-control\": \"no-cache\",\n            ...(params.streamId !== undefined ? { \"x-stream-id\": params.streamId } : {}),\n            ...(params.runId !== undefined ? { \"x-run-id\": params.runId } : {}),\n        },\n    });\n};\n\n/**\n * Parses `Last-Event-ID` into an `afterSeq` value.\n */\nexport const parseAfterFromRequest = (request: Request): number | undefined => {\n    const lastEventId = request.headers.get(\"last-event-id\");\n    if (!lastEventId) {\n        return undefined;\n    }\n\n    const after = Number(lastEventId);\n    return Number.isFinite(after) ? after : undefined;\n};\n\nconst normalizeValidationIssues = (issues: unknown, fallbackMessage: string): ValidationIssue[] => {\n    if (!Array.isArray(issues)) {\n        return [toValidationIssue(fallbackMessage)];\n    }\n\n    return issues.map((issue) =>\n        isPlainRecord(issue) && typeof issue.message === \"string\"\n            ? {\n                  message: issue.message,\n                  path:\n                      typeof issue.path === \"string\"\n                          ? issue.path\n                          : typeof issue.instancePath === \"string\"\n                            ? issue.instancePath || \"/\"\n                            : \"/\",\n              }\n            : toValidationIssue(fallbackMessage),\n    );\n};\n\n/**\n * Converts an unknown server error into a public HTTP response.\n */\nexport const toServerErrorResponse = (error: unknown): Response => {\n    const wrapped =\n        error instanceof BetterAgentError\n            ? error\n            : BetterAgentError.wrap({\n                  err: error,\n                  message: \"Server request failed\",\n                  opts: {\n                      code: \"INTERNAL\",\n                      trace: [{ at: \"core.server.handle\" }],\n                  },\n              });\n\n    const safeMessage = wrapped.code === \"INTERNAL\" ? \"Server request failed.\" : wrapped.message;\n    const issues =\n        wrapped.code === \"VALIDATION_FAILED\"\n            ? normalizeValidationIssues(wrapped.context?.issues, wrapped.message)\n            : undefined;\n    const safeContext = wrapped.code === \"INTERNAL\" ? undefined : wrapped.context;\n    const safeTrace = wrapped.code === \"INTERNAL\" ? undefined : wrapped.trace;\n\n    return jsonErrorResponse({\n        code: String(wrapped.code ?? \"INTERNAL\"),\n        message: safeMessage,\n        status: wrapped.status,\n        retryable: wrapped.retryable,\n        issues,\n        traceId: wrapped.traceId,\n        context: safeContext,\n        trace: safeTrace,\n    });\n};\n"],"mappings":"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"}

package/dist/server/index.d.mts

@@ -0,0 +1,3 @@
+import { BetterAgentServer, CreateServerConfig } from "./types.mjs";
+import { createServer } from "./create-server.mjs";
+export { type BetterAgentServer, type CreateServerConfig, createServer };

package/dist/server/index.mjs

@@ -0,0 +1,3 @@
+import { createServer } from "./create-server.mjs";
+
+export { createServer };