@labacacia/nps-sdk 1.0.0-alpha.1 → 1.0.0-alpha.13

package/doc/overview.cn.md

@@ -0,0 +1,149 @@
+[English Version](./overview.md) | 中文版
+
+# `@labacacia/nps-sdk` — API 参考总览
+
+[![npm](https://img.shields.io/npm/v/@labacacia/nps-sdk)](https://www.npmjs.com/package/@labacacia/nps-sdk)
+
+NPS TypeScript SDK 是 .NET 参考实现的双格式（ESM + CJS）移植。本文档是
+各模块 API 参考的入口 —— 每个协议有独立文件，见下。
+
+---
+
+## 包结构
+
+```
+@labacacia/nps-sdk
+├── /           # 根：VERSION、createDefaultRegistry、createFullRegistry
+├── /core       # 线缆原语：FrameHeader、编解码、AnchorFrame 缓存、错误
+├── /ncp        # NCP 帧 + 握手 + 流管理
+├── /nwp        # NWP 帧 + 异步 NwpClient
+├── /nip        # NIP 帧 + NipIdentity（Ed25519）
+├── /ndp        # NDP 帧 + InMemoryNdpRegistry + 验证器
+└── /nop        # NOP 帧 + TaskDag 模型 + NopClient
+```
+
+## 参考文档
+
+| 子路径 | 模块 | 参考文档 |
+|--------|------|----------|
+| —                        | 根辅助函数与注册表工厂      | 本文件 |
+| `@labacacia/nps-sdk/core` | 帧头、编解码、AnchorFrame 缓存、异常 | [`nps-sdk.core.cn.md`](./nps-sdk.core.cn.md) |
+| `@labacacia/nps-sdk/ncp`  | NCP 帧集（`AnchorFrame`、`DiffFrame`、`StreamFrame`、`CapsFrame`、`ErrorFrame`、`HelloFrame`） | [`nps-sdk.ncp.cn.md`](./nps-sdk.ncp.cn.md) |
+| `@labacacia/nps-sdk/nwp`  | `QueryFrame`、`ActionFrame`、`NwpClient` | [`nps-sdk.nwp.cn.md`](./nps-sdk.nwp.cn.md) |
+| `@labacacia/nps-sdk/nip`  | `IdentFrame`、`TrustFrame`、`RevokeFrame`、`NipIdentity` | [`nps-sdk.nip.cn.md`](./nps-sdk.nip.cn.md) |
+| `@labacacia/nps-sdk/ndp`  | `AnnounceFrame`、`ResolveFrame`、`GraphFrame`、注册表、验证器 | [`nps-sdk.ndp.cn.md`](./nps-sdk.ndp.cn.md) |
+| `@labacacia/nps-sdk/nop`  | Task DAG、`TaskFrame`、`DelegateFrame`、`SyncFrame`、`AlignStreamFrame`、`NopClient` | [`nps-sdk.nop.cn.md`](./nps-sdk.nop.cn.md) |
+
+---
+
+## 安装
+
+```bash
+npm install @labacacia/nps-sdk
+```
+
+要求 **Node.js 18+**（Web Crypto）或支持原生 `crypto.subtle` 的
+现代浏览器。
+
+---
+
+## 根模块
+
+```typescript
+import { VERSION, createDefaultRegistry, createFullRegistry } from "@labacacia/nps-sdk";
+```
+
+- `VERSION` —— SDK 版本常量。
+- `createDefaultRegistry()` —— 只含 NCP 帧（`ANCHOR`、`DIFF`、`STREAM`、`CAPS`、`ERROR`）的新 `FrameRegistry`。
+- `createFullRegistry()` —— 预注册全部五个协议（NCP + NWP + NIP + NDP + NOP）的新 `FrameRegistry`。
+  解码任意帧时使用这个。
+
+```typescript
+const registry = createFullRegistry();
+```
+
+---
+
+## 最小端到端示例
+
+```typescript
+import { NwpClient, QueryFrame, ActionFrame } from "@labacacia/nps-sdk/nwp";
+
+const client = new NwpClient("http://node.example.com:17433");
+
+// 分页查询
+const caps = await client.query(
+  new QueryFrame("sha256:<anchor-id>", { active: true }, 50),
+);
+console.log(caps.count, caps.data);
+
+// 流式查询
+for await (const chunk of client.stream(new QueryFrame("sha256:<anchor-id>"))) {
+  console.log(chunk.seq, chunk.data);
+  if (chunk.isLast) break;
+}
+
+// Action 调用
+const result = await client.invoke(
+  new ActionFrame("summarise", { maxTokens: 500 }),
+);
+```
+
+---
+
+## 编码分层
+
+每个帧都有 `preferredTier`。MsgPack 是生产默认；JSON Tier
+留给诊断。
+
+| Tier | `EncodingTier` 值 | 说明 |
+|------|---------------------|------|
+| Tier-1 JSON    | `0x00` | UTF-8 JSON。开发与兼容。 |
+| Tier-2 MsgPack | `0x01` | MessagePack 二进制。**生产默认** —— 约小 60%。 |
+
+```typescript
+import { EncodingTier } from "@labacacia/nps-sdk/core";
+import { NpsFrameCodec } from "@labacacia/nps-sdk/core";
+
+const codec = new NpsFrameCodec(createFullRegistry());
+const wire  = codec.encode(frame, { overrideTier: EncodingTier.JSON });
+```
+
+---
+
+## 异步约定
+
+- 所有面向网络的客户端（`NwpClient`、`NopClient`）返回 `Promise<T>`。
+- 流式使用 `AsyncGenerator<StreamFrame>` —— 用
+  `for await (const chunk of …) { … }` 消费。
+- 客户端 **无需** 显式 dispose —— 底层 `fetch` 拥有连接生命周期。
+
+---
+
+## 错误层级
+
+```
+Error
+└── NpsError                       来自 "@labacacia/nps-sdk/core"
+    ├── NpsFrameError              —— 帧头解析 / 结构错误
+    ├── NpsCodecError              —— 编解码失败
+    ├── NpsAnchorNotFoundError     —— AnchorFrame 不在缓存
+    ├── NpsAnchorPoisonError       —— anchor_id / schema 不一致
+    └── NpsStreamError             —— 流序号跳跃 / 未知流 id
+```
+
+`NcpError`（来自 `@labacacia/nps-sdk/core`）是一个独立的协议级错误，
+携带机器可读的 `code`（如 `NCP-ANCHOR-NOT-FOUND`、
+`NCP-STREAM-SEQ-GAP`）。
+
+---
+
+## 参考规范
+
+| 模块 | 规范 |
+|------|------|
+| `core` + `ncp` | [NPS-1 NCP v0.7](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-1-NCP.cn.md) |
+| `nwp`          | [NPS-2 NWP v0.13](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-2-NWP.cn.md) |
+| `nip`          | [NPS-3 NIP v0.9](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-3-NIP.cn.md) |
+| `ndp`          | [NPS-4 NDP v0.8](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-4-NDP.cn.md) |
+| `nop`          | [NPS-5 NOP v0.6](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-5-NOP.cn.md) |

package/doc/overview.md

@@ -0,0 +1,153 @@
+English | [中文版](./overview.cn.md)
+
+# `@labacacia/nps-sdk` — API Reference Overview
+
+[![npm](https://img.shields.io/npm/v/@labacacia/nps-sdk)](https://www.npmjs.com/package/@labacacia/nps-sdk)
+
+The NPS TypeScript SDK is a dual-format (ESM + CJS) port of the .NET reference
+implementation. This document is the entry point for the per-module API
+references — each protocol has its own file below.
+
+---
+
+## Package layout
+
+```
+@labacacia/nps-sdk
+├── /           # root: VERSION, createDefaultRegistry, createFullRegistry
+├── /core       # Wire primitives: FrameHeader, codecs, AnchorCache, errors
+├── /ncp        # NCP frames + handshake + stream manager
+├── /nwp        # NWP frames + async NwpClient
+├── /nip        # NIP frames + NipIdentity (Ed25519)
+├── /ndp        # NDP frames + InMemoryNdpRegistry + validator
+└── /nop        # NOP frames + TaskDag model + NopClient
+```
+
+## Reference documents
+
+| Subpath | Module | Reference |
+|---------|--------|-----------|
+| —                       | Root helpers & registry factories     | this file |
+| `@labacacia/nps-sdk/core` | Frame header, codec, anchor cache, exceptions | [`nps-sdk.core.md`](./nps-sdk.core.md) |
+| `@labacacia/nps-sdk/ncp`  | NCP frame set (`AnchorFrame`, `DiffFrame`, `StreamFrame`, `CapsFrame`, `ErrorFrame`, `HelloFrame`) | [`nps-sdk.ncp.md`](./nps-sdk.ncp.md) |
+| `@labacacia/nps-sdk/nwp`  | `QueryFrame`, `ActionFrame`, `NwpClient` | [`nps-sdk.nwp.md`](./nps-sdk.nwp.md) |
+| `@labacacia/nps-sdk/nip`  | `IdentFrame`, `TrustFrame`, `RevokeFrame`, `NipIdentity` | [`nps-sdk.nip.md`](./nps-sdk.nip.md) |
+| `@labacacia/nps-sdk/ndp`  | `AnnounceFrame`, `ResolveFrame`, `GraphFrame`, registry, validator | [`nps-sdk.ndp.md`](./nps-sdk.ndp.md) |
+| `@labacacia/nps-sdk/nop`  | Task DAG, `TaskFrame`, `DelegateFrame`, `SyncFrame`, `AlignStreamFrame`, `NopClient` | [`nps-sdk.nop.md`](./nps-sdk.nop.md) |
+
+---
+
+## Install
+
+```bash
+npm install @labacacia/nps-sdk
+```
+
+Requires **Node.js 18+** (for Web Crypto) or a modern browser with native
+`crypto.subtle`.
+
+---
+
+## Root module
+
+```typescript
+import { VERSION, createDefaultRegistry, createFullRegistry } from "@labacacia/nps-sdk";
+```
+
+- `VERSION` — SDK version constant.
+- `createDefaultRegistry()` — new `FrameRegistry` with NCP frames only
+  (`ANCHOR`, `DIFF`, `STREAM`, `CAPS`, `ERROR`).
+- `createFullRegistry()` — new `FrameRegistry` with all five protocols
+  (NCP + NWP + NIP + NDP + NOP) pre-registered. Use this when decoding
+  arbitrary frames.
+
+```typescript
+const registry = createFullRegistry();
+```
+
+---
+
+## Minimal end-to-end example
+
+```typescript
+import { NwpClient, QueryFrame, ActionFrame } from "@labacacia/nps-sdk/nwp";
+
+const client = new NwpClient("http://node.example.com:17433");
+
+// Paginated query
+const caps = await client.query(
+  new QueryFrame("sha256:<anchor-id>", { active: true }, 50),
+);
+console.log(caps.count, caps.data);
+
+// Streaming query
+for await (const chunk of client.stream(new QueryFrame("sha256:<anchor-id>"))) {
+  console.log(chunk.seq, chunk.data);
+  if (chunk.isLast) break;
+}
+
+// Action invocation
+const result = await client.invoke(
+  new ActionFrame("summarise", { maxTokens: 500 }),
+);
+```
+
+---
+
+## Encoding tiers
+
+Every frame has a `preferredTier`. MsgPack is the production default; JSON
+tier stays available for diagnostics.
+
+| Tier | `EncodingTier` value | Description |
+|------|---------------------|-------------|
+| Tier-1 JSON    | `0x00` | UTF-8 JSON. Development & compatibility. |
+| Tier-2 MsgPack | `0x01` | MessagePack binary. **Production default** — ~60% smaller. |
+
+```typescript
+import { EncodingTier } from "@labacacia/nps-sdk/core";
+import { NpsFrameCodec } from "@labacacia/nps-sdk/core";
+
+const codec = new NpsFrameCodec(createFullRegistry());
+const wire  = codec.encode(frame, { overrideTier: EncodingTier.JSON });
+```
+
+---
+
+## Async conventions
+
+- All network-facing clients (`NwpClient`, `NopClient`) return `Promise<T>`.
+- Streaming uses `AsyncGenerator<StreamFrame>` — consume with
+  `for await (const chunk of …) { … }`.
+- Clients do **not** require explicit dispose — the underlying `fetch`
+  owns connection lifecycle.
+
+---
+
+## Error hierarchy
+
+```
+Error
+└── NpsError                       from "@labacacia/nps-sdk/core"
+    ├── NpsFrameError              — header parse / structural error
+    ├── NpsCodecError              — encode/decode failure
+    ├── NpsAnchorNotFoundError     — anchor not in cache
+    ├── NpsAnchorPoisonError       — anchor_id / schema mismatch
+    └── NpsStreamError             — stream seq gap / unknown stream id
+```
+
+`NcpError` (from `@labacacia/nps-sdk/core`) is a separate protocol-level
+error carrying a machine-readable `code` (e.g. `NCP-ANCHOR-NOT-FOUND`,
+`NCP-STREAM-SEQ-GAP`).
+
+---
+
+## Reference specs
+
+| Module | Spec |
+|--------|------|
+| `core` + `ncp` | [NPS-1 NCP v0.7](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-1-NCP.md) |
+| `nwp`          | [NPS-2 NWP v0.13](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-2-NWP.md) |
+| `nip`          | [NPS-3 NIP v0.9](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-3-NIP.md) |
+| `ndp`          | [NPS-4 NDP v0.8](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-4-NDP.md) |
+| `nop`          | [NPS-5 NOP v0.6](https://github.com/labacacia/NPS-Release/blob/main/spec/NPS-5-NOP.md) |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@labacacia/nps-sdk",
-  "version": "1.0.0-alpha.1",
-  "description": "TypeScript SDK for the Neural Protocol Suite (NPS)",
+  "version": "1.0.0-alpha.13",
+  "description": "TypeScript SDK for the Neural Protocol Suite (NPS) — NCP, NWP, NIP, NDP, NOP",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,18 +17,44 @@
     "./ncp": {
       "import": "./dist/ncp/index.js",
       "types": "./dist/ncp/index.d.ts"
+    },
+    "./nwp": {
+      "import": "./dist/nwp/index.js",
+      "types": "./dist/nwp/index.d.ts"
+    },
+    "./nip": {
+      "import": "./dist/nip/index.js",
+      "types": "./dist/nip/index.d.ts"
+    },
+    "./ndp": {
+      "import": "./dist/ndp/index.js",
+      "types": "./dist/ndp/index.d.ts"
+    },
+    "./nop": {
+      "import": "./dist/nop/index.js",
+      "types": "./dist/nop/index.d.ts"
     }
   },
   "scripts": {
     "build": "tsc",
+    "prepack": "npm run build && node scripts/verify-pack.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   },
+  "files": [
+    "dist/",
+    "doc/",
+    "README.md",
+    "README.cn.md",
+    "CHANGELOG.md",
+    "CHANGELOG.cn.md",
+    "LICENSE",
+    "NOTICE"
+  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/labacacia/nps.git",
-    "directory": "impl/typescript"
+    "url": "https://github.com/labacacia/NPS-sdk-ts.git"
   },
   "license": "Apache-2.0",
   "engines": {
@@ -36,6 +62,9 @@
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.0.0",
+    "@noble/ed25519": "^2.1.0",
+    "@noble/hashes": "^1.4.0",
+    "@peculiar/x509": "^1.12.0",
     "canonicalize": "^2.0.0",
     "fast-json-patch": "^3.1.1"
   },

package/CONTRIBUTING.md

@@ -1,33 +0,0 @@
-# Contributing to NPS
-
-Thank you for your interest in contributing to the Neural Protocol Suite.
-
-## Issue Prefixes
-
-| Prefix | Usage |
-|--------|-------|
-| `spec:` | Specification questions and design discussions |
-| `impl:` | Implementation bugs and fixes |
-| `sdk:`  | SDK (Python / TypeScript) related |
-| `docs:` | Documentation improvements |
-
-## Workflow
-
-1. Open an Issue first for any non-trivial change
-2. Fork the repo and create a branch: `feature/your-feature` or `fix/your-fix`
-3. Submit a Pull Request referencing the Issue
-
-## Spec Changes
-
-Changes to files under `spec/` require a discussion Issue before a PR is accepted.
-Spec changes that affect wire format or frame structure require a version bump.
-
-## Code Style
-
-- **C# / .NET**: Follow standard Microsoft C# conventions, nullable enabled
-- **Python**: PEP 8, type hints required
-- **TypeScript**: Strict mode enabled
-
-## License
-
-By contributing, you agree your contributions will be licensed under Apache 2.0.

package/dist/codec-CmHeovTV.d.cts

@@ -1,120 +0,0 @@
-/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
-declare enum FrameType {
-    ANCHOR = 1,
-    DIFF = 2,
-    STREAM = 3,
-    CAPS = 4,
-    ALIGN = 5,// deprecated — use AlignStream (0x43)
-    QUERY = 16,
-    ACTION = 17,
-    IDENT = 32,
-    TRUST = 33,
-    REVOKE = 34,
-    ANNOUNCE = 48,
-    RESOLVE = 49,
-    GRAPH = 50,
-    TASK = 64,
-    DELEGATE = 65,
-    SYNC = 66,
-    ALIGN_STREAM = 67,
-    ERROR = 254
-}
-/**
- * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
- * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
- * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
- */
-declare enum EncodingTier {
-    JSON = 0,
-    MSGPACK = 1
-}
-/**
- * Flags byte in the NPS frame header (NPS-1 §3.2).
- * Bit layout (LSB = bit 0):
- *   Bits 0–1 (T0,T1) : Encoding tier
- *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
- *   Bit 3  (ENC)     : Payload encrypted
- *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
- *   Bit 7  (EXT)     : Extended 8-byte header
- */
-declare const FrameFlags: {
-    readonly NONE: 0;
-    readonly TIER1_JSON: 0;
-    readonly TIER2_MSGPACK: 1;
-    readonly FINAL: 4;
-    readonly ENCRYPTED: 8;
-    readonly EXT: 128;
-};
-declare const DEFAULT_HEADER_SIZE = 4;
-declare const EXTENDED_HEADER_SIZE = 8;
-declare const DEFAULT_MAX_PAYLOAD = 65535;
-declare const EXTENDED_MAX_PAYLOAD = 4294967295;
-/**
- * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
- *
- * Default (4 bytes, EXT=0):
- *   Byte 0   : FrameType
- *   Byte 1   : Flags
- *   Byte 2–3 : PayloadLength (big-endian uint16)
- *
- * Extended (8 bytes, EXT=1):
- *   Byte 0   : FrameType
- *   Byte 1   : Flags (bit 7 = 1)
- *   Byte 2–3 : Reserved (must be 0)
- *   Byte 4–7 : PayloadLength (big-endian uint32)
- */
-declare class FrameHeader {
-    readonly frameType: FrameType;
-    readonly flags: number;
-    readonly payloadLength: number;
-    constructor(frameType: FrameType, flags: number, payloadLength: number);
-    get isExtended(): boolean;
-    get headerSize(): number;
-    get encodingTier(): EncodingTier;
-    get isFinal(): boolean;
-    get isEncrypted(): boolean;
-    static parse(buf: Uint8Array): FrameHeader;
-    toBytes(): Uint8Array;
-    toString(): string;
-}
-
-interface FrameClass {
-    fromDict(data: Record<string, unknown>): NpsFrame;
-}
-declare class FrameRegistry {
-    private readonly _map;
-    register(frameType: FrameType, cls: FrameClass): void;
-    resolve(frameType: FrameType): FrameClass;
-}
-
-interface NpsFrame {
-    readonly frameType: FrameType;
-    readonly preferredTier: EncodingTier;
-    toDict(): Record<string, unknown>;
-}
-declare class Tier1JsonCodec {
-    encode(frame: NpsFrame): Uint8Array;
-    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
-}
-declare class Tier2MsgPackCodec {
-    encode(frame: NpsFrame): Uint8Array;
-    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
-}
-declare class NpsFrameCodec {
-    private readonly _registry;
-    private readonly _maxPayload;
-    private readonly _json;
-    private readonly _msgpack;
-    constructor(registry: FrameRegistry, options?: {
-        maxPayload?: number;
-    });
-    encode(frame: NpsFrame, options?: {
-        overrideTier?: EncodingTier;
-    }): Uint8Array;
-    decode(wire: Uint8Array): NpsFrame;
-    static peekHeader(wire: Uint8Array): FrameHeader;
-    private _buildFlags;
-    private _selectCodec;
-}
-
-export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };

package/dist/codec-CmHeovTV.d.ts

@@ -1,120 +0,0 @@
-/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
-declare enum FrameType {
-    ANCHOR = 1,
-    DIFF = 2,
-    STREAM = 3,
-    CAPS = 4,
-    ALIGN = 5,// deprecated — use AlignStream (0x43)
-    QUERY = 16,
-    ACTION = 17,
-    IDENT = 32,
-    TRUST = 33,
-    REVOKE = 34,
-    ANNOUNCE = 48,
-    RESOLVE = 49,
-    GRAPH = 50,
-    TASK = 64,
-    DELEGATE = 65,
-    SYNC = 66,
-    ALIGN_STREAM = 67,
-    ERROR = 254
-}
-/**
- * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
- * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
- * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
- */
-declare enum EncodingTier {
-    JSON = 0,
-    MSGPACK = 1
-}
-/**
- * Flags byte in the NPS frame header (NPS-1 §3.2).
- * Bit layout (LSB = bit 0):
- *   Bits 0–1 (T0,T1) : Encoding tier
- *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
- *   Bit 3  (ENC)     : Payload encrypted
- *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
- *   Bit 7  (EXT)     : Extended 8-byte header
- */
-declare const FrameFlags: {
-    readonly NONE: 0;
-    readonly TIER1_JSON: 0;
-    readonly TIER2_MSGPACK: 1;
-    readonly FINAL: 4;
-    readonly ENCRYPTED: 8;
-    readonly EXT: 128;
-};
-declare const DEFAULT_HEADER_SIZE = 4;
-declare const EXTENDED_HEADER_SIZE = 8;
-declare const DEFAULT_MAX_PAYLOAD = 65535;
-declare const EXTENDED_MAX_PAYLOAD = 4294967295;
-/**
- * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
- *
- * Default (4 bytes, EXT=0):
- *   Byte 0   : FrameType
- *   Byte 1   : Flags
- *   Byte 2–3 : PayloadLength (big-endian uint16)
- *
- * Extended (8 bytes, EXT=1):
- *   Byte 0   : FrameType
- *   Byte 1   : Flags (bit 7 = 1)
- *   Byte 2–3 : Reserved (must be 0)
- *   Byte 4–7 : PayloadLength (big-endian uint32)
- */
-declare class FrameHeader {
-    readonly frameType: FrameType;
-    readonly flags: number;
-    readonly payloadLength: number;
-    constructor(frameType: FrameType, flags: number, payloadLength: number);
-    get isExtended(): boolean;
-    get headerSize(): number;
-    get encodingTier(): EncodingTier;
-    get isFinal(): boolean;
-    get isEncrypted(): boolean;
-    static parse(buf: Uint8Array): FrameHeader;
-    toBytes(): Uint8Array;
-    toString(): string;
-}
-
-interface FrameClass {
-    fromDict(data: Record<string, unknown>): NpsFrame;
-}
-declare class FrameRegistry {
-    private readonly _map;
-    register(frameType: FrameType, cls: FrameClass): void;
-    resolve(frameType: FrameType): FrameClass;
-}
-
-interface NpsFrame {
-    readonly frameType: FrameType;
-    readonly preferredTier: EncodingTier;
-    toDict(): Record<string, unknown>;
-}
-declare class Tier1JsonCodec {
-    encode(frame: NpsFrame): Uint8Array;
-    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
-}
-declare class Tier2MsgPackCodec {
-    encode(frame: NpsFrame): Uint8Array;
-    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
-}
-declare class NpsFrameCodec {
-    private readonly _registry;
-    private readonly _maxPayload;
-    private readonly _json;
-    private readonly _msgpack;
-    constructor(registry: FrameRegistry, options?: {
-        maxPayload?: number;
-    });
-    encode(frame: NpsFrame, options?: {
-        overrideTier?: EncodingTier;
-    }): Uint8Array;
-    decode(wire: Uint8Array): NpsFrame;
-    static peekHeader(wire: Uint8Array): FrameHeader;
-    private _buildFlags;
-    private _selectCodec;
-}
-
-export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };