@relkit/runtime-hono 0.0.0

package/dist/internal-endpoints.d.ts

@@ -0,0 +1,58 @@
+import * as contracts from "@relkit/contracts";
+import type { RegistrationPlan } from "@relkit/graph";
+import type { Hono } from "hono";
+export declare const INTERNAL_ENDPOINT_PROTOCOL: "relkit.inspector";
+export declare const INTERNAL_ENDPOINT_VERSION: 1;
+export declare const INTERNAL_ENDPOINT_PATHS: readonly ["/_relkit/v1/health/live", "/_relkit/v1/health/ready", "/_relkit/v1/graph", "/_relkit/v1/requests", "/_relkit/v1/logs", "/_relkit/v1/traces", "/_relkit/v1/stream", "/_relkit/v1/diagnostics"];
+export type InternalEndpointMode = "development" | "test" | "production";
+export interface InternalQuery {
+    readonly cursor?: string;
+    readonly limit: number;
+    readonly from?: string;
+    readonly to?: string;
+    readonly severity?: string;
+    readonly routeId?: string;
+    readonly functionId?: string;
+    readonly outcome?: string;
+    readonly requestId?: string;
+    readonly traceId?: string;
+}
+export interface InternalPage {
+    readonly [key: string]: contracts.JsonValue;
+    readonly items: readonly contracts.JsonValue[];
+    readonly nextCursor?: string;
+}
+export interface InternalReadiness {
+    readonly ready: boolean;
+    readonly reason?: string;
+}
+export interface InternalStreamEvent {
+    readonly [key: string]: contracts.JsonValue;
+    readonly cursor: string;
+    readonly type: string;
+    readonly data: contracts.JsonValue;
+}
+export type QuerySource = contracts.JsonValue | InternalPage | ((query: InternalQuery) => contracts.MaybePromise<contracts.JsonValue | InternalPage>);
+export type ValueSource<T> = T | (() => contracts.MaybePromise<T>);
+export interface InternalEndpointOptions {
+    readonly mode?: InternalEndpointMode;
+    readonly environment?: InternalEndpointMode;
+    readonly enabled?: boolean;
+    readonly bearerToken?: string;
+    readonly authorize?: (request: Request) => contracts.MaybePromise<boolean>;
+    readonly graph?: ValueSource<contracts.JsonValue>;
+    readonly readiness?: ValueSource<InternalReadiness>;
+    readonly ready?: ValueSource<InternalReadiness>;
+    readonly requests?: QuerySource;
+    readonly logs?: QuerySource;
+    readonly traces?: QuerySource;
+    readonly diagnostics?: QuerySource;
+    readonly stream?: ValueSource<readonly InternalStreamEvent[]> | ((query: InternalQuery) => contracts.MaybePromise<readonly InternalStreamEvent[]>);
+}
+export declare class InternalEndpointConfigurationError extends TypeError {
+    constructor(message: string);
+}
+/** Installs the versioned inspector stubs used before the full API package exists. */
+export declare function installInternalEndpoints(app: Hono, options?: InternalEndpointOptions): void;
+export declare function graphSnapshot(plan: RegistrationPlan): contracts.JsonValue;
+//# sourceMappingURL=internal-endpoints.d.ts.map

package/dist/internal-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-endpoints.d.ts","sourceRoot":"","sources":["../src/internal-endpoints.ts"],"names":[],"mappings":"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"}

package/dist/internal-endpoints.js

@@ -0,0 +1,106 @@
+import * as contracts from "@relkit/contracts";
+import { isAuthorized, isInvalidQueryError, jsonResponse, listResponse, readQuery, resolveQuery, resolveValue, streamBody, } from "./internal-endpoints-utils.js";
+export const INTERNAL_ENDPOINT_PROTOCOL = "relkit.inspector";
+export const INTERNAL_ENDPOINT_VERSION = contracts.API_VERSION;
+export const INTERNAL_ENDPOINT_PATHS = Object.freeze([
+    `${contracts.API_BASE_PATH}/health/live`,
+    `${contracts.API_BASE_PATH}/health/ready`,
+    `${contracts.API_BASE_PATH}/graph`,
+    `${contracts.API_BASE_PATH}/requests`,
+    `${contracts.API_BASE_PATH}/logs`,
+    `${contracts.API_BASE_PATH}/traces`,
+    `${contracts.API_BASE_PATH}/stream`,
+    `${contracts.API_BASE_PATH}/diagnostics`,
+]);
+export class InternalEndpointConfigurationError extends TypeError {
+    constructor(message) {
+        super(message);
+        this.name = "InternalEndpointConfigurationError";
+    }
+}
+/** Installs the versioned inspector stubs used before the full API package exists. */
+export function installInternalEndpoints(app, options = {}) {
+    const mode = options.environment ?? options.mode ?? "development";
+    const enabled = options.enabled ?? mode !== "production";
+    validateConfiguration(mode, enabled, options);
+    if (!enabled)
+        return;
+    const handle = (handler) => async (context) => {
+        if (!(await isAuthorized(context.req.raw, options)))
+            return jsonResponse({ error: "internal-endpoint-protected" }, 401, {
+                "www-authenticate": "Bearer",
+            });
+        try {
+            return await handler(context);
+        }
+        catch (error) {
+            if (isInvalidQueryError(error))
+                return jsonResponse({ error: "invalid-query" }, 400);
+            return jsonResponse({ error: "internal-error" }, 500);
+        }
+    };
+    app.get(`${contracts.API_BASE_PATH}/health/live`, handle(async () => jsonResponse({ status: "ok" })));
+    app.get(`${contracts.API_BASE_PATH}/health/ready`, handle(async () => {
+        const readiness = await resolveValue(options.readiness ?? options.ready ?? { ready: true });
+        return jsonResponse(readiness.ready
+            ? { status: "ready" }
+            : { status: "not-ready", reason: readiness.reason ?? "unavailable" }, readiness.ready ? 200 : 503);
+    }));
+    app.get(`${contracts.API_BASE_PATH}/graph`, handle(async () => jsonResponse(await resolveValue(options.graph ?? { graph: null }))));
+    for (const [name, source] of [
+        ["requests", options.requests],
+        ["logs", options.logs],
+        ["traces", options.traces],
+        ["diagnostics", options.diagnostics],
+    ]) {
+        if (source === undefined && name !== "diagnostics")
+            continue;
+        app.get(`${contracts.API_BASE_PATH}/${name}`, handle(async (context) => listResponse(source, context)));
+    }
+    if (options.stream !== undefined)
+        app.get(`${contracts.API_BASE_PATH}/stream`, handle(async (context) => streamResponse(options.stream, context)));
+}
+export function graphSnapshot(plan) {
+    return {
+        protocol: INTERNAL_ENDPOINT_PROTOCOL,
+        version: INTERNAL_ENDPOINT_VERSION,
+        graphHash: plan.graphHash,
+        manifestGraphHash: plan.graphHash,
+        graphContractVersion: contracts.GRAPH_VERSION,
+        manifestContractVersion: contracts.MANIFEST_VERSION,
+        manifestGeneratorVersion: contracts.GENERATOR_VERSION,
+        functions: plan.functions,
+        httpTriggers: plan.httpTriggers,
+        queues: plan.queues,
+        schedules: plan.schedules,
+        eventTriggers: plan.eventTriggers,
+        buckets: plan.buckets,
+        caches: plan.caches,
+        tools: plan.tools,
+        agents: plan.agents,
+        services: plan.services ?? [],
+    };
+}
+function validateConfiguration(mode, enabled, options) {
+    if (!("development" === mode || "test" === mode || "production" === mode))
+        throw new InternalEndpointConfigurationError("mode must be development, test, or production.");
+    if (mode === "production" &&
+        enabled &&
+        options.bearerToken === undefined &&
+        options.authorize === undefined)
+        throw new InternalEndpointConfigurationError("Production internal endpoints require bearerToken or authorize protection.");
+    if (options.bearerToken !== undefined && options.bearerToken.trim().length === 0)
+        throw new InternalEndpointConfigurationError("bearerToken must not be empty.");
+}
+async function streamResponse(source, context) {
+    const events = source === undefined ? [] : await resolveQuery(source, readQuery(context.req.raw));
+    return new Response(streamBody(events), {
+        headers: {
+            "cache-control": "no-store",
+            "content-type": "text/event-stream; charset=utf-8",
+            connection: "keep-alive",
+            "x-relkit-api-version": String(INTERNAL_ENDPOINT_VERSION),
+        },
+    });
+}
+//# sourceMappingURL=internal-endpoints.js.map

package/dist/internal-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-endpoints.js","sourceRoot":"","sources":["../src/internal-endpoints.ts"],"names":[],"mappings":"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"}

package/dist/materialize-routes-utils.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from "hono";
+import type { HttpTriggerRegistration } from "@relkit/graph";
+import type { HttpRouteRequest, RouteMaterializationOptions } from "./materialize-routes.js";
+export declare function createRouteHandler(trigger: HttpTriggerRegistration, options: RouteMaterializationOptions): (context: Context) => Promise<Response>;
+export declare function routeInput(request: HttpRouteRequest, trigger: HttpTriggerRegistration, targetFunctionId: string, options: RouteMaterializationOptions): Promise<unknown>;
+export declare function getEntry<T>(entries: Readonly<Record<string, T>> | ReadonlyMap<string, T>, id: string): T | undefined;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=materialize-routes-utils.d.ts.map

package/dist/materialize-routes-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-routes-utils.d.ts","sourceRoot":"","sources":["../src/materialize-routes-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAW7F,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,2BAA2B,GACnC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAEzC;AAwED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,uBAAuB,EAChC,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAC7D,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,SAAS,CAIf;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/materialize-routes-utils.js

@@ -0,0 +1,82 @@
+import { mapRequest } from "./request-mapping.js";
+import { isRequestMappingFailure } from "./request-mapping.js";
+import { mapFailureResponse, mapInputValidationResponse, mapSuccessResponse, } from "./response-mapping.js";
+import { getRequestState } from "./middleware.js";
+import { invokeWithRecord, mapInputWithRecord, recordDetail } from "./request-record-utils.js";
+import { requestFromContext } from "./request-context.js";
+export function createRouteHandler(trigger, options) {
+    return async (context) => stripHead(trigger, await handleRoute(context, trigger, options));
+}
+async function handleRoute(context, trigger, options) {
+    const state = getRequestState(context);
+    const request = requestFromContext(context, trigger.config.path);
+    const builder = state?.requestRecord;
+    builder?.setRoute(trigger.id, trigger.targetFunctionId);
+    builder?.setServiceId(trigger.serviceId);
+    recordDetail(builder, { kind: "match", targetId: trigger.id, outcome: "success" });
+    const responseOptions = responseOptionsFor(options, state?.signal);
+    const input = await mapInputWithRecord(() => routeInput(request, trigger, trigger.targetFunctionId, options), builder, trigger.targetFunctionId);
+    if (isRequestMappingFailure(input)) {
+        builder?.setOutcome("validation-error");
+        return mapInputValidationResponse(trigger, input.issues, responseOptions);
+    }
+    try {
+        const value = await invokeWithRecord(options.engine, {
+            functionId: trigger.targetFunctionId,
+            input,
+            source: "http",
+            ...(state?.signal === undefined ? {} : { signal: state.signal }),
+            ...(state?.requestId === undefined ? {} : { requestId: state.requestId }),
+            ...(state?.requestId === undefined ? {} : { correlationId: state.requestId }),
+            ...(state?.traceId === undefined ? {} : { traceId: state.traceId }),
+            ...(typeof trigger.config.timeoutMs !== "number"
+                ? {}
+                : { timeoutMs: trigger.config.timeoutMs }),
+            ...(options.auth === undefined ? {} : { auth: options.auth.contextFor(context.req.raw) }),
+        }, builder, "function", trigger.targetFunctionId);
+        return mapSuccessResponse(trigger, value, responseOptions);
+    }
+    catch (cause) {
+        return mapFailureResponse(trigger, cause, responseOptions);
+    }
+}
+function stripHead(trigger, response) {
+    if (trigger.config.method !== "HEAD")
+        return response;
+    return new Response(null, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+    });
+}
+function responseOptionsFor(options, signal) {
+    return {
+        ...(options.responseMapping ?? {}),
+        ...(options.manifest.responseSchemas === undefined
+            ? {}
+            : { responseSchemas: options.manifest.responseSchemas }),
+        ...(signal === undefined ? {} : { signal }),
+    };
+}
+export async function routeInput(request, trigger, targetFunctionId, options) {
+    if (options.mapInput !== undefined)
+        return options.mapInput(request, trigger, targetFunctionId, trigger.config.request);
+    const result = await mapRequest(request, trigger.config.request, {
+        ...(options.requestMapping ?? {}),
+        ...(trigger.config.maxBodyBytes === undefined
+            ? {}
+            : { maxBodyBytes: trigger.config.maxBodyBytes }),
+        transforms: options.manifest.requestTransforms,
+    });
+    return isRequestMappingFailure(result) ? result : result.value;
+}
+export function getEntry(entries, id) {
+    if (entries instanceof Map)
+        return entries.get(id);
+    const record = entries;
+    return Object.prototype.hasOwnProperty.call(record, id) ? record[id] : undefined;
+}
+export function isRecord(value) {
+    return value !== null && (typeof value === "object" || typeof value === "function");
+}
+//# sourceMappingURL=materialize-routes-utils.js.map

package/dist/materialize-routes-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-routes-utils.js","sourceRoot":"","sources":["../src/materialize-routes-utils.ts"],"names":[],"mappings":"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"}

package/dist/materialize-routes.d.ts

@@ -0,0 +1,90 @@
+import type { Hono } from "hono";
+import { GENERATOR_VERSION, MANIFEST_VERSION, type MaybePromise } from "@relkit/contracts";
+import type { HttpTriggerRegistration, RegistrationPlan } from "@relkit/graph";
+import type { RequestRecordSink } from "@relkit/observability";
+import type { MiddlewareContext } from "@relkit/routes";
+import type { MappingValue, RequestMappingOptions } from "./request-mapping.js";
+import { FRAMEWORK_MIDDLEWARE_ORDER, type FrameworkMiddleware, type FrameworkMiddlewareName } from "./middleware.js";
+import { type RateLimitRuntimeOptions } from "./rate-limit.js";
+import { type HttpAuthInvocation, type HttpAuthRuntime } from "./auth.js";
+import { type McpOptions } from "./mcp.js";
+import { type StaticFilesOptions } from "./static-files.js";
+export type ManifestEntries<T> = Readonly<Record<string, T>> | ReadonlyMap<string, T>;
+export interface RuntimeManifest {
+    readonly contractVersion: typeof MANIFEST_VERSION;
+    readonly generatorVersion: typeof GENERATOR_VERSION;
+    readonly graphHash: string;
+    readonly functions: ManifestEntries<unknown>;
+    readonly targets?: ManifestEntries<unknown>;
+    readonly routes?: ManifestEntries<unknown>;
+    readonly tools?: ManifestEntries<unknown>;
+    readonly services?: ManifestEntries<unknown>;
+    readonly hooks?: ManifestEntries<unknown>;
+    readonly application?: {
+        readonly env: unknown;
+        readonly providers: unknown;
+    };
+    readonly middleware: ManifestEntries<unknown>;
+    readonly requestTransforms: ManifestEntries<unknown>;
+    readonly responseSchemas?: ManifestEntries<unknown>;
+}
+export interface HttpInvocationOptions {
+    readonly functionId: string;
+    readonly input: unknown;
+    readonly source: "http" | "tool";
+    readonly signal?: AbortSignal;
+    readonly requestId?: string;
+    readonly traceId?: string;
+    readonly correlationId?: string;
+    readonly timeoutMs?: number;
+    readonly auth?: HttpAuthInvocation;
+    readonly toolHooks?: {
+        readonly onBefore?: (value: unknown, context: unknown) => unknown;
+        readonly onAfter?: (value: unknown, context: unknown) => unknown;
+    };
+}
+export interface HttpEngine {
+    readonly invoke: (options: HttpInvocationOptions) => Promise<unknown>;
+}
+export interface HttpRouteRequest {
+    readonly request: Request;
+    readonly pathPattern?: string;
+    readonly params: Readonly<Record<string, MappingValue>>;
+    readonly query: Readonly<Record<string, MappingValue>>;
+    readonly headers: Readonly<Record<string, MappingValue>>;
+    readonly validated?: Readonly<Record<string, unknown>>;
+}
+export type HttpInputMapper = (request: HttpRouteRequest, trigger: HttpTriggerRegistration, targetFunctionId: string, mapping?: unknown) => unknown | Promise<unknown>;
+export interface RouteMaterializationOptions {
+    readonly plan: RegistrationPlan;
+    readonly manifest: RuntimeManifest;
+    readonly engine: HttpEngine;
+    readonly mapInput?: HttpInputMapper;
+    readonly requestMapping?: RequestMappingOptions;
+    readonly responseMapping?: import("./response-mapping.js").ResponseMappingOptions;
+    readonly generationId?: string;
+    readonly observability?: RequestRecordSink;
+    readonly rateLimitRuntime?: RateLimitRuntimeOptions;
+    readonly auth?: HttpAuthRuntime;
+    readonly mcp?: McpOptions;
+    readonly staticFiles?: StaticFilesOptions;
+    readonly middlewareContext?: (options: {
+        readonly middlewareId: string;
+        readonly signal: AbortSignal;
+        readonly requestId?: string;
+        readonly traceId?: string;
+    }) => MaybePromise<MiddlewareContext>;
+}
+export type RuntimeHonoManifestErrorCode = "RELKIT_MANIFEST_VERSION_UNSUPPORTED" | "RELKIT_MANIFEST_GENERATOR_UNSUPPORTED" | "RELKIT_GRAPH_MANIFEST_MISMATCH" | "RELKIT_MANIFEST_MIDDLEWARE_MISSING" | "RELKIT_MANIFEST_MIDDLEWARE_MISMATCH" | "RELKIT_MANIFEST_RAW_ROUTE_MISSING" | "RELKIT_MANIFEST_TRANSFORM_MISSING";
+export declare class RuntimeHonoManifestError extends Error {
+    readonly code: RuntimeHonoManifestErrorCode;
+    readonly referenceId?: string;
+    constructor(code: RuntimeHonoManifestErrorCode, message: string, referenceId?: string);
+}
+/** Verifies the immutable plan/manifest boundary before any route is added. */
+export declare function assertHttpManifest(options: RouteMaterializationOptions): void;
+/** Registers only the HTTP triggers already present in the immutable plan. */
+export declare function materializeRoutes(app: Hono, options: RouteMaterializationOptions): void;
+export { FRAMEWORK_MIDDLEWARE_ORDER };
+export type { FrameworkMiddleware, FrameworkMiddlewareName };
+//# sourceMappingURL=materialize-routes.d.ts.map

package/dist/materialize-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-routes.d.ts","sourceRoot":"","sources":["../src/materialize-routes.ts"],"names":[],"mappings":"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"}

package/dist/materialize-routes.js

@@ -0,0 +1,86 @@
+import { GENERATOR_VERSION, MANIFEST_VERSION } from "@relkit/contracts";
+import { createRouteHandler, getEntry, isRecord } from "./materialize-routes-utils.js";
+import { registerRouteMiddleware } from "./route-middleware.js";
+import { FRAMEWORK_MIDDLEWARE_ORDER, } from "./middleware.js";
+import { withRateLimit } from "./rate-limit.js";
+import { registerAuthMiddleware } from "./auth.js";
+import { installRpc } from "./rpc.js";
+import { installMcp } from "./mcp.js";
+import { installStaticFiles } from "./static-files.js";
+export class RuntimeHonoManifestError extends Error {
+    code;
+    referenceId;
+    constructor(code, message, referenceId) {
+        super(message);
+        this.name = "RuntimeHonoManifestError";
+        this.code = code;
+        if (referenceId !== undefined)
+            this.referenceId = referenceId;
+    }
+}
+/** Verifies the immutable plan/manifest boundary before any route is added. */
+export function assertHttpManifest(options) {
+    const { manifest, plan } = options;
+    if (manifest.contractVersion !== MANIFEST_VERSION)
+        throw new RuntimeHonoManifestError("RELKIT_MANIFEST_VERSION_UNSUPPORTED", `Unsupported runtime manifest contract version ${String(manifest.contractVersion)}.`);
+    if (manifest.generatorVersion !== GENERATOR_VERSION)
+        throw new RuntimeHonoManifestError("RELKIT_MANIFEST_GENERATOR_UNSUPPORTED", `Unsupported runtime manifest generator version ${String(manifest.generatorVersion)}.`);
+    if (manifest.graphHash !== plan.graphHash)
+        throw new RuntimeHonoManifestError("RELKIT_GRAPH_MANIFEST_MISMATCH", `Manifest hash ${JSON.stringify(manifest.graphHash)} does not match plan hash ${JSON.stringify(plan.graphHash)}.`);
+    for (const middleware of plan.middlewares) {
+        const entry = getEntry(manifest.middleware, middleware.id);
+        if (!isRecord(entry) || entry.path !== middleware.path || typeof entry.handler !== "function")
+            throw new RuntimeHonoManifestError(entry === undefined
+                ? "RELKIT_MANIFEST_MIDDLEWARE_MISSING"
+                : "RELKIT_MANIFEST_MIDDLEWARE_MISMATCH", `Manifest middleware "${middleware.id}" is missing or does not match its graph node.`, middleware.id);
+    }
+    for (const trigger of plan.httpTriggers) {
+        if (trigger.config.rawHandler === true) {
+            const route = getEntry(manifest.routes ?? {}, trigger.id);
+            if (!isRecord(route) || typeof route.handler !== "function") {
+                throw new RuntimeHonoManifestError("RELKIT_MANIFEST_RAW_ROUTE_MISSING", `Manifest raw route "${trigger.id}" is missing its handler.`, trigger.id);
+            }
+            continue;
+        }
+        for (const transform of trigger.config.transforms) {
+            if (getEntry(manifest.requestTransforms, transform.id) === undefined)
+                throw new RuntimeHonoManifestError("RELKIT_MANIFEST_TRANSFORM_MISSING", `Manifest request transform "${transform.id}" is missing.`, transform.id);
+        }
+    }
+}
+/** Registers only the HTTP triggers already present in the immutable plan. */
+export function materializeRoutes(app, options) {
+    assertHttpManifest(options);
+    registerRouteMiddleware(app, options);
+    registerAuthMiddleware(app, options.auth);
+    const triggers = [...options.plan.httpTriggers].sort((left, right) => Number(right.config.method === "HEAD") - Number(left.config.method === "HEAD"));
+    for (const trigger of triggers) {
+        if (trigger.config.rawHandler === true) {
+            registerRawRoute(app, trigger, options);
+            continue;
+        }
+        const handler = withRateLimit(trigger, options, createRouteHandler(trigger, options));
+        for (const path of trigger.config.runtimePaths ?? [trigger.config.path]) {
+            if (trigger.config.method === "HEAD") {
+                app.on("GET", path, (context, next) => context.req.method === "HEAD" ? handler(context) : next());
+            }
+            else {
+                app.on(trigger.config.method, path, handler);
+            }
+        }
+    }
+    installRpc(app, options);
+    installMcp(app, options);
+    installStaticFiles(app, options.staticFiles);
+}
+function registerRawRoute(app, trigger, options) {
+    const route = getEntry(options.manifest.routes ?? {}, trigger.id);
+    if (!isRecord(route) || typeof route.handler !== "function")
+        return;
+    const handler = route.handler;
+    for (const path of trigger.config.runtimePaths ?? [trigger.config.path]) {
+        app.all(path, (context) => Promise.resolve(handler(context.req.raw)));
+    }
+}
+export { FRAMEWORK_MIDDLEWARE_ORDER };
+//# sourceMappingURL=materialize-routes.js.map

package/dist/materialize-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-routes.js","sourceRoot":"","sources":["../src/materialize-routes.ts"],"names":[],"mappings":"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"}

package/dist/mcp.d.ts

@@ -0,0 +1,7 @@
+import type { Hono } from "hono";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+export interface McpOptions {
+    readonly enabled?: boolean;
+}
+export declare function installMcp(app: Hono, options: RouteMaterializationOptions): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAG3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAWD,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAGhF"}

package/dist/mcp.js

@@ -0,0 +1,81 @@
+import { McpServer, createMcpHandler, } from "@modelcontextprotocol/server";
+import { getRequestState } from "./middleware.js";
+import { getEntry, isRecord } from "./materialize-routes-utils.js";
+export function installMcp(app, options) {
+    if (options.mcp?.enabled === false)
+        return;
+    app.all("/mcp", async (context) => handlerFor(context, options).fetch(context.req.raw));
+}
+function handlerFor(context, options) {
+    return createMcpHandler(() => {
+        const server = new McpServer({ name: "relkit", version: "2" });
+        const tools = options.plan.tools
+            .filter((entry) => entry.mcp)
+            .sort((left, right) => left.id.localeCompare(right.id));
+        for (const tool of tools) {
+            register(server, tool, context, options);
+        }
+        return server;
+    });
+}
+function register(server, tool, context, options) {
+    const runtime = getEntry(options.manifest.tools ?? {}, tool.id);
+    const input = runtime?.target?.input;
+    const output = runtime?.target?.output;
+    server.registerTool(tool.id, {
+        description: tool.description,
+        ...(input === undefined ? {} : { inputSchema: input }),
+        ...(output === undefined ? {} : { outputSchema: output }),
+        annotations: {
+            readOnlyHint: tool.sideEffect === "none" || tool.sideEffect === "read",
+            destructiveHint: tool.sideEffect === "write",
+        },
+    }, async (arguments_) => invoke(tool, runtime, arguments_, context, options));
+}
+async function invoke(tool, runtime, input, context, options) {
+    if (requiresApproval(tool)) {
+        return failure(`Approval required for tool "${tool.id}"`);
+    }
+    const state = getRequestState(context);
+    try {
+        const value = await options.engine.invoke({
+            functionId: tool.targetFunctionId,
+            input,
+            source: "tool",
+            ...(state?.signal === undefined ? {} : { signal: state.signal }),
+            ...(state?.requestId === undefined ? {} : { requestId: state.requestId }),
+            ...(state?.requestId === undefined ? {} : { correlationId: state.requestId }),
+            ...(state?.traceId === undefined ? {} : { traceId: state.traceId }),
+            ...(tool.timeoutMs === undefined ? {} : { timeoutMs: tool.timeoutMs }),
+            ...(options.auth === undefined ? {} : { auth: options.auth.contextFor(context.req.raw) }),
+            ...(runtime?.onBefore === undefined && runtime?.onAfter === undefined
+                ? {}
+                : {
+                    toolHooks: {
+                        ...(runtime.onBefore === undefined ? {} : { onBefore: runtime.onBefore }),
+                        ...(runtime.onAfter === undefined ? {} : { onAfter: runtime.onAfter }),
+                    },
+                }),
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(value) }],
+            ...(isRecord(value) ? { structuredContent: value } : {}),
+        };
+    }
+    catch (cause) {
+        return failure(publicMessage(cause));
+    }
+}
+function requiresApproval(tool) {
+    return (tool.approval === "always" ||
+        (tool.approval === "on-write" && tool.sideEffect !== "none" && tool.sideEffect !== "read"));
+}
+function failure(message) {
+    return { isError: true, content: [{ type: "text", text: message }] };
+}
+function publicMessage(cause) {
+    if (isRecord(cause) && typeof cause.code === "string")
+        return cause.code;
+    return "Tool invocation failed";
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/middleware-limits.d.ts

@@ -0,0 +1,4 @@
+import type { MiddlewareHandler } from "hono";
+import { type HttpMiddlewareOptions } from "./middleware-utils.js";
+export declare function limitsMiddleware(options?: HttpMiddlewareOptions): MiddlewareHandler;
+//# sourceMappingURL=middleware-limits.d.ts.map

package/dist/middleware-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-limits.d.ts","sourceRoot":"","sources":["../src/middleware-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAOL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAiEvF"}