@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;KACpC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/agent-runtime.types.d.ts

@@ -0,0 +1,18 @@
+import type { AgentStateProvider } from "@relkit/agents";
+import type { MaybePromise } from "@relkit/contracts";
+import type { HttpAuthInvocation } from "./auth.js";
+/** Contract for agent runtime used by agent runtime. */
+export interface AgentRuntime {
+    readonly applicationId: string;
+    readonly environment: string;
+    readonly generationId: string;
+    readonly publicFingerprint: string;
+    readonly signal?: AbortSignal;
+    readonly track?: (task: Promise<void>) => void;
+    readonly provider: (profile: string) => MaybePromise<AgentStateProvider>;
+    readonly trustedContext?: (input: {
+        readonly request: Request;
+        readonly auth?: HttpAuthInvocation;
+    }) => MaybePromise<unknown>;
+}
+//# sourceMappingURL=agent-runtime.types.d.ts.map

package/dist/agent-runtime.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.types.d.ts","sourceRoot":"","sources":["../src/agent-runtime.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;KACpC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC7B"}

package/dist/agent-runtime.types.js

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

package/dist/agent-runtime.types.js.map

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

package/dist/agent-tool-content.d.ts

@@ -0,0 +1,17 @@
+import { Effect } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+import type { ResolvedAgent } from "./agent-content-sink.types.js";
+import type { ToolPartState } from "@relkit/agents";
+import type { ActiveAgentExecution } from "./agent-active-execution.js";
+/** Allocates tool-message replay state for one run, retaining the original part and creation identifiers.
+ * @param resolved - Authorized provider and durable scope.
+ * @param active - Current execution claim and continuation receipt.
+ * @returns A lazy tool-journal operation owning incremental part state.
+ */
+export declare function makeAgentToolContent(resolved: ResolvedAgent, active: ActiveAgentExecution): (value: {
+    toolCallId: string;
+    toolId: string;
+    state: ToolPartState;
+    value?: unknown;
+}, signal: AbortSignal) => Effect.Effect<undefined, HttpBoundaryError, never>;
+//# sourceMappingURL=agent-tool-content.d.ts.map

package/dist/agent-tool-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-content.d.ts","sourceRoot":"","sources":["../src/agent-tool-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAgB,iBAAiB,EAAe,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKxE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB;gBAkB/D,MAAM;YAAU,MAAM;WAAS,aAAa;YAAU,OAAO;8EAuDvF"}

package/dist/agent-tool-content.js

@@ -0,0 +1,61 @@
+import { Effect } from "effect";
+import { httpBoundary, HttpBoundaryError, observeHttp } from "./http-effect.js";
+import { agentLimits, digest, encodedBytes } from "./agent-rpc-support.js";
+import { createOperationId } from "@relkit/realtime";
+/** Allocates tool-message replay state for one run, retaining the original part and creation identifiers.
+ * @param resolved - Authorized provider and durable scope.
+ * @param active - Current execution claim and continuation receipt.
+ * @returns A lazy tool-journal operation owning incremental part state.
+ */
+export function makeAgentToolContent(resolved, active) {
+    const toolParts = new Map();
+    const toolCreatedAt = new Map();
+    return Effect.fn("AgentContent.emitTool")(function* (value, signal) {
+        if (signal.aborted)
+            return yield* Effect.fail(new HttpBoundaryError({ operation: "agent.content.emitTool", cause: signal.reason }));
+        const toolMessageId = `${active.receipt.runId}:tool:${value.toolCallId}`;
+        const prior = toolParts.get(value.toolCallId);
+        const part = {
+            ...(prior ?? {
+                partId: `${toolMessageId}:state`,
+                kind: "tool",
+                toolCallId: value.toolCallId,
+                toolId: value.toolId,
+            }),
+            state: value.state,
+            ...(value.state === "input-streaming" && typeof value.value === "string"
+                ? { inputText: value.value }
+                : {}),
+            ...(value.state === "input-ready" ? { input: value.value } : {}),
+            ...(value.state === "succeeded" ? { output: value.value } : {}),
+        };
+        toolParts.set(value.toolCallId, part);
+        const createdAt = toolCreatedAt.get(value.toolCallId) ?? new Date().toISOString();
+        toolCreatedAt.set(value.toolCallId, createdAt);
+        const message = {
+            messageId: toolMessageId,
+            runId: active.receipt.runId,
+            role: "tool",
+            parts: [part],
+            createdAt,
+        };
+        yield* httpBoundary("agent.content.emitTool", () => resolved.provider.appendJournal({
+            ...resolved.scope,
+            threadId: active.receipt.threadId,
+            runId: active.receipt.runId,
+            claim: active.claim,
+            operationId: createOperationId(),
+            semanticDigest: digest(message),
+            record: {
+                recordId: crypto.randomUUID(),
+                runId: active.receipt.runId,
+                kind: "message",
+                publicValue: message,
+                encodedBytes: encodedBytes(message),
+                createdAt: message.createdAt,
+            },
+            limits: agentLimits,
+        }));
+    }, (effect) => observeHttp("agent.content.emitTool", effect));
+}
+//# sourceMappingURL=agent-tool-content.js.map

package/dist/agent-tool-content.js.map

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

package/dist/api-docs.d.ts

@@ -1,22 +1,17 @@
-import { type JsonValue } from "@relkit/contracts";
 import type { RegistrationPlan } from "@relkit/graph";
-import { type OpenApiDocument } from "@relkit/openapi";
 import type { Hono } from "hono";
-import type { InternalEndpointMode, InternalEndpointOptions } from "./internal-endpoints.js";
+import type { ApiDocsOptions } from "./api-docs.types.js";
+export type { ApiDocsOptions } from "./api-docs.types.js";
 export declare const OPENAPI_PATH: "/_relkit/v1/openapi.json";
 export declare const API_REFERENCE_PATH: "/_relkit/v1/api-reference";
-export interface ApiDocsOptions {
-    readonly mode?: InternalEndpointMode;
-    readonly enabled?: boolean;
-    readonly enabledInProduction?: boolean;
-    readonly excludeDomains?: readonly string[];
-    readonly bearerToken?: string;
-    readonly authorize?: InternalEndpointOptions["authorize"];
-    readonly document?: OpenApiDocument | JsonValue;
-}
 export declare class ApiDocsConfigurationError extends TypeError {
     constructor(message: string);
 }
-/** Installs the active OpenAPI document and the sole bundled Scalar reference UI. */
+/** Installs the active OpenAPI document and the sole bundled Scalar reference UI.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param plan - Validated application registration plan.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; registers the document and reference UI only when exposure is enabled.
+ */
 export declare function installApiDocs(app: Hono, plan: RegistrationPlan, options?: ApiDocsOptions): void;
 //# sourceMappingURL=api-docs.d.ts.map

package/dist/api-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../src/api-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAW,IAAI,EAAQ,MAAM,MAAM,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAE7F,eAAO,MAAM,YAAY,4BAA2C,CAAC;AACrE,eAAO,MAAM,kBAAkB,6BAA4C,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACjD;AAED,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,cAAmB,GAC3B,IAAI,CAiDN"}
+{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../src/api-docs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGxE,OAAO,KAAK,EAAW,IAAI,EAAQ,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,YAAY,4BAA2C,CAAC;AACrE,eAAO,MAAM,kBAAkB,6BAA4C,CAAC;AAE5E,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,cAAmB,GAC3B,IAAI,CAqDN"}

package/dist/api-docs.js

@@ -1,6 +1,6 @@
-import { Scalar } from "@scalar/hono-api-reference";
 import { API_BASE_PATH, API_VERSION, CONTRACT_VERSION, canonicalJson, } from "@relkit/contracts";
 import { generateOpenApi } from "@relkit/openapi";
+import { Scalar } from "@scalar/hono-api-reference";
 import { isAuthorized, jsonResponse } from "./internal-endpoints-utils.js";
 export const OPENAPI_PATH = `${API_BASE_PATH}/openapi.json`;
 export const API_REFERENCE_PATH = `${API_BASE_PATH}/api-reference`;
@@ -10,7 +10,12 @@ export class ApiDocsConfigurationError extends TypeError {
         this.name = "ApiDocsConfigurationError";
     }
 }
-/** Installs the active OpenAPI document and the sole bundled Scalar reference UI. */
+/** Installs the active OpenAPI document and the sole bundled Scalar reference UI.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param plan - Validated application registration plan.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; registers the document and reference UI only when exposure is enabled.
+ */
 export function installApiDocs(app, plan, options = {}) {
     const mode = options.mode ?? "development";
     const enabled = mode === "production" ? options.enabledInProduction === true : options.enabled !== false;
@@ -24,6 +29,10 @@ export function installApiDocs(app, plan, options = {}) {
         ...(embed ? { content: canonicalJson(document) } : { url: "./openapi.json" }),
         pageTitle: "RELKIT API Reference",
     });
+    /** Require the configured inspector authorization before serving API documentation.
+     * @param handler - Document or reference-UI handler to run after authorization.
+     * @returns A handler yielding the protected response or a bearer-authentication challenge.
+     */
     const protect = (handler) => async (context, next) => {
         if (!(await isAuthorized(context.req.raw, auth))) {
             return jsonResponse({ error: "internal-endpoint-protected" }, 401, {
@@ -49,6 +58,10 @@ export function installApiDocs(app, plan, options = {}) {
         });
     }));
 }
+/** Builds the OpenAPI document from the registered application graph.
+ * @param plan - Validated application registration plan.
+ * @returns The generated OpenAPI document for valid function targets and raw routes.
+ */
 function documentFrom(plan) {
     const functions = new Set(plan.functions.map(({ id }) => id));
     return generateOpenApi({
@@ -61,12 +74,22 @@ function documentFrom(plan) {
         edges: [],
     });
 }
+/** Selects the configured API-document authorization policy.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The API-document bearer token and authorization callback in inspector option form.
+ */
 function authorization(options) {
     return {
         ...(options.bearerToken === undefined ? {} : { bearerToken: options.bearerToken }),
         ...(options.authorize === undefined ? {} : { authorize: options.authorize }),
     };
 }
+/** Checks API-document exposure configuration before routes are installed.
+ * @param mode - Configured runtime exposure or response-validation mode.
+ * @param enabled - Whether the feature is enabled by application configuration.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing for a valid exposure policy; invalid production protection or mode throws.
+ */
 function validate(mode, enabled, options) {
     if (!(mode === "development" || mode === "test" || mode === "production")) {
         throw new ApiDocsConfigurationError("mode must be development, test, or production.");
@@ -81,6 +104,10 @@ function validate(mode, enabled, options) {
         throw new ApiDocsConfigurationError("bearerToken must not be empty.");
     }
 }
+/** Builds response headers for the selected API-document representation.
+ * @param contentType - Media type advertised by the resulting response.
+ * @returns No-store headers containing the selected content type and RELKIT API version.
+ */
 function responseHeaders(contentType) {
     return {
         "cache-control": "no-store",
@@ -88,6 +115,11 @@ function responseHeaders(contentType) {
         "x-relkit-api-version": String(API_VERSION),
     };
 }
+/** Removes excluded service domains from the generated API document.
+ * @param document - Generated API document to project for public exposure.
+ * @param excluded - Service domains excluded from the published API document.
+ * @returns The document with excluded service operations and unused tags removed.
+ */
 function filterDomains(document, excluded = []) {
     if (excluded.length === 0 || !isRecord(document) || !isRecord(document.paths))
         return document;
@@ -122,6 +154,10 @@ function filterDomains(document, excluded = []) {
             : {}),
     };
 }
+/** Recognizes a non-null object before reading its named properties.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/api-docs.js.map

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

package/dist/api-docs.types.d.ts

@@ -0,0 +1,14 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { OpenApiDocument } from "@relkit/openapi";
+import type { InternalEndpointMode, InternalEndpointOptions } from "./internal-endpoints.js";
+/** api docs options configuring dependencies, callbacks and runtime policy. */
+export interface ApiDocsOptions {
+    readonly mode?: InternalEndpointMode;
+    readonly enabled?: boolean;
+    readonly enabledInProduction?: boolean;
+    readonly excludeDomains?: readonly string[];
+    readonly bearerToken?: string;
+    readonly authorize?: InternalEndpointOptions["authorize"];
+    readonly document?: OpenApiDocument | JsonValue;
+}
+//# sourceMappingURL=api-docs.types.d.ts.map

package/dist/api-docs.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs.types.d.ts","sourceRoot":"","sources":["../src/api-docs.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAE7F,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACjD"}

package/dist/api-docs.types.js

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

package/dist/api-docs.types.js.map

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

package/dist/auth.d.ts

@@ -1,20 +1,31 @@
+import { Context, Effect, Layer } from "effect";
 import type { Hono } from "hono";
-export interface HttpAuthInvocation {
-    readonly getSession: (options?: {
-        readonly fresh?: boolean;
-    }) => Promise<unknown | null>;
-}
-export interface HttpAuthRuntime {
-    readonly protected: readonly string[];
-    readonly publicPaths: readonly string[];
-    readonly contextFor: (request: Request) => HttpAuthInvocation;
-    readonly protects: (path: string) => boolean;
-}
-export interface CreateHttpAuthRuntimeOptions {
-    readonly protected: readonly string[];
-    readonly publicPaths: readonly string[];
-    readonly getSession: (headers: Headers) => Promise<unknown | null>;
+import type { CreateHttpAuthRuntimeOptions, HttpAuthRuntime } from "./auth.types.js";
+import { HttpBoundaryError } from "./http-effect.js";
+export type { CreateHttpAuthRuntimeOptions, HttpAuthInvocation, HttpAuthRuntime, } from "./auth.types.js";
+declare const HttpSession_base: Context.ServiceClass<HttpSession, "@relkit/runtime-hono/HttpSession", {
+    readonly get: (fresh: boolean) => Effect.Effect<unknown | null, HttpBoundaryError>;
+}>;
+/** One request's lazily memoized authentication session.
+ * @see tests/request-services.test.ts for checked concurrent lookup and explicit refresh.
+ */
+export declare class HttpSession extends HttpSession_base {
 }
+/** Captures request headers once and shares each lookup among concurrent readers.
+ * @param headers - Native or protocol headers available to this request.
+ * @param lookup - Foreign session lookup callback retained by the request-owned cache.
+ * @returns A layer sharing one lazy session lookup until an explicit refresh.
+ */
+export declare function httpSessionLayer(headers: Headers, lookup: CreateHttpAuthRuntimeOptions["getSession"]): Layer.Layer<HttpSession, never, never>;
+/** Creates request-scoped authentication contexts and shared session lookup state.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A frozen auth runtime with path policy and stable per-request session contexts.
+ */
 export declare function createHttpAuthRuntime(options: CreateHttpAuthRuntimeOptions): HttpAuthRuntime;
+/** Registers configured authentication middleware on its declared paths.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @returns Nothing; the declared authentication routes are installed.
+ */
 export declare function registerAuthMiddleware(app: Hono, auth: HttpAuthRuntime | undefined): void;
 //# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC1F;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,kBAAkB,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CAqB5F;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAoBzF"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EACV,4BAA4B,EAE5B,eAAe,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAgB,iBAAiB,EAAwB,MAAM,kBAAkB,CAAC;AACzF,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;;kBAQP,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,iBAAiB,CAAC;;AANtF;;GAEG;AACH,qBAAa,WAAY,SAAQ,gBAKM;CAAG;AAE1C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,4BAA4B,CAAC,YAAY,CAAC,0CAgBnD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CA4B5F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAoBzF"}

package/dist/auth.js

@@ -1,19 +1,51 @@
+import { Context, Effect, Layer } from "effect";
+import { httpBoundary, HttpBoundaryError, observeHttp, runHttp } from "./http-effect.js";
+/** One request's lazily memoized authentication session.
+ * @see tests/request-services.test.ts for checked concurrent lookup and explicit refresh.
+ */
+export class HttpSession extends Context.Service()("@relkit/runtime-hono/HttpSession") {
+}
+/** Captures request headers once and shares each lookup among concurrent readers.
+ * @param headers - Native or protocol headers available to this request.
+ * @param lookup - Foreign session lookup callback retained by the request-owned cache.
+ * @returns A layer sharing one lazy session lookup until an explicit refresh.
+ */
+export function httpSessionLayer(headers, lookup) {
+    const load = httpBoundary("auth.session", () => lookup(headers));
+    // Memo allocation is synchronous; constructing the layer does not call user code.
+    let cached = Effect.runSync(Effect.cached(load));
+    return Layer.succeed(HttpSession, {
+        get: Effect.fn("HttpSession.get")((fresh) => observeHttp("auth.session", Effect.gen(function* () {
+            if (fresh)
+                cached = yield* Effect.cached(load);
+            return yield* cached;
+        }))),
+    });
+}
+/** Creates request-scoped authentication contexts and shared session lookup state.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A frozen auth runtime with path policy and stable per-request session contexts.
+ */
 export function createHttpAuthRuntime(options) {
     const contexts = new WeakMap();
     return Object.freeze({
         protected: Object.freeze([...options.protected]),
         publicPaths: Object.freeze([...options.publicPaths]),
+        /** Returns the stable authentication context owned by one native request.
+         * @param request - Native request whose headers, body and cancellation signal define this operation.
+         * @returns The existing request context or a new context sharing a lazily cached session lookup.
+         */
         contextFor(request) {
             const existing = contexts.get(request);
             if (existing !== undefined)
                 return existing;
             const headers = new Headers(request.headers);
-            let session;
+            const layer = httpSessionLayer(headers, options.getSession);
             const context = Object.freeze({
                 getSession: (read = {}) => {
-                    if (read.fresh)
-                        session = undefined;
-                    return (session ??= Promise.resolve(options.getSession(headers)));
+                    return runHttp(Effect.gen(function* () {
+                        return yield* (yield* HttpSession).get(read.fresh === true);
+                    }).pipe(Effect.provide(layer)));
                 },
             });
             contexts.set(request, context);
@@ -22,6 +54,11 @@ export function createHttpAuthRuntime(options) {
         protects: (path) => options.protected.some((pattern) => matches(pattern, path)),
     });
 }
+/** Registers configured authentication middleware on its declared paths.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @returns Nothing; the declared authentication routes are installed.
+ */
 export function registerAuthMiddleware(app, auth) {
     if (auth === undefined)
         return;
@@ -39,6 +76,11 @@ export function registerAuthMiddleware(app, auth) {
         await next();
     });
 }
+/** Checks whether an authentication middleware pattern applies to the request path.
+ * @param pattern - Declared middleware path pattern.
+ * @param path - Ordered validation path or confined resource path.
+ * @returns Whether the value satisfies the required public contract.
+ */
 function matches(pattern, path) {
     if (pattern.endsWith("/*")) {
         return path === pattern.slice(0, -2) || path.startsWith(pattern.slice(0, -1));

package/dist/auth.js.map

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

package/dist/auth.types.d.ts

@@ -0,0 +1,20 @@
+/** Contract for http auth invocation used by auth. */
+export interface HttpAuthInvocation {
+    readonly getSession: (options?: {
+        readonly fresh?: boolean;
+    }) => Promise<unknown | null>;
+}
+/** Contract for http auth runtime used by auth. */
+export interface HttpAuthRuntime {
+    readonly protected: readonly string[];
+    readonly publicPaths: readonly string[];
+    readonly contextFor: (request: Request) => HttpAuthInvocation;
+    readonly protects: (path: string) => boolean;
+}
+/** create http auth runtime options configuring dependencies, callbacks and runtime policy. */
+export interface CreateHttpAuthRuntimeOptions {
+    readonly protected: readonly string[];
+    readonly publicPaths: readonly string[];
+    readonly getSession: (headers: Headers) => Promise<unknown | null>;
+}
+//# sourceMappingURL=auth.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.d.ts","sourceRoot":"","sources":["../src/auth.types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC1F;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,kBAAkB,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAED,+FAA+F;AAC/F,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACpE"}

package/dist/auth.types.js

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

package/dist/auth.types.js.map

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

package/dist/client-authorization.d.ts

@@ -1,2 +1,24 @@
+import { Context, Effect, Layer, Schema } from "effect";
+declare const ClientAuthorizationDenied_base: Schema.Class<ClientAuthorizationDenied, Schema.TaggedStruct<"ClientAuthorizationDenied", {
+    readonly resource: Schema.Literals<readonly ["agent", "channel"]>;
+}>, import("effect/Cause").YieldableError>;
+/** Concealed authorization failure; transport adapters choose the public error. */
+export declare class ClientAuthorizationDenied extends ClientAuthorizationDenied_base {
+}
+declare const ClientAuthorization_base: Context.ServiceClass<ClientAuthorization, "@relkit/runtime-hono/ClientAuthorization", {
+    readonly require: (authorize: () => boolean | PromiseLike<boolean>, resource: "agent" | "channel", timeoutMs: number) => Effect.Effect<void, ClientAuthorizationDenied>;
+}>;
+/** Evaluates a fresh policy for every request or observation frame. */
+export declare class ClientAuthorization extends ClientAuthorization_base {
+}
+/** Uses Effect's clock and interruption to bound user authorization callbacks. */
+export declare const ClientAuthorizationLive: Layer.Layer<ClientAuthorization, never, never>;
+/** Bounds an application authorization callback and returns a safe denial on rejection.
+ * @param authorize - authorize supplied by the caller.
+ * @param resource - Resource kind used to produce a safe authorization denial.
+ * @param timeoutMs - Maximum authorization or request duration in milliseconds.
+ * @returns A Promise resolving when authorized, otherwise rejecting with the concealed NOT_FOUND error.
+ */
 export declare function requireClientAuthorization(authorize: () => boolean | PromiseLike<boolean>, resource: "agent" | "channel", timeoutMs?: number): Promise<void>;
+export {};
 //# sourceMappingURL=client-authorization.d.ts.map

package/dist/client-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-authorization.d.ts","sourceRoot":"","sources":["../src/client-authorization.ts"],"names":[],"mappings":"AAEA,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAC/C,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"client-authorization.d.ts","sourceRoot":"","sources":["../src/client-authorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;AAGxD,mFAAmF;AACnF,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;;sBAMkB,CAChB,SAAS,EAAE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAC/C,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC;;AARvD,uEAAuE;AACvE,qBAAa,mBAAoB,SAAQ,wBASM;CAAG;AAElD,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,gDAoBlC,CAAC;AAEH;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAC/C,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/client-authorization.js

@@ -1,19 +1,33 @@
 import { ORPCError } from "@orpc/server";
+import { Context, Effect, Layer, Schema } from "effect";
+import { httpBoundary, observeHttp, runHttp } from "./http-effect.js";
+/** Concealed authorization failure; transport adapters choose the public error. */
+export class ClientAuthorizationDenied extends Schema.TaggedError()("ClientAuthorizationDenied", { resource: Schema.Literals(["agent", "channel"]) }) {
+}
+/** Evaluates a fresh policy for every request or observation frame. */
+export class ClientAuthorization extends Context.Service()("@relkit/runtime-hono/ClientAuthorization") {
+}
+/** Uses Effect's clock and interruption to bound user authorization callbacks. */
+export const ClientAuthorizationLive = Layer.succeed(ClientAuthorization, {
+    require: Effect.fn("ClientAuthorization.require")((authorize, resource, timeoutMs) => observeHttp("authorization.require", httpBoundary("authorization.policy", () => Promise.resolve().then(authorize)).pipe(Effect.timeout(timeoutMs), Effect.catch(() => Effect.succeed(false)), Effect.flatMap((allowed) => allowed === true
+        ? Effect.void
+        : Effect.fail(new ClientAuthorizationDenied({ resource })))))),
+});
+/** Bounds an application authorization callback and returns a safe denial on rejection.
+ * @param authorize - authorize supplied by the caller.
+ * @param resource - Resource kind used to produce a safe authorization denial.
+ * @param timeoutMs - Maximum authorization or request duration in milliseconds.
+ * @returns A Promise resolving when authorized, otherwise rejecting with the concealed NOT_FOUND error.
+ */
 export async function requireClientAuthorization(authorize, resource, timeoutMs = 10_000) {
-    let timer;
     try {
-        const timeout = new Promise((_, reject) => {
-            timer = setTimeout(() => reject(new Error("Authorization timed out.")), timeoutMs);
-        });
-        if ((await Promise.race([Promise.resolve().then(authorize), timeout])) === true)
-            return;
-    }
-    catch {
-    }
-    finally {
-        if (timer !== undefined)
-            clearTimeout(timer);
+        await runHttp(Effect.gen(function* () {
+            const authorization = yield* ClientAuthorization;
+            yield* authorization.require(authorize, resource, timeoutMs);
+        }).pipe(Effect.provide(ClientAuthorizationLive)));
+        return;
     }
+    catch { }
     throw new ORPCError("NOT_FOUND", {
         message: `${resource === "agent" ? "Agent" : "Channel"} resource was not found.`,
     });

package/dist/client-authorization.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-authorization.js","sourceRoot":"","sources":["../src/client-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAA+C,EAC/C,QAA6B,EAC7B,SAAS,GAAG,MAAM;IAElB,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO;IAC1F,CAAC;IAAC,MAAM,CAAC;IACT,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,WAAW,EAAE;QAC/B,OAAO,EAAE,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,0BAA0B;KACjF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"client-authorization.js","sourceRoot":"","sources":["../src/client-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEtE,mFAAmF;AACnF,MAAM,OAAO,yBAA0B,SAAQ,MAAM,CAAC,WAAW,EAA6B,CAC5F,2BAA2B,EAC3B,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,CACpD;CAAG;AAEJ,uEAAuE;AACvE,MAAM,OAAO,mBAAoB,SAAQ,OAAO,CAAC,OAAO,EASrD,CAAC,0CAA0C,CAAC;CAAG;AAElD,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE;IACxE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAC/C,CACE,SAA+C,EAC/C,QAA6B,EAC7B,SAAiB,EACjB,EAAE,CACF,WAAW,CACT,uBAAuB,EACvB,YAAY,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAChF,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EACzB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACzC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzB,OAAO,KAAK,IAAI;QACd,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAC7D,CACF,CACF,CACJ;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAA+C,EAC/C,QAA6B,EAC7B,SAAS,GAAG,MAAM;IAElB,IAAI,CAAC;QACH,MAAM,OAAO,CACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;YACjD,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CACjD,CAAC;QACF,OAAO;IACT,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,MAAM,IAAI,SAAS,CAAC,WAAW,EAAE;QAC/B,OAAO,EAAE,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,0BAA0B;KACjF,CAAC,CAAC;AACL,CAAC"}