@relkit/runtime-hono 0.5.4 → 0.5.5

package/dist/materialize-routes.d.ts

@@ -1,107 +1,16 @@
 import type { Hono } from "hono";
-import type { UpgradeWebSocket } from "hono/ws";
-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 type { RouteMaterializationOptions } from "./materialize-routes.types.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";
-import type { ClientIdentityRuntime } from "./client-identity.js";
-import type { TransportSecurityOptions } from "./transport-security.js";
-import type { RealtimeRuntime } from "./realtime-runtime.js";
-import type { AgentRuntime } from "./agent-runtime.js";
-import type { JobsRpcRuntime } from "./jobs/types.js";
-export { assertHttpManifest } from "./materialize-routes-validation.js";
 export { RuntimeHonoManifestError } from "./manifest-validation.js";
 export type { RuntimeHonoManifestErrorCode } from "./manifest-validation.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 activationFingerprint: import("@relkit/contracts").RuntimeActivationFingerprint;
-    readonly runtimeIntegrationsPlan: import("@relkit/contracts").RuntimeIntegrationPlanReference;
-    readonly functions: ManifestEntries<unknown>;
-    readonly targets?: ManifestEntries<unknown>;
-    readonly agents?: ManifestEntries<unknown>;
-    readonly channels?: ManifestEntries<unknown>;
-    readonly routes?: ManifestEntries<unknown>;
-    readonly tools?: ManifestEntries<unknown>;
-    readonly services?: ManifestEntries<unknown>;
-    readonly tasks?: ManifestEntries<unknown>;
-    readonly jobs?: ManifestEntries<unknown>;
-    readonly hooks?: ManifestEntries<unknown>;
-    readonly application?: {
-        readonly env: 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 trigger?: unknown;
-    readonly progressSink?: import("@relkit/invocation").ProgressSink;
-    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 clientIdentity?: ClientIdentityRuntime;
-    readonly transportSecurity?: TransportSecurityOptions;
-    readonly realtime?: RealtimeRuntime;
-    readonly agentRuntime?: AgentRuntime;
-    readonly jobs?: JobsRpcRuntime;
-    /** Compatibility alias for callers that name the service explicitly. */
-    readonly jobsRuntime?: JobsRpcRuntime;
-    readonly mcp?: McpOptions;
-    readonly staticFiles?: StaticFilesOptions;
-    readonly upgradeWebSocket?: UpgradeWebSocket;
-    readonly middlewareContext?: (options: {
-        readonly middlewareId: string;
-        readonly signal: AbortSignal;
-        readonly request: Request;
-        readonly auth?: HttpAuthInvocation;
-        readonly requestId?: string;
-        readonly traceId?: string;
-    }) => MaybePromise<MiddlewareContext>;
-}
-export declare function materializeRoutes(app: Hono, options: RouteMaterializationOptions): void;
+export { assertHttpManifest } from "./materialize-routes-validation.js";
+export type { HttpEngine, HttpInputMapper, HttpInvocationOptions, HttpRouteRequest, ManifestEntries, RouteMaterializationOptions, RuntimeManifest, } from "./materialize-routes.types.js";
 export { FRAMEWORK_MIDDLEWARE_ORDER };
 export type { FrameworkMiddleware, FrameworkMiddlewareName };
+/** Validates and registers declared routes with deterministic middleware ordering.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; registers validated HTTP, RPC, optional WebSocket, MCP and static routes.
+ */
+export declare function materializeRoutes(app: Hono, options: RouteMaterializationOptions): void;
 //# sourceMappingURL=materialize-routes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"materialize-routes.d.ts","sourceRoot":"","sources":["../src/materialize-routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"materialize-routes.d.ts","sourceRoot":"","sources":["../src/materialize-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAKjC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EACL,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EACV,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAC;AAC7D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA8BvF"}

package/dist/materialize-routes.js

@@ -1,19 +1,25 @@
-import { GENERATOR_VERSION, MANIFEST_VERSION } from "@relkit/contracts";
+import { registerAuthMiddleware } from "./auth.js";
+import { installHttpLogging } from "./http-logging.js";
 import { createRouteHandler, getEntry, isRecord } from "./materialize-routes-utils.js";
-import { registerRouteMiddleware } from "./route-middleware.js";
+import { assertHttpManifest } from "./materialize-routes-validation.js";
+import { installMcp } from "./mcp.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 { registerRouteMiddleware } from "./route-middleware.js";
 import { installRpcWebSocket } from "./rpc-websocket.js";
-import { installMcp } from "./mcp.js";
+import { installRpc } from "./rpc.js";
 import { installStaticFiles } from "./static-files.js";
-import { RuntimeHonoManifestError } from "./manifest-validation.js";
-import { assertHttpManifest } from "./materialize-routes-validation.js";
-export { assertHttpManifest } from "./materialize-routes-validation.js";
 export { RuntimeHonoManifestError } from "./manifest-validation.js";
+export { assertHttpManifest } from "./materialize-routes-validation.js";
+export { FRAMEWORK_MIDDLEWARE_ORDER };
+/** Validates and registers declared routes with deterministic middleware ordering.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; registers validated HTTP, RPC, optional WebSocket, MCP and static routes.
+ */
 export function materializeRoutes(app, options) {
     assertHttpManifest(options);
+    installHttpLogging(app, options);
     registerAuthMiddleware(app, options.auth);
     registerRouteMiddleware(app, options);
     const triggers = [...options.plan.httpTriggers].sort((left, right) => Number(right.config.method === "HEAD") - Number(left.config.method === "HEAD"));
@@ -39,12 +45,22 @@ export function materializeRoutes(app, options) {
     installMcp(app, options);
     installStaticFiles(app, options.staticFiles);
 }
+/** Registers one raw route using the configured method and path.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; registers callable raw handlers for every compiled runtime path.
+ */
 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]) {
+        /** Forward the raw Fetch request without invoking declarative input mapping.
+         * @param context - Hono context supplying the original native request.
+         * @returns A Promise for the raw route handler's response.
+         */
         const run = (context) => Promise.resolve(handler(context.req.raw));
         if (trigger.config.method === "ALL")
             app.all(path, run);
@@ -52,5 +68,4 @@ function registerRawRoute(app, trigger, options) {
             app.on(trigger.config.method, path, run);
     }
 }
-export { FRAMEWORK_MIDDLEWARE_ORDER };
 //# sourceMappingURL=materialize-routes.js.map

package/dist/materialize-routes.js.map

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

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

@@ -0,0 +1,110 @@
+import type { UpgradeWebSocket } from "hono/ws";
+import type { GENERATOR_VERSION, MANIFEST_VERSION, 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 type { RateLimitRuntimeOptions } from "./rate-limit.js";
+import type { HttpAuthInvocation, HttpAuthRuntime } from "./auth.js";
+import type { McpOptions } from "./mcp.js";
+import type { StaticFilesOptions } from "./static-files.js";
+import type { ClientIdentityRuntime } from "./client-identity.js";
+import type { TransportSecurityOptions } from "./transport-security.js";
+import type { RealtimeRuntime } from "./realtime-runtime.js";
+import type { AgentRuntime } from "./agent-runtime.js";
+import type { JobsRpcRuntime } from "./jobs/types.js";
+/** Contract for manifest entries used by materialize routes.
+ * @typeParam T - Value type retained by this operation.
+ */
+export type ManifestEntries<T> = Readonly<Record<string, T>> | ReadonlyMap<string, T>;
+/** Contract for runtime manifest used by materialize routes. */
+export interface RuntimeManifest {
+    readonly contractVersion: typeof MANIFEST_VERSION;
+    readonly generatorVersion: typeof GENERATOR_VERSION;
+    readonly graphHash: string;
+    readonly activationFingerprint: import("@relkit/contracts").RuntimeActivationFingerprint;
+    readonly runtimeIntegrationsPlan: import("@relkit/contracts").RuntimeIntegrationPlanReference;
+    readonly functions: ManifestEntries<unknown>;
+    readonly targets?: ManifestEntries<unknown>;
+    readonly agents?: ManifestEntries<unknown>;
+    readonly channels?: ManifestEntries<unknown>;
+    readonly routes?: ManifestEntries<unknown>;
+    readonly tools?: ManifestEntries<unknown>;
+    readonly services?: ManifestEntries<unknown>;
+    readonly tasks?: ManifestEntries<unknown>;
+    readonly jobs?: ManifestEntries<unknown>;
+    readonly hooks?: ManifestEntries<unknown>;
+    readonly application?: {
+        readonly env: unknown;
+    };
+    readonly middleware: ManifestEntries<unknown>;
+    readonly requestTransforms: ManifestEntries<unknown>;
+    readonly responseSchemas?: ManifestEntries<unknown>;
+}
+/** http invocation options configuring dependencies, callbacks and runtime policy. */
+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 trigger?: unknown;
+    readonly progressSink?: import("@relkit/invocation").ProgressSink;
+    readonly toolHooks?: {
+        readonly onBefore?: (value: unknown, context: unknown) => unknown;
+        readonly onAfter?: (value: unknown, context: unknown) => unknown;
+    };
+}
+/** Contract for http engine used by materialize routes. */
+export interface HttpEngine {
+    readonly invoke: (options: HttpInvocationOptions) => Promise<unknown>;
+}
+/** Contract for http route request used by materialize routes. */
+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>>;
+}
+/** Contract for http input mapper used by materialize routes. */
+export type HttpInputMapper = (request: HttpRouteRequest, trigger: HttpTriggerRegistration, targetFunctionId: string, mapping?: unknown) => unknown | Promise<unknown>;
+/** route materialization options configuring dependencies, callbacks and runtime policy. */
+export interface RouteMaterializationOptions {
+    /** Optional Effect logger sinks and threshold for this application. */
+    readonly effectLogger?: import("@relkit/runtime-effect").LoggerOptions;
+    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 clientIdentity?: ClientIdentityRuntime;
+    readonly transportSecurity?: TransportSecurityOptions;
+    readonly realtime?: RealtimeRuntime;
+    readonly agentRuntime?: AgentRuntime;
+    readonly jobs?: JobsRpcRuntime;
+    /** Compatibility alias for callers that name the service explicitly. */
+    readonly jobsRuntime?: JobsRpcRuntime;
+    readonly mcp?: McpOptions;
+    readonly staticFiles?: StaticFilesOptions;
+    readonly upgradeWebSocket?: UpgradeWebSocket;
+    readonly middlewareContext?: (options: {
+        readonly middlewareId: string;
+        readonly signal: AbortSignal;
+        readonly request: Request;
+        readonly auth?: HttpAuthInvocation;
+        readonly requestId?: string;
+        readonly traceId?: string;
+    }) => MaybePromise<MiddlewareContext>;
+}
+//# sourceMappingURL=materialize-routes.types.d.ts.map

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

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

package/dist/materialize-routes.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=materialize-routes.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-routes.types.js","sourceRoot":"","sources":["../src/materialize-routes.types.ts"],"names":[],"mappings":""}

package/dist/mcp.d.ts

@@ -1,7 +1,42 @@
-import type { Hono } from "hono";
+import type { ToolRegistration } from "@relkit/graph";
+import { Effect, Context as EffectContext, Layer } from "effect";
+import type { Context, Hono } from "hono";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
-export interface McpOptions {
-    readonly enabled?: boolean;
-}
+import type { RuntimeTool } from "./mcp.types.js";
+export type { McpOptions } from "./mcp.types.js";
+/** Registers the configured MCP endpoint with the existing protocol handler.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export declare function installMcp(app: Hono, options: RouteMaterializationOptions): void;
+/** Invokes an approved MCP tool and projects its result into public protocol content.
+ * @param tool - Declared tool or tool-call identity used for policy and attribution.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An Effect producing MCP text and optional structured content, or a sanitized tool failure.
+ */
+declare const invoke: (tool: ToolRegistration, runtime: RuntimeTool | undefined, input: unknown, context: Context<any, any, {}>, options: RouteMaterializationOptions) => Effect.Effect<{
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+} | {
+    structuredContent?: Record<string, unknown>;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}, never, never>;
+declare const McpTools_base: EffectContext.ServiceClass<McpTools, "@relkit/runtime-hono/McpTools", {
+    readonly invoke: typeof invoke;
+}>;
+/** MCP tool execution applies approval policy before invoking the shared engine service. */
+export declare class McpTools extends McpTools_base {
+}
+/** Live tool workflows preserve public failure sanitization and engine hook ordering. */
+export declare const McpToolsLive: Layer.Layer<McpTools, never, never>;
 //# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,aAAa,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAGhF;AAwDD;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM;;;;;;;;;;;;gBAuCV,CAAC;;qBAG8E,OAAO,MAAM;;AAD9F,4FAA4F;AAC5F,qBAAa,QAAS,SAAQ,aAE7B;CAAG;AAEJ,yFAAyF;AACzF,eAAO,MAAM,YAAY,qCAEvB,CAAC"}

package/dist/mcp.js

@@ -1,11 +1,24 @@
-import { McpServer, createMcpHandler, } from "@modelcontextprotocol/server";
-import { getRequestState } from "./middleware.js";
+import { McpServer, createMcpHandler } from "@modelcontextprotocol/server";
+import { Effect, Context as EffectContext, Layer, Result } from "effect";
+import { observeHttp, runHttp } from "./http-effect.js";
+import { HttpInvocation, httpInvocationLayer } from "./http-invocation.js";
 import { getEntry, isRecord } from "./materialize-routes-utils.js";
+import { getRequestState } from "./middleware.js";
+/** Registers the configured MCP endpoint with the existing protocol handler.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export function installMcp(app, options) {
     if (options.mcp?.enabled === false)
         return;
     app.all("/mcp", async (context) => handlerFor(context, options).fetch(context.req.raw));
 }
+/** Creates the per-request MCP server and registers exposed tools deterministically.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An MCP HTTP handler that creates a server exposing the declared MCP tools.
+ */
 function handlerFor(context, options) {
     return createMcpHandler(() => {
         const server = new McpServer({ name: "relkit", version: "2" });
@@ -18,6 +31,13 @@ function handlerFor(context, options) {
         return server;
     });
 }
+/** Registers tool schemas, side-effect annotations and its invocation handler.
+ * @param server - server supplied by the caller.
+ * @param tool - Declared tool or tool-call identity used for policy and attribution.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 function register(server, tool, context, options) {
     const runtime = getEntry(options.manifest.tools ?? {}, tool.id);
     const input = runtime?.target?.input;
@@ -30,15 +50,24 @@ function register(server, tool, context, options) {
             readOnlyHint: tool.sideEffect === "none" || tool.sideEffect === "read",
             destructiveHint: tool.sideEffect === "write",
         },
-    }, async (arguments_) => invoke(tool, runtime, arguments_, context, options));
+    }, (arguments_) => runHttp(Effect.flatMap(McpTools, (tools) => tools.invoke(tool, runtime, arguments_, context, options)).pipe(Effect.provide(McpToolsLive))));
 }
-async function invoke(tool, runtime, input, context, options) {
+/** Invokes an approved MCP tool and projects its result into public protocol content.
+ * @param tool - Declared tool or tool-call identity used for policy and attribution.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An Effect producing MCP text and optional structured content, or a sanitized tool failure.
+ */
+const invoke = Effect.fn("McpTools.invoke")(function* (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({
+    const result = yield* Effect.result(Effect.gen(function* () {
+        const invocation = yield* HttpInvocation;
+        const value = yield* invocation.invoke({
             functionId: tool.targetFunctionId,
             input,
             source: "tool",
@@ -60,18 +89,35 @@ async function invoke(tool, runtime, input, context, options) {
             content: [{ type: "text", text: JSON.stringify(value) }],
             ...(isRecord(value) ? { structuredContent: value } : {}),
         };
-    }
-    catch (cause) {
-        return failure(publicMessage(cause));
-    }
+    }).pipe(Effect.provide(httpInvocationLayer(options.engine))));
+    return Result.isSuccess(result) ? result.success : failure(publicMessage(result.failure.cause));
+});
+/** MCP tool execution applies approval policy before invoking the shared engine service. */
+export class McpTools extends EffectContext.Service()("@relkit/runtime-hono/McpTools") {
 }
+/** Live tool workflows preserve public failure sanitization and engine hook ordering. */
+export const McpToolsLive = Layer.succeed(McpTools, {
+    invoke: (...args) => observeHttp("mcp.invoke", invoke(...args)),
+});
+/** Evaluates declared tool approval policy before invoking application code.
+ * @param tool - Declared tool or tool-call identity used for policy and attribution.
+ * @returns Whether the value satisfies the required public contract.
+ */
 function requiresApproval(tool) {
     return (tool.approval === "always" ||
         (tool.approval === "on-write" && tool.sideEffect !== "none" && tool.sideEffect !== "read"));
 }
+/** Creates a sanitized MCP tool failure response.
+ * @param message - Public message included in the resulting value or failure.
+ * @returns An MCP error result containing one public text item.
+ */
 function failure(message) {
     return { isError: true, content: [{ type: "text", text: message }] };
 }
+/** Projects a bounded public error code without exposing native exception details.
+ * @param cause - Native failure projected without exposing private exception details.
+ * @returns The public error code when available, otherwise the fixed tool-failure message.
+ */
 function publicMessage(cause) {
     if (isRecord(cause) && typeof cause.code === "string")
         return cause.code;

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAS,EAAE,OAAoC;IACxE,IAAI,OAAO,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO;IAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,OAAgB,EAAE,OAAoC;IACxE,OAAO,gBAAgB,CAAC,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK;aAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;aAC5B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CACf,MAAiB,EACjB,IAAsB,EACtB,OAAgB,EAChB,OAAoC;IAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,CAA4B,CAAC;IAC3F,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACvC,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,EAAE,EACP;QACE,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QACzD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM;YACtE,eAAe,EAAE,IAAI,CAAC,UAAU,KAAK,OAAO;SAC7C;KACF,EACD,CAAC,UAAmB,EAAE,EAAE,CACtB,OAAO,CACL,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CACjC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAC1D,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CACrC,CACJ,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,EACnD,IAAsB,EACtB,OAAgC,EAChC,KAAc,EACd,OAAgB,EAChB,OAAoC;IAEpC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,+BAA+B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,gBAAgB;YACjC,KAAK;YACL,MAAM,EAAE,MAAM;YACd,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;YACzE,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzF,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS;gBACnE,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,SAAS,EAAE;wBACT,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;wBACzE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;qBACvE;iBACF,CAAC;SACP,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;IACJ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAC7D,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAClG,CAAC,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,OAAO,QAAS,SAAQ,aAAa,CAAC,OAAO,EAAgD,CACjG,+BAA+B,CAChC;CAAG;AAEJ,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;IAClD,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;CAChE,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAsB;IAC9C,OAAO,CACL,IAAI,CAAC,QAAQ,KAAK,QAAQ;QAC1B,CAAC,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,CAC3F,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACzE,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/dist/mcp.types.d.ts

@@ -0,0 +1,15 @@
+import type { StandardSchemaWithJSON } from "@modelcontextprotocol/server";
+/** mcp options configuring dependencies, callbacks and runtime policy. */
+export interface McpOptions {
+    readonly enabled?: boolean;
+}
+/** Contract for runtime tool used by mcp. */
+export type RuntimeTool = {
+    readonly target?: {
+        readonly input?: StandardSchemaWithJSON;
+        readonly output?: StandardSchemaWithJSON;
+    };
+    readonly onBefore?: (value: unknown, context: unknown) => unknown;
+    readonly onAfter?: (value: unknown, context: unknown) => unknown;
+};
+//# sourceMappingURL=mcp.types.d.ts.map

package/dist/mcp.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.types.d.ts","sourceRoot":"","sources":["../src/mcp.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;KAC1C,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAClE,CAAC"}

package/dist/mcp.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.types.js.map

package/dist/mcp.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.types.js","sourceRoot":"","sources":["../src/mcp.types.ts"],"names":[],"mappings":""}

package/dist/middleware-limits.d.ts

@@ -1,4 +1,8 @@
 import type { MiddlewareHandler } from "hono";
 import { type HttpMiddlewareOptions } from "./middleware-utils.js";
+/** Enforces declared body and timeout limits while cleaning up request listeners.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler rejecting oversized requests and forwarding cancellation with scoped timeout cleanup.
+ */
 export declare function limitsMiddleware(options?: HttpMiddlewareOptions): MiddlewareHandler;
 //# sourceMappingURL=middleware-limits.d.ts.map

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

@@ -1 +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;AAI/B,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAqEvF"}
+{"version":3,"file":"middleware-limits.d.ts","sourceRoot":"","sources":["../src/middleware-limits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,OAAO,EAOL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAgFvF"}

package/dist/middleware-limits.js

@@ -1,6 +1,12 @@
+import { Effect } from "effect";
+import { isRelkitControlPlanePath } from "./control-plane.js";
+import { httpBoundary, runHttp } from "./http-effect.js";
 import { createFallbackState, emitLifecycle, getRequestState, lifecycleEvent, setRequestState, validateLimit, } from "./middleware-utils.js";
 import { ensureRequestRecord, finishRequestRecord } from "./request-record-middleware.js";
-import { isRelkitControlPlanePath } from "./control-plane.js";
+/** Enforces declared body and timeout limits while cleaning up request listeners.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler rejecting oversized requests and forwarding cancellation with scoped timeout cleanup.
+ */
 export function limitsMiddleware(options = {}) {
     validateLimit(options.maxBodyBytes, "maxBodyBytes");
     validateLimit(options.timeoutMs, "timeoutMs");
@@ -33,6 +39,9 @@ export function limitsMiddleware(options = {}) {
         }
         const controller = new AbortController();
         const source = context.req.raw.signal;
+        /** Propagate native request cancellation to the middleware-owned controller.
+         * @returns Nothing; preserves the original cancellation reason.
+         */
         const abort = () => controller.abort(source.reason);
         if (source.aborted)
             abort();
@@ -42,15 +51,15 @@ export function limitsMiddleware(options = {}) {
         setRequestState(context, Object.freeze(deadlineMs === undefined
             ? { ...current, signal: controller.signal }
             : { ...current, signal: controller.signal, deadlineMs }));
-        const timer = deadlineMs === undefined
-            ? undefined
-            : setTimeout(() => controller.abort(new DOMException("HTTP request timeout", "TimeoutError")), options.timeoutMs);
         try {
-            await next();
+            await runHttp(Effect.scoped(Effect.gen(function* () {
+                if (options.timeoutMs !== undefined) {
+                    yield* Effect.sleep(options.timeoutMs).pipe(Effect.andThen(Effect.sync(() => controller.abort(new DOMException("HTTP request timeout", "TimeoutError")))), Effect.forkScoped);
+                }
+                yield* httpBoundary("http.middleware.next", next);
+            })));
         }
         finally {
-            if (timer !== undefined)
-                clearTimeout(timer);
             source.removeEventListener("abort", abort);
         }
     };