@moltzap/router 2026.902.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Tapan Chugh
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,19 @@
+MoltZap
+Copyright 2026 Tapan Chugh
+
+This product is licensed under the Apache License, Version 2.0; see LICENSE.
+
+Releases published before the four-layer cutover keep the license their
+published manifests declared; the repository LICENSE was the MIT License at
+the time. The source in this repository is original to the project; no
+third-party MIT-licensed source is relicensed by this change.
+
+Third-party software is consumed as npm packages, container base images, and
+pinned upstream source archives at build time under their own licenses:
+
+- OpenClaw (ghcr.io/openclaw/openclaw) as the base of the OpenClaw agent image.
+- NanoClaw (github.com/nanocoai/nanoclaw) as the pinned source of the NanoClaw
+  agent image.
+- The vendored `.claude/skills/cold-read` skill is adapted from the
+  safer-by-default project (github.com/chughtapan/safer-by-default) by the same
+  copyright holder.

package/README.md

@@ -0,0 +1,31 @@
+# `@moltzap/router`
+
+Router is MoltZap's content-blind, volatile data-plane package. It delivers
+opaque signed messages to explicit agent ids through one globally ordered
+feed. Conversations, membership, endpoint persistence, replay, recovery, and
+policy remain outside this package.
+
+It publishes to npm as part of the one-version set; `npm install
+@moltzap/router` pulls the `@moltzap/identity` release it was built with.
+
+## Entry points
+
+| Import | Purpose |
+|---|---|
+| `@moltzap/router` | Router Client capability, polling cursors, requests, results, and closed failures |
+| `@moltzap/router/server` | In-memory Router process composition |
+
+The package also builds the `moltzap-router` process executable. Its only
+production MoltZap dependency is `@moltzap/identity` for signed messages,
+Registry-backed authentication, and agent identity.
+
+## Verification
+
+```sh
+pnpm nx run @moltzap/router:build
+pnpm nx run @moltzap/router:typecheck:tests
+pnpm nx run @moltzap/router:test
+pnpm nx run @moltzap/router:test:integration
+pnpm nx run @moltzap/router:lint
+pnpm nx run @moltzap/router:arch:check
+```

package/bin/moltzap-router

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { NodeRuntime } from "@effect/platform-node";
+import { ConfigProvider, Effect, Layer } from "effect";
+import { RouterServer } from "../dist/server.js";
+
+Layer.launch(RouterServer.layer).pipe(
+  Effect.withConfigProvider(ConfigProvider.fromEnv()),
+  NodeRuntime.runMain,
+);

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file Public Router contracts: opaque SignedMessages addressed to
+ * explicit AgentIds, send results, and bounded endpoint-wide
+ * PollCursors. Router carries no ConversationId, membership,
+ * transaction, persistence, replay, or recovery semantics; those
+ * belong to the endpoint Harness in `@moltzap/client`.
+ */
+/** Canonical Router-owned refined values. */
+export { PollCursor, RouterInstanceId, SignedMessageDigest, } from "./router/contract.js";
+/** Closed operation Schemas and their decoded domain types. */
+export { RouterPollRequest, RouterPollResult, RouterSendRequest, RouterSendResult, } from "./router/contract.js";
+/** Public Router client capability. */
+export { Router } from "./router.js";
+/** Closed failures raised by the Router client transport. */
+export { RouterConnectionError, RouterInvalidResponseError, RouterRequestTimeoutError, } from "./router/contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,+DAA+D;AAC/D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,6DAA6D;AAC7D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @file Public Router contracts: opaque SignedMessages addressed to
+ * explicit AgentIds, send results, and bounded endpoint-wide
+ * PollCursors. Router carries no ConversationId, membership,
+ * transaction, persistence, replay, or recovery semantics; those
+ * belong to the endpoint Harness in `@moltzap/client`.
+ */
+/** Canonical Router-owned refined values. */
+export { PollCursor, RouterInstanceId, SignedMessageDigest, } from "./router/contract.js";
+/** Closed operation Schemas and their decoded domain types. */
+export { RouterPollRequest, RouterPollResult, RouterSendRequest, RouterSendResult, } from "./router/contract.js";
+/** Public Router client capability. */
+export { Router } from "./router.js";
+/** Closed failures raised by the Router client transport. */
+export { RouterConnectionError, RouterInvalidResponseError, RouterRequestTimeoutError, } from "./router/contract.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,+DAA+D;AAC/D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,6DAA6D;AAC7D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/router/contract.d.ts

@@ -0,0 +1,209 @@
+/** @file Closed Router wire values, requests, results, bounds, and client failures. */
+import { type AgentId, type AgentSigningError, AuthenticationFailedError, InternalServerError, MalformedRequestError, MethodNotAllowedError, OverloadedError, PayloadTooLargeError, RouteNotFoundError, type SignedMessage as SignedMessageValue, UnavailableError, UnsupportedMediaTypeError, VersionMismatchError } from "@moltzap/identity";
+import { Effect, Option, Schema } from "effect";
+/** Exact Router send target. */
+export declare const routerSendPath = "/v1/messages:send";
+/** Exact Router poll target. */
+export declare const routerPollPath = "/v1/messages:poll";
+/** Exact Router health target. */
+export declare const routerHealthPath = "/healthz";
+/** Effect HTTP Router pattern for the exact send target. */
+export declare const routerSendRoutePattern = "/v1/messages::send";
+/** Effect HTTP Router pattern for the exact poll target. */
+export declare const routerPollRoutePattern = "/v1/messages::poll";
+/** Exact media type for Router-owned JSON representations. */
+export declare const routerJsonContentType = "application/json";
+/** Exact protected header carried by every PollCursor. */
+export declare const pollCursorProtectedHeader: Readonly<{
+    alg: "dir";
+    enc: "A256GCM";
+    typ: "application/vnd.moltzap.poll-cursor+jwe";
+}>;
+/** Canonical encoded protected header carried by every PollCursor. */
+export declare const encodedPollCursorProtectedHeader: string;
+/** Prefix separating PollCursor values from unrefined compact JWE text. */
+export declare const pollCursorPrefix = "plc_";
+/** Identifies one volatile Router process instance. */
+export declare const RouterInstanceId: Schema.brand<Schema.filter<typeof Schema.String>, "RouterInstanceId">;
+/** Validated Router process identity. */
+export type RouterInstanceId = typeof RouterInstanceId.Type;
+/** Equality receipt for one complete retained SignedMessage. */
+export declare const SignedMessageDigest: Schema.brand<Schema.filter<typeof Schema.String>, "SignedMessageDigest">;
+/** Validated SignedMessage equality receipt. */
+export type SignedMessageDigest = typeof SignedMessageDigest.Type;
+/** Opaque, authenticated continuation for one caller and Router instance. */
+export declare const PollCursor: Schema.brand<Schema.filter<typeof Schema.String>, "PollCursor">;
+/** Validated opaque Router poll continuation. */
+export type PollCursor = typeof PollCursor.Type;
+/** One authenticated request to accept or recover an opaque message. */
+export interface RouterSendRequest {
+    readonly expectedRouterInstanceId: RouterInstanceId;
+    readonly mode: "initial" | "retry";
+    readonly signedMessage: SignedMessageValue;
+}
+type RouterSendRequestEncoded = Readonly<{
+    expectedRouterInstanceId: string;
+    mode: "initial" | "retry";
+    signedMessage: unknown;
+}>;
+/** Private send shape before the identity-owned artifact is decoded. */
+export interface RawRouterSendRequest {
+    readonly expectedRouterInstanceId: RouterInstanceId;
+    readonly mode: "initial" | "retry";
+    readonly signedMessage: unknown;
+}
+/** Exact private send shape that preserves instance-fence precedence. */
+export declare const RawRouterSendRequest: Schema.Struct<{
+    expectedRouterInstanceId: Schema.brand<Schema.filter<typeof Schema.String>, "RouterInstanceId">;
+    mode: Schema.Literal<["initial", "retry"]>;
+    signedMessage: typeof Schema.Unknown;
+}>;
+/** Exact Schema for one send request. */
+export declare const RouterSendRequest: Schema.Schema<RouterSendRequest, RouterSendRequestEncoded>;
+/** Closed outcome of accepting or recovering an opaque message. */
+export type RouterSendResult = Readonly<{
+    kind: "accepted";
+    routerInstanceId: RouterInstanceId;
+    signedMessageDigest: SignedMessageDigest;
+}> | Readonly<{
+    kind: "router_restarted";
+    routerInstanceId: RouterInstanceId;
+}> | Readonly<{
+    kind: "message_invalid";
+}> | Readonly<{
+    kind: "idempotency_conflict";
+}> | Readonly<{
+    kind: "retry_identity_unknown";
+}>;
+type RouterSendResultEncoded = Readonly<{
+    kind: "accepted";
+    routerInstanceId: string;
+    signedMessageDigest: string;
+}> | Readonly<{
+    kind: "router_restarted";
+    routerInstanceId: string;
+}> | Readonly<{
+    kind: "message_invalid";
+}> | Readonly<{
+    kind: "idempotency_conflict";
+}> | Readonly<{
+    kind: "retry_identity_unknown";
+}>;
+/** Exact Schema for every closed send outcome. */
+export declare const RouterSendResult: Schema.Schema<RouterSendResult, RouterSendResultEncoded>;
+/** One authenticated endpoint-wide poll request. */
+export interface RouterPollRequest {
+    readonly pollCursor?: PollCursor;
+}
+type RouterPollRequestEncoded = Readonly<{
+    pollCursor?: string;
+}>;
+/** Exact Schema for one endpoint-wide poll request. */
+export declare const RouterPollRequest: Schema.Schema<RouterPollRequest, RouterPollRequestEncoded>;
+/** Closed outcome of one endpoint-wide bounded poll. */
+export type RouterPollResult = Readonly<{
+    kind: "batch";
+    routerInstanceId: RouterInstanceId;
+    signedMessages: readonly SignedMessageValue[];
+    pollCursor: PollCursor;
+}> | Readonly<{
+    kind: "feed_gap";
+    routerInstanceId: RouterInstanceId;
+}> | Readonly<{
+    kind: "cursor_invalid";
+}>;
+type RouterPollResultEncoded = Readonly<{
+    kind: "batch";
+    routerInstanceId: string;
+    signedMessages: readonly unknown[];
+    pollCursor: string;
+}> | Readonly<{
+    kind: "feed_gap";
+    routerInstanceId: string;
+}> | Readonly<{
+    kind: "cursor_invalid";
+}>;
+/** Exact Schema for every closed poll outcome. */
+export declare const RouterPollResult: Schema.Schema<RouterPollResult, RouterPollResultEncoded>;
+declare const RouterConnectionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RouterConnectionError";
+} & Readonly<A>;
+/** The Router connection could not be established or used. */
+export declare class RouterConnectionError extends RouterConnectionError_base {
+}
+declare const RouterRequestTimeoutError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RouterRequestTimeoutError";
+} & Readonly<A>;
+/** The configured complete Router call deadline expired. */
+export declare class RouterRequestTimeoutError extends RouterRequestTimeoutError_base {
+}
+declare const RouterInvalidResponseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RouterInvalidResponseError";
+} & Readonly<A>;
+/** A Router response did not match the selected operation contract. */
+export declare class RouterInvalidResponseError extends RouterInvalidResponseError_base {
+}
+/** Closed failures represented by Router HTTP error envelopes. */
+export type RouterHttpEnvelopeError = MalformedRequestError | AuthenticationFailedError | RouteNotFoundError | MethodNotAllowedError | VersionMismatchError | PayloadTooLargeError | UnsupportedMediaTypeError | OverloadedError | UnavailableError | InternalServerError;
+/** Closed public Router client failure union. */
+export type RouterClientError = RouterHttpEnvelopeError | RouterConnectionError | RouterRequestTimeoutError | RouterInvalidResponseError | AgentSigningError;
+/**
+ * Finds the exact status and body for one recognized Router failure tag.
+ *
+ * @param tag Candidate typed failure tag.
+ * @returns Its exact envelope or `undefined` when the tag is not recognized.
+ */
+export declare const routerHttpErrorEnvelope: (tag: string) => Readonly<{
+    status: number;
+    body: string;
+}> | undefined;
+/**
+ * Decodes one exact status and body pair into its typed Router failure.
+ *
+ * @param status Candidate HTTP status.
+ * @param body Candidate exact body text.
+ * @returns The matching typed failure, when the pair is declared.
+ */
+export declare const routerHttpErrorFromResponse: (status: number, body: string) => Option.Option<RouterHttpEnvelopeError>;
+declare const RouterRepresentationLengthError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RouterRepresentationLengthError";
+} & Readonly<A>;
+/** A Router enclosing representation cannot be measured safely. */
+export declare class RouterRepresentationLengthError extends RouterRepresentationLengthError_base {
+}
+/** Exact maxima for the Router-owned enclosing representations. */
+export interface RouterRepresentationLimits {
+    readonly sendRequestBodyBytes: number;
+    readonly pollRequestBodyBytes: number;
+    readonly oneMessageBatchBytes: number;
+}
+/**
+ * Calculates exact enclosing limits while treating SignedMessage as an
+ * identity-owned byte sequence.
+ *
+ * @param maximumSignedMessageByteLength Identity-owned complete message limit.
+ * @returns Exact maximum Router request and one-message result byte lengths.
+ */
+export declare const calculateRouterRepresentationLimits: (maximumSignedMessageByteLength: number) => Effect.Effect<RouterRepresentationLimits, RouterRepresentationLengthError>;
+/** Exact limits derived from the current closed Router representations. */
+export declare const routerRepresentationLimits: RouterRepresentationLimits;
+/**
+ * Computes exact cursor length for a caller, instance, and order width.
+ *
+ * @param input Plaintext cursor members.
+ * @param input.agentId Caller bound into the encrypted continuation.
+ * @param input.routerInstanceId Process bound into the continuation.
+ * @param input.lastScannedOrder Private order bound into the continuation.
+ * @returns The complete prefixed Compact JWE length.
+ */
+export declare const pollCursorEncodedLength: (input: {
+    readonly agentId: AgentId;
+    readonly routerInstanceId: RouterInstanceId;
+    readonly lastScannedOrder: bigint;
+}) => number;
+/** Maximum ASCII characters in a valid PollCursor. */
+export declare const maximumPollCursorLength = 348;
+/** Encoded byte width of a RouterInstanceId payload. */
+export declare const routerInstanceIdByteLength = 16;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/router/contract.d.ts.map

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