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

package/CHANGELOG.cn.md

@@ -0,0 +1,57 @@
+[English Version](./CHANGELOG.md) | 中文版
+
+# 变更日志 —— TypeScript SDK (`@labacacia/nps-sdk`)
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+在 NPS 达到 v1.0 稳定版之前，套件内所有仓库同步使用同一个预发布版本号。
+
+---
+
+## [1.0.0-alpha.3] —— 2026-04-25
+
+### Changed
+
+- 版本升级至 `1.0.0-alpha.3`，与 NPS `v1.0.0-alpha.3` 套件同步。本次 TypeScript SDK 无功能变更。
+- 264 tests, ≥98% 覆盖率仍全绿。
+
+### 套件级 alpha.3 要点（各语言 helper 在 alpha.4 跟进）
+
+- **NPS-RFC-0001 —— NCP 连接前导**（Accepted）。原生模式连接现以字面量 `b"NPS/1.0\n"`（8 字节）开头。.NET SDK 已落地参考实现；TypeScript helper 在 alpha.4 跟进。
+- **NPS-RFC-0003 —— Agent 身份保证等级**（Accepted）。NIP IdentFrame 与 NWM 新增三态 `assurance_level`（`anonymous`/`attested`/`verified`）。.NET 参考类型已落地；TypeScript 同步在 alpha.4。
+- **NPS-RFC-0004 —— NID 声誉日志（CT 风格）**（Accepted）。append-only Merkle 日志条目结构发布；.NET 参考签名器已落地（并以 `nps-ledger` daemon Phase 1 形态发布）。TypeScript helper 在 alpha.4 跟进。
+- **NPS-CR-0001 —— Anchor / Bridge 节点拆分。** 旧的 "Gateway Node" 角色更名为 **Anchor Node**；"NPS↔外部协议翻译" 单独成为 **Bridge Node** 类型。AnnounceFrame 新增 `node_kind` / `cluster_anchor` / `bridge_protocols`。源代码层面变更落在 `spec/` + .NET 参考实现。
+- **6 个 NPS 常驻 daemon。** NPS-Dev 新建 `daemons/` 目录，定义 `npsd` / `nps-runner` / `nps-gateway` / `nps-registry` / `nps-cloud-ca` / `nps-ledger`；其中 `npsd` 提供 L1 功能性参考实现，其余为 Phase 1 骨架。
+
+---
+
+## [1.0.0-alpha.2] —— 2026-04-19
+
+### Fixed
+
+- **`NpsFrameCodec is not a constructor`** —— `src/core/index.ts` 现显式从 `./codec.js`、`./registry.js`、`./cache.js` 重新导出随包提供的 OOP API（`NpsFrameCodec`、`Tier1JsonCodec`、`Tier2MsgPackCodec`、`FrameRegistry`、`AnchorFrameCache`）。`./codecs/` 下的并行函数式 API 仍可通过直接路径导入，但不再自动导出（与类 API 在 `FrameType` / `EncodingTier` / `FrameHeader` 上冲突）。
+- **缺失的 Ed25519 运行时依赖** —— `@noble/ed25519` 和 `@noble/hashes` 现已声明为运行时依赖。此前已被 `src/nip/identity.ts` 和 `src/ndp/validator.ts` import 但 `package.json` 未声明，导致 npm 消费者安装失败。
+
+### Added
+
+- **HelloFrame（NCP 0x06）** —— `src/ncp/frames.ts` 新增 `HelloFrame` 类（snake_case toDict/fromDict），在 `ncp/registry.ts` 中注册。`FrameType.HELLO = 0x06` 加入枚举。
+- **subpath exports** —— `package.json` 的 `exports` 映射新增 `./nwp`、`./nip`、`./ndp`、`./nop`（此前仅声明 `.`、`./core`、`./ncp`，但 README 已示例使用全部六个）。
+
+### Changed
+
+- Node 引擎要求升级到 `>=22.0.0`。
+- 264 测试全绿（此前为 158 通过 + 5 个文件失败 + 1 个测试失败）。
+
+### 涵盖模块
+
+- core / ncp / nwp / nip / ndp / nop
+
+---
+
+## [1.0.0-alpha.1] —— 2026-04-10
+
+作为 NPS 套件 `v1.0.0-alpha.1` 的一部分首次公开 alpha。
+
+[1.0.0-alpha.3]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.3
+[1.0.0-alpha.2]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.2
+[1.0.0-alpha.1]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+English | [中文版](./CHANGELOG.cn.md)
+
+# Changelog — TypeScript SDK (`@labacacia/nps-sdk`)
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Until NPS reaches v1.0 stable, every repository in the suite is synchronized to the same pre-release version tag.
+
+---
+
+## [1.0.0-alpha.3] — 2026-04-25
+
+### Changed
+
+- Version bump to `1.0.0-alpha.3` for suite-wide synchronization with the NPS `v1.0.0-alpha.3` release. No functional changes in the TypeScript SDK at this milestone.
+- 264 tests, ≥98% coverage still green.
+
+### Suite-wide highlights at alpha.3 (per-language helpers planned for alpha.4)
+
+- **NPS-RFC-0001 — NCP connection preamble** (Accepted). Native-mode connections now begin with the literal `b"NPS/1.0\n"` (8 bytes). Reference helper landed in the .NET SDK; TypeScript helper deferred to alpha.4.
+- **NPS-RFC-0003 — Agent identity assurance levels** (Accepted). NIP IdentFrame and NWM gain a tri-state `assurance_level` (`anonymous`/`attested`/`verified`). Reference types landed in .NET; TypeScript parity deferred to alpha.4.
+- **NPS-RFC-0004 — NID reputation log (CT-style)** (Accepted). Append-only Merkle log entry shape published; reference signer landed in .NET (and shipped as the `nps-ledger` daemon Phase 1). TypeScript helpers deferred to alpha.4.
+- **NPS-CR-0001 — Anchor / Bridge node split.** The legacy "Gateway Node" role is renamed to **Anchor Node**; the "translate NPS↔external protocol" role is now its own **Bridge Node** type. AnnounceFrame gained `node_kind` / `cluster_anchor` / `bridge_protocols`. Source-of-truth changes are in `spec/` + the .NET reference implementation.
+- **6 NPS resident daemons.** New `daemons/` tree in NPS-Dev defines `npsd` / `nps-runner` / `nps-gateway` / `nps-registry` / `nps-cloud-ca` / `nps-ledger`; `npsd` ships an L1-functional reference and the rest ship as Phase 1 skeletons.
+
+---
+
+## [1.0.0-alpha.2] — 2026-04-19
+
+### Fixed
+
+- **`NpsFrameCodec is not a constructor`** — `src/core/index.ts` now explicitly re-exports the shipped OOP API (`NpsFrameCodec`, `Tier1JsonCodec`, `Tier2MsgPackCodec`, `FrameRegistry`, `AnchorFrameCache`) from `./codec.js`, `./registry.js`, `./cache.js`. The parallel functional API under `./codecs/` remains reachable by direct path but is no longer auto-exported (it collided on `FrameType` / `EncodingTier` / `FrameHeader`).
+- **Missing Ed25519 runtime deps** — `@noble/ed25519` and `@noble/hashes` are now declared as runtime dependencies. Previously imported by `src/nip/identity.ts` and `src/ndp/validator.ts` but not listed in `package.json`, causing install failures for npm consumers.
+
+### Added
+
+- **HelloFrame (NCP 0x06)** — new `HelloFrame` class in `src/ncp/frames.ts` with snake_case toDict/fromDict, registered in `ncp/registry.ts`. `FrameType.HELLO = 0x06` added to the enum.
+- **Subpath exports** — `package.json` `exports` map now includes `./nwp`, `./nip`, `./ndp`, `./nop` (previously only `.`, `./core`, `./ncp` were declared even though README documented all six).
+
+### Changed
+
+- Node engine requirement raised to `>=22.0.0`.
+- 264 tests green (up from 158 previously passing + 5 file failures + 1 test failure).
+
+### Covered modules
+
+- core / ncp / nwp / nip / ndp / nop
+
+---
+
+## [1.0.0-alpha.1] — 2026-04-10
+
+First public alpha as part of the NPS suite `v1.0.0-alpha.1` release.
+
+[1.0.0-alpha.3]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.3
+[1.0.0-alpha.2]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.2
+[1.0.0-alpha.1]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.1

package/CONTRIBUTING.cn.md

@@ -0,0 +1,35 @@
+[English Version](./CONTRIBUTING.md) | 中文版
+
+# 为 NPS 贡献代码
+
+感谢你有兴趣为 Neural Protocol Suite 做出贡献。
+
+## Issue 前缀
+
+| 前缀 | 用途 |
+|------|------|
+| `spec:` | 规范问题与设计讨论 |
+| `impl:` | 实现 Bug 与修复 |
+| `sdk:`  | SDK 相关（Python / TypeScript 等） |
+| `docs:` | 文档改进 |
+
+## 工作流
+
+1. 任何非平凡的变更先开 Issue
+2. Fork 仓库并创建分支：`feature/your-feature` 或 `fix/your-fix`
+3. 提交 Pull Request 并关联对应的 Issue
+
+## 规范变更
+
+对 `spec/` 目录下文件的变更必须先开讨论 Issue 才能接受 PR。
+涉及线缆格式或帧结构的规范变更必须同时做版本号升级。
+
+## 代码风格
+
+- **C# / .NET**：遵循 Microsoft 标准 C# 约定，开启 Nullable
+- **Python**：PEP 8，必须带类型标注
+- **TypeScript**：开启严格模式
+
+## 许可证
+
+一旦提交贡献，你即同意贡献内容按 Apache 2.0 许可证授权。

package/CONTRIBUTING.md

@@ -1,3 +1,5 @@
+English | [中文版](./CONTRIBUTING.cn.md)
+
 # Contributing to NPS
 
 Thank you for your interest in contributing to the Neural Protocol Suite.

package/README.cn.md

@@ -0,0 +1,155 @@
+[English Version](./README.md) | 中文版
+
+# @labacacia/nps-sdk — TypeScript / Node.js
+
+面向 **Neural Protocol Suite (NPS)** 的 TypeScript SDK —— 为 AI Agent 设计的协议族。
+属 [LabAcacia](https://github.com/LabAcacia) / INNO LOTUS PTY LTD 开源生态。
+
+## 状态
+
+**v1.0.0-alpha.3 — Phase 2** · 5 个协议 · 264 个测试 · 覆盖率 ≥ 98%
+
+| 协议 | 类 | 状态 |
+|------|----|------|
+| NCP — Neural Communication Protocol | 帧、编解码器 | ✅ |
+| NWP — Neural Web Protocol | `NwpClient` | ✅ |
+| NIP — Neural Identity Protocol | `NipIdentity` | ✅ |
+| NDP — Neural Discovery Protocol | `InMemoryNdpRegistry`、`NdpAnnounceValidator` | ✅ |
+| NOP — Neural Orchestration Protocol | `NopClient` | ✅ |
+
+## 安装
+
+```bash
+npm install @labacacia/nps-sdk
+```
+
+> **对等依赖：** Node.js 22+
+
+## 快速开始
+
+### NWP —— 查询节点
+
+```typescript
+import { NwpClient, QueryFrame } 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 }, 20));
+console.log(caps.count, caps.data);
+```
+
+### NWP —— 流式结果
+
+```typescript
+for await (const chunk of client.stream(new QueryFrame("sha256:<anchor-id>"))) {
+  console.log(chunk.seq, chunk.data);
+}
+```
+
+### NWP —— 调用 Action
+
+```typescript
+import { ActionFrame } from "@labacacia/nps-sdk/nwp";
+
+const result = await client.invoke(new ActionFrame("summarise", { maxTokens: 500 }));
+```
+
+### NIP —— Ed25519 身份
+
+```typescript
+import { NipIdentity } from "@labacacia/nps-sdk/nip";
+
+// 生成并持久化
+const id = NipIdentity.generate();
+id.save("./my-key.json", process.env.KEY_PASS!);
+
+// 加载并签名
+const loaded = NipIdentity.load("./my-key.json", process.env.KEY_PASS!);
+const sig    = loaded.sign({ action: "announce", nid: "urn:nps:node:example.com:data" });
+const ok     = loaded.verify({ action: "announce", nid: "urn:nps:node:example.com:data" }, sig);
+```
+
+### NDP —— 注册表和签名校验
+
+```typescript
+import { InMemoryNdpRegistry, NdpAnnounceValidator } from "@labacacia/nps-sdk/ndp";
+import { AnnounceFrame } from "@labacacia/nps-sdk/ndp";
+
+const registry  = new InMemoryNdpRegistry();
+const validator = new NdpAnnounceValidator();
+validator.registerPublicKey(nid, identity.pubKeyString);
+
+registry.announce(frame);
+const resolved = registry.resolve("nwp://example.com/data/items");
+```
+
+### NOP —— 提交并等待任务
+
+```typescript
+import { NopClient, TaskFrame } from "@labacacia/nps-sdk/nop";
+
+const client = new NopClient("http://orchestrator.example.com:17433");
+const dag    = {
+  nodes: [{ id: "classify", action: "classify-text", agent: "urn:nps:node:ml.example.com:classifier" }],
+  edges: [],
+};
+
+const taskId = await client.submit(new TaskFrame("my-task-1", dag));
+const status = await client.wait(taskId, { timeoutMs: 30_000 });
+console.log(status.state, status.aggregatedResult);
+```
+
+## 包导出
+
+```typescript
+import { ... } from "@labacacia/nps-sdk";           // 全部
+import { ... } from "@labacacia/nps-sdk/core";       // codec、帧、registry、cache
+import { ... } from "@labacacia/nps-sdk/ncp";        // AnchorFrame、CapsFrame、StreamFrame、HelloFrame、…
+import { ... } from "@labacacia/nps-sdk/nwp";        // NwpClient、QueryFrame、ActionFrame
+import { ... } from "@labacacia/nps-sdk/nip";        // NipIdentity、IdentFrame、TrustFrame、RevokeFrame
+import { ... } from "@labacacia/nps-sdk/ndp";        // InMemoryNdpRegistry、NdpAnnounceValidator、AnnounceFrame、…
+import { ... } from "@labacacia/nps-sdk/nop";        // NopClient、NopTaskStatus、TaskFrame、…
+```
+
+## NCP 编解码
+
+编解码层支持双 Tier 编码和对线上字节的直接操作：
+
+```typescript
+import { NpsFrameCodec, EncodingTier } from "@labacacia/nps-sdk/core";
+import { createDefaultRegistry } from "@labacacia/nps-sdk";
+
+const codec = new NpsFrameCodec(createDefaultRegistry());
+
+// 编码（默认 MsgPack）
+const wire = codec.encode(frame);
+
+// 编码为 JSON（调试 / 互操作）
+const json = codec.encode(frame, { overrideTier: EncodingTier.JSON });
+
+// 解码
+const decoded = codec.decode(wire);
+
+// 仅读取帧头，不解码 payload
+const header = NpsFrameCodec.peekHeader(wire);
+console.log(header.frameType, header.isExtended, header.payloadLength);
+```
+
+## 开发
+
+```bash
+# 安装
+npm install
+
+# 测试
+npm test
+
+# 测试 + 覆盖率
+npm run test -- --coverage
+
+# 构建（ESM + CJS）
+npm run build
+```
+
+## 许可证
+
+Apache 2.0 —— 详见 [LICENSE](../../LICENSE)。

package/README.md

@@ -1,3 +1,5 @@
+English | [中文版](./README.cn.md)
+
 # @labacacia/nps-sdk — TypeScript / Node.js
 
 TypeScript SDK for the **Neural Protocol Suite** (NPS) — a protocol suite designed for AI Agents.  
@@ -5,7 +7,7 @@ Part of the [LabAcacia](https://github.com/LabAcacia) / INNO LOTUS PTY LTD open-
 
 ## Status
 
-**v0.1.0 — Phase 2** · 5 protocols · 139 tests · ≥ 98% coverage
+**v1.0.0-alpha.3 — Phase 2** · 5 protocols · 264 tests · ≥ 98% coverage
 
 | Protocol | Class | Status |
 |----------|-------|--------|
@@ -21,7 +23,7 @@ Part of the [LabAcacia](https://github.com/LabAcacia) / INNO LOTUS PTY LTD open-
 npm install @labacacia/nps-sdk
 ```
 
-> **Peer requirement:** Node.js 18+
+> **Peer requirement:** Node.js 22+
 
 ## Quick Start
 
@@ -101,7 +103,7 @@ console.log(status.state, status.aggregatedResult);
 ```typescript
 import { ... } from "@labacacia/nps-sdk";           // everything
 import { ... } from "@labacacia/nps-sdk/core";       // codec, frames, registry, cache
-import { ... } from "@labacacia/nps-sdk/ncp";        // AnchorFrame, CapsFrame, StreamFrame, …
+import { ... } from "@labacacia/nps-sdk/ncp";        // AnchorFrame, CapsFrame, StreamFrame, HelloFrame, …
 import { ... } from "@labacacia/nps-sdk/nwp";        // NwpClient, QueryFrame, ActionFrame
 import { ... } from "@labacacia/nps-sdk/nip";        // NipIdentity, IdentFrame, TrustFrame, RevokeFrame
 import { ... } from "@labacacia/nps-sdk/ndp";        // InMemoryNdpRegistry, NdpAnnounceValidator, AnnounceFrame, …

package/dist/core/frames.d.ts

@@ -5,6 +5,7 @@ export declare enum FrameType {
     STREAM = 3,
     CAPS = 4,
     ALIGN = 5,// deprecated — use AlignStream (0x43)
+    HELLO = 6,
     QUERY = 16,
     ACTION = 17,
     IDENT = 32,

package/dist/core/frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/core/frames.ts"],"names":[],"mappings":"AAWA,sEAAsE;AACtE,oBAAY,SAAS;IAEnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,KAAK,IAAc,CAAE,sCAAsC;IAG3D,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,KAAK,KAAc;IACnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,QAAQ,KAAW;IACnB,OAAO,KAAY;IACnB,KAAK,KAAc;IAGnB,IAAI,KAAe;IACnB,QAAQ,KAAW;IACnB,IAAI,KAAe;IACnB,YAAY,KAAO;IAGnB,KAAK,MAAc;CACpB;AAID;;;;GAIG;AACH,oBAAY,YAAY;IACtB,IAAI,IAAU;IACd,OAAO,IAAO;CACf;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAIX,eAAO,MAAM,mBAAmB,IAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAC3C,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAI/C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;aAEJ,SAAS,EAAE,SAAS;aACpB,KAAK,EAAE,MAAM;aACb,aAAa,EAAE,MAAM;gBAFrB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM;IAGvC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAiC1C,OAAO,IAAI,UAAU;IAkBrB,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/core/frames.ts"],"names":[],"mappings":"AAWA,sEAAsE;AACtE,oBAAY,SAAS;IAEnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,KAAK,IAAc,CAAE,sCAAsC;IAC3D,KAAK,IAAc;IAGnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,KAAK,KAAc;IACnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,QAAQ,KAAW;IACnB,OAAO,KAAY;IACnB,KAAK,KAAc;IAGnB,IAAI,KAAe;IACnB,QAAQ,KAAW;IACnB,IAAI,KAAe;IACnB,YAAY,KAAO;IAGnB,KAAK,MAAc;CACpB;AAID;;;;GAIG;AACH,oBAAY,YAAY;IACtB,IAAI,IAAU;IACd,OAAO,IAAO;CACf;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAIX,eAAO,MAAM,mBAAmB,IAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAC3C,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAI/C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;aAEJ,SAAS,EAAE,SAAS;aACpB,KAAK,EAAE,MAAM;aACb,aAAa,EAAE,MAAM;gBAFrB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM;IAGvC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAiC1C,OAAO,IAAI,UAAU;IAkBrB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/core/index.cjs

@@ -2,6 +2,9 @@
 
 var msgpack = require('@msgpack/msgpack');
 var crypto = require('crypto');
+var canonicalizeImport = require('canonicalize');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -22,33 +25,48 @@ function _interopNamespace(e) {
 }
 
 var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
+var canonicalizeImport__default = /*#__PURE__*/_interopDefault(canonicalizeImport);
 
 // src/core/exceptions.ts
 var NpsError = class extends Error {
   constructor(message) {
     super(message);
-    this.name = new.target.name;
+    this.name = "NpsError";
   }
 };
 var NpsFrameError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsFrameError";
+  }
 };
 var NpsCodecError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsCodecError";
+  }
 };
 var NpsAnchorNotFoundError = class extends NpsError {
-  constructor(anchorId) {
-    super(`AnchorFrame not found in cache: ${anchorId}`);
+  anchorId;
+  constructor(anchorId, message) {
+    super(message ?? `Anchor not found: ${anchorId}`);
+    this.name = "NpsAnchorNotFoundError";
     this.anchorId = anchorId;
   }
-  anchorId;
 };
 var NpsAnchorPoisonError = class extends NpsError {
-  constructor(anchorId) {
-    super(
-      `Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`
-    );
+  anchorId;
+  constructor(anchorId, message) {
+    super(message ?? `Anchor poison detected: ${anchorId}`);
+    this.name = "NpsAnchorPoisonError";
     this.anchorId = anchorId;
   }
-  anchorId;
+};
+var NpsStreamError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsStreamError";
+  }
 };
 
 // src/core/frames.ts
@@ -58,6 +76,7 @@ var FrameType = /* @__PURE__ */ ((FrameType3) => {
   FrameType3[FrameType3["STREAM"] = 3] = "STREAM";
   FrameType3[FrameType3["CAPS"] = 4] = "CAPS";
   FrameType3[FrameType3["ALIGN"] = 5] = "ALIGN";
+  FrameType3[FrameType3["HELLO"] = 6] = "HELLO";
   FrameType3[FrameType3["QUERY"] = 16] = "QUERY";
   FrameType3[FrameType3["ACTION"] = 17] = "ACTION";
   FrameType3[FrameType3["IDENT"] = 32] = "IDENT";
@@ -349,6 +368,64 @@ var AnchorFrameCache = class _AnchorFrameCache {
   }
 };
 
+// src/core/status-codes.ts
+var NpsStatusCodes = {
+  // Success
+  NPS_OK: "NPS-OK",
+  NPS_OK_ACCEPTED: "NPS-OK-ACCEPTED",
+  NPS_OK_NO_CONTENT: "NPS-OK-NO-CONTENT",
+  // Auth
+  NPS_AUTH_UNAUTHENTICATED: "NPS-AUTH-UNAUTHENTICATED",
+  NPS_AUTH_FORBIDDEN: "NPS-AUTH-FORBIDDEN",
+  // Client errors
+  NPS_CLIENT_BAD_FRAME: "NPS-CLIENT-BAD-FRAME",
+  NPS_CLIENT_BAD_PARAM: "NPS-CLIENT-BAD-PARAM",
+  NPS_CLIENT_NOT_FOUND: "NPS-CLIENT-NOT-FOUND",
+  NPS_CLIENT_CONFLICT: "NPS-CLIENT-CONFLICT",
+  NPS_CLIENT_GONE: "NPS-CLIENT-GONE",
+  NPS_CLIENT_UNPROCESSABLE: "NPS-CLIENT-UNPROCESSABLE",
+  // Server errors
+  NPS_SERVER_INTERNAL: "NPS-SERVER-INTERNAL",
+  NPS_SERVER_UNAVAILABLE: "NPS-SERVER-UNAVAILABLE",
+  NPS_SERVER_TIMEOUT: "NPS-SERVER-TIMEOUT",
+  NPS_SERVER_ENCODING_UNSUPPORTED: "NPS-SERVER-ENCODING-UNSUPPORTED",
+  // Stream
+  NPS_STREAM_SEQ_GAP: "NPS-STREAM-SEQ-GAP",
+  NPS_STREAM_NOT_FOUND: "NPS-STREAM-NOT-FOUND",
+  NPS_STREAM_LIMIT: "NPS-STREAM-LIMIT",
+  // Limit
+  NPS_LIMIT_RATE: "NPS-LIMIT-RATE",
+  NPS_LIMIT_BUDGET: "NPS-LIMIT-BUDGET",
+  NPS_LIMIT_PAYLOAD: "NPS-LIMIT-PAYLOAD",
+  NPS_LIMIT_EXCEEDED: "NPS-LIMIT-EXCEEDED",
+  // Protocol
+  NPS_PROTO_VERSION_INCOMPATIBLE: "NPS-PROTO-VERSION-INCOMPATIBLE"
+};
+var canonicalize = canonicalizeImport__default.default;
+function jcsStringify(obj) {
+  const result = canonicalize(obj);
+  if (result === void 0) {
+    throw new Error("canonicalize returned undefined for input");
+  }
+  return result;
+}
+function sortKeysStringify(obj) {
+  return JSON.stringify(sortKeys(obj));
+}
+function sortKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map(sortKeys);
+  }
+  if (value !== null && typeof value === "object") {
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+      sorted[key] = sortKeys(value[key]);
+    }
+    return sorted;
+  }
+  return value;
+}
+
 exports.AnchorFrameCache = AnchorFrameCache;
 exports.DEFAULT_HEADER_SIZE = DEFAULT_HEADER_SIZE;
 exports.DEFAULT_MAX_PAYLOAD = DEFAULT_MAX_PAYLOAD;
@@ -365,7 +442,11 @@ exports.NpsCodecError = NpsCodecError;
 exports.NpsError = NpsError;
 exports.NpsFrameCodec = NpsFrameCodec;
 exports.NpsFrameError = NpsFrameError;
+exports.NpsStatusCodes = NpsStatusCodes;
+exports.NpsStreamError = NpsStreamError;
 exports.Tier1JsonCodec = Tier1JsonCodec;
 exports.Tier2MsgPackCodec = Tier2MsgPackCodec;
+exports.jcsStringify = jcsStringify;
+exports.sortKeysStringify = sortKeysStringify;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map