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

package/doc/nps-sdk.nwp.cn.md

@@ -0,0 +1,288 @@
+[English Version](./nps-sdk.nwp.md) | 中文版
+
+# `@labacacia/nps-sdk/nwp` — 类与方法参考
+
+> 规范：[NPS-2 NWP v0.13](https://github.com/labacacia/nps/blob/main/spec/NPS-2-NWP.md)
+
+NWP 是 AI 的 HTTP。本模块提供两个 NWP 帧
+（`QueryFrame`、`ActionFrame`）、异步 `NwpClient`，以及用于查询排序、
+向量检索和异步动作响应的 dataclass 风格接口。
+
+---
+
+## 目录
+
+- [`QueryOrderClause`](#queryorderclause)
+- [`VectorSearchOptions`](#vectorsearchoptions)
+- [`AsyncActionResponse`](#asyncactionresponse)
+- [`QueryFrame` (0x10)](#queryframe-0x10)
+- [`ActionFrame` (0x11)](#actionframe-0x11)
+- [`NwpClient`](#nwpclient)
+- [`NwpErrorCodes`](#nwperrorcodes)
+
+---
+
+## `QueryOrderClause`
+
+```typescript
+interface QueryOrderClause {
+  field: string;
+  dir:   "asc" | "desc";
+}
+```
+
+---
+
+## `VectorSearchOptions`
+
+```typescript
+interface VectorSearchOptions {
+  vector:       readonly number[];
+  topK?:        number;
+  minScore?:    number;
+  vectorField?: string;
+}
+```
+
+当目标 Memory Node 广告 `nwp:vector` 时，附加到 `QueryFrame.vectorSearch`。
+
+---
+
+## `AsyncActionResponse`
+
+```typescript
+interface AsyncActionResponse {
+  taskId:   string;
+  status:   string;   // "pending" | "running" | …
+  pollUrl?: string;
+}
+
+function asyncActionResponseFromDict(
+  data: Record<string, unknown>,
+): AsyncActionResponse;
+```
+
+当 `ActionFrame` 以 `async_ === true` 提交时，由 `NwpClient.invoke` 返回。
+
+---
+
+## `QueryFrame` (0x10)
+
+针对 Memory Node 的结构化读取。
+
+```typescript
+class QueryFrame {
+  readonly frameType:     FrameType.QUERY;
+  readonly preferredTier: EncodingTier.MSGPACK;
+
+  constructor(
+    public readonly anchorRef?:    string,
+    public readonly filter?:       Record<string, unknown>,
+    public readonly limit?:        number,
+    public readonly offset?:       number,
+    public readonly orderBy?:      readonly QueryOrderClause[],
+    public readonly fields?:       readonly string[],
+    public readonly vectorSearch?: VectorSearchOptions,
+    public readonly depth?:        number,
+  );
+
+  toDict(): Record<string, unknown>;
+  static fromDict(data: Record<string, unknown>): QueryFrame;
+}
+```
+
+线路形式（由 `toDict` 发出）使用 snake-case 键：
+`anchor_ref`、`order_by`、`vector_search` 等。
+
+---
+
+## `ActionFrame` (0x11)
+
+针对 Action / Complex / Gateway Node 的操作调用。
+
+```typescript
+class ActionFrame {
+  readonly frameType:     FrameType.ACTION;
+  readonly preferredTier: EncodingTier.MSGPACK;
+
+  constructor(
+    public readonly actionId:        string,
+    public readonly params?:         Record<string, unknown>,
+    public readonly async_?:         boolean,
+    public readonly idempotencyKey?: string,
+    public readonly timeoutMs?:      number,
+  );
+
+  toDict(): Record<string, unknown>;
+  static fromDict(data: Record<string, unknown>): ActionFrame;
+}
+```
+
+- `actionId` 是 Action Node 的 `.nwm.json` → `endpoints.actions[].id` 中
+  声明的标识符。
+- `async_` 在线路上序列化为 `"async"`（尾下划线避免与 JS 关键字冲突）。
+- `idempotencyKey` —— 存在则节点必须在其重放窗口内去重。
+
+---
+
+## `NwpClient`
+
+使用 `Content-Type: application/x-nps-frame` 与 NWP 节点通信的异步 HTTP 客户端。
+
+```typescript
+class NwpClient {
+  constructor(
+    baseUrl: string,
+    options?: {
+      defaultTier?: EncodingTier;   // 默认：MSGPACK
+      maxPayload?:  number;         // 默认：65 535
+      registry?:    FrameRegistry;  // 默认：NCP + NWP 帧
+    },
+  );
+
+  async sendAnchor(frame: AnchorFrame): Promise<void>;
+  async query(frame: QueryFrame): Promise<CapsFrame>;
+  stream(frame: QueryFrame): AsyncGenerator<StreamFrame>;
+  async invoke(frame: ActionFrame): Promise<unknown>;
+}
+```
+
+`baseUrl` 的尾斜杠自动去除。
+
+### HTTP 路由
+
+| 方法 | 路径 | 请求体 | 响应 |
+|------|------|--------|------|
+| `sendAnchor` | `POST /anchor` | `AnchorFrame` 线路字节 | `204 No Content` |
+| `query`      | `POST /query`  | `QueryFrame` 线路字节 | `CapsFrame` 线路字节 |
+| `stream`     | `POST /stream` | `QueryFrame` 线路字节 | 分块 `StreamFrame` 直至 `is_last=true` |
+| `invoke`     | `POST /invoke` | `ActionFrame` 线路字节 | 动作结果 |
+
+`invoke()` 按 `frame.async_` 分派：
+
+- `false` → 依据 content-type 解码响应。若服务器返回
+  `application/x-nps-frame`，body 由编解码器解码；否则按 JSON 解析。
+- `true` → 解析 JSON 返回 `AsyncActionResponse`。轮询 `pollUrl`
+  观察进度。
+
+所有方法在非 2xx HTTP 状态时抛普通 `Error`。流帧被独立发出 ——
+用 `for await` 消费生成器。
+
+---
+
+## 端到端示例
+
+```typescript
+import {
+  NwpClient, QueryFrame, QueryOrderClause,
+  ActionFrame, AsyncActionResponse,
+  VectorSearchOptions,
+} from "@labacacia/nps-sdk/nwp";
+
+const nwp = new NwpClient("https://products.example.com");
+
+// 1) 一次性上传 anchor
+await nwp.sendAnchor({
+  frame:     "0x01",
+  anchor_id: "sha256:…",
+  schema:    { fields: [
+    { name: "id",    type: "uint64" },
+    { name: "price", type: "decimal", semantic: "commerce.price.usd" },
+  ]},
+  ttl:       3600,
+});
+
+// 2) 查询一页
+const caps = await nwp.query(new QueryFrame(
+  "sha256:…",
+  { price: { $lt: "100.00" } },
+  50,
+  undefined,
+  [{ field: "price", dir: "asc" }],
+));
+console.log(caps.count, "行, cursor:", caps.next_cursor);
+
+// 3) 流式获取全量
+for await (const chunk of nwp.stream(new QueryFrame("sha256:…"))) {
+  for (const row of chunk.data) { /* … */ }
+  if (chunk.isLast) break;
+}
+
+// 4) 触发异步动作
+const resp = await nwp.invoke(new ActionFrame(
+  "restock",
+  { sku: "sku-4242", qty: 100 },
+  true,
+));
+// resp 是 AsyncActionResponse
+```
+
+---
+
+## `NwpErrorCodes`
+
+30 个 NWP wire 错误码字符串常量（alpha.5 新增）。
+
+```typescript
+import { NwpErrorCodes } from "@labacacia/nps-sdk/nwp";
+```
+
+### Auth 组（`NWP-AUTH-*`）
+
+| 常量 | Wire 值 |
+|------|---------|
+| `NwpErrorCodes.AUTH_NID_SCOPE_VIOLATION` | `"NWP-AUTH-NID-SCOPE-VIOLATION"` |
+| `NwpErrorCodes.AUTH_NID_NOT_TRUSTED` | `"NWP-AUTH-NID-NOT-TRUSTED"` |
+| `NwpErrorCodes.AUTH_NID_EXPIRED` | `"NWP-AUTH-NID-EXPIRED"` |
+| `NwpErrorCodes.AUTH_NID_REVOKED` | `"NWP-AUTH-NID-REVOKED"` |
+| `NwpErrorCodes.AUTH_SIG_INVALID` | `"NWP-AUTH-SIG-INVALID"` |
+| `NwpErrorCodes.AUTH_TOKEN_BUDGET_EXCEEDED` | `"NWP-AUTH-TOKEN-BUDGET-EXCEEDED"` |
+| `NwpErrorCodes.AUTH_RATE_LIMIT` | `"NWP-AUTH-RATE-LIMIT"` |
+
+### Query 组（`NWP-QUERY-*`）
+
+| 常量 | Wire 值 |
+|------|---------|
+| `NwpErrorCodes.QUERY_ANCHOR_NOT_FOUND` | `"NWP-QUERY-ANCHOR-NOT-FOUND"` |
+| `NwpErrorCodes.QUERY_ANCHOR_EXPIRED` | `"NWP-QUERY-ANCHOR-EXPIRED"` |
+| `NwpErrorCodes.QUERY_SCHEMA_MISMATCH` | `"NWP-QUERY-SCHEMA-MISMATCH"` |
+| `NwpErrorCodes.QUERY_LIMIT_EXCEEDED` | `"NWP-QUERY-LIMIT-EXCEEDED"` |
+| `NwpErrorCodes.QUERY_DEPTH_EXCEEDED` | `"NWP-QUERY-DEPTH-EXCEEDED"` |
+| `NwpErrorCodes.QUERY_FILTER_INVALID` | `"NWP-QUERY-FILTER-INVALID"` |
+| `NwpErrorCodes.QUERY_VECTOR_UNSUPPORTED` | `"NWP-QUERY-VECTOR-UNSUPPORTED"` |
+| `NwpErrorCodes.QUERY_CURSOR_INVALID` | `"NWP-QUERY-CURSOR-INVALID"` |
+
+### Action、Task、Subscribe、Infrastructure 组
+
+| 常量 | Wire 值 |
+|------|---------|
+| `NwpErrorCodes.ACTION_NOT_FOUND` | `"NWP-ACTION-NOT-FOUND"` |
+| `NwpErrorCodes.ACTION_PARAM_INVALID` | `"NWP-ACTION-PARAM-INVALID"` |
+| `NwpErrorCodes.ACTION_IDEMPOTENCY_CONFLICT` | `"NWP-ACTION-IDEMPOTENCY-CONFLICT"` |
+| `NwpErrorCodes.TASK_NOT_FOUND` | `"NWP-TASK-NOT-FOUND"` |
+| `NwpErrorCodes.TASK_ALREADY_COMPLETE` | `"NWP-TASK-ALREADY-COMPLETE"` |
+| `NwpErrorCodes.TASK_TIMEOUT` | `"NWP-TASK-TIMEOUT"` |
+| `NwpErrorCodes.TASK_CANCELLED` | `"NWP-TASK-CANCELLED"` |
+| `NwpErrorCodes.SUBSCRIBE_TOPIC_NOT_FOUND` | `"NWP-SUBSCRIBE-TOPIC-NOT-FOUND"` |
+| `NwpErrorCodes.SUBSCRIBE_ALREADY_ACTIVE` | `"NWP-SUBSCRIBE-ALREADY-ACTIVE"` |
+| `NwpErrorCodes.SUBSCRIBE_QUOTA_EXCEEDED` | `"NWP-SUBSCRIBE-QUOTA-EXCEEDED"` |
+| `NwpErrorCodes.SUBSCRIBE_FILTER_INVALID` | `"NWP-SUBSCRIBE-FILTER-INVALID"` |
+| `NwpErrorCodes.SUBSCRIBE_NOT_FOUND` | `"NWP-SUBSCRIBE-NOT-FOUND"` |
+| `NwpErrorCodes.INFRA_NODE_OVERLOADED` | `"NWP-INFRA-NODE-OVERLOADED"` |
+| `NwpErrorCodes.INFRA_UPSTREAM_TIMEOUT` | `"NWP-INFRA-UPSTREAM-TIMEOUT"` |
+| `NwpErrorCodes.INFRA_UPSTREAM_ERROR` | `"NWP-INFRA-UPSTREAM-ERROR"` |
+| `NwpErrorCodes.INFRA_STORAGE_ERROR` | `"NWP-INFRA-STORAGE-ERROR"` |
+| `NwpErrorCodes.INFRA_CONFIG_ERROR` | `"NWP-INFRA-CONFIG-ERROR"` |
+
+### Manifest、Topology、Reserved 组
+
+| 常量 | Wire 值 |
+|------|---------|
+| `NwpErrorCodes.MANIFEST_NOT_FOUND` | `"NWP-MANIFEST-NOT-FOUND"` |
+| `NwpErrorCodes.MANIFEST_PARSE_ERROR` | `"NWP-MANIFEST-PARSE-ERROR"` |
+| `NwpErrorCodes.MANIFEST_VERSION_MISMATCH` | `"NWP-MANIFEST-VERSION-MISMATCH"` |
+| `NwpErrorCodes.TOPOLOGY_UNAUTHORIZED` | `"NWP-TOPOLOGY-UNAUTHORIZED"` |
+| `NwpErrorCodes.TOPOLOGY_NOT_AVAILABLE` | `"NWP-TOPOLOGY-NOT-AVAILABLE"` |
+| `NwpErrorCodes.TOPOLOGY_SNAPSHOT_TOO_LARGE` | `"NWP-TOPOLOGY-SNAPSHOT-TOO-LARGE"` |
+| `NwpErrorCodes.TOPOLOGY_STREAM_INTERRUPTED` | `"NWP-TOPOLOGY-STREAM-INTERRUPTED"` |
+| `NwpErrorCodes.RESERVED_TYPE_UNSUPPORTED` | `"NWP-RESERVED-TYPE-UNSUPPORTED"` |

package/doc/nps-sdk.nwp.md

@@ -0,0 +1,295 @@
+English | [中文版](./nps-sdk.nwp.cn.md)
+
+# `@labacacia/nps-sdk/nwp` — Class and Method Reference
+
+> Spec: [NPS-2 NWP v0.13](https://github.com/labacacia/nps/blob/main/spec/NPS-2-NWP.md)
+
+NWP is the HTTP-of-AI. This module ships the two NWP frames
+(`QueryFrame`, `ActionFrame`), the async `NwpClient`, and supporting
+dataclass-like interfaces for query ordering, vector search, and async
+action responses.
+
+---
+
+## Table of contents
+
+- [`QueryOrderClause`](#queryorderclause)
+- [`VectorSearchOptions`](#vectorsearchoptions)
+- [`AsyncActionResponse`](#asyncactionresponse)
+- [`QueryFrame` (0x10)](#queryframe-0x10)
+- [`ActionFrame` (0x11)](#actionframe-0x11)
+- [`NwpClient`](#nwpclient)
+- [`NwpErrorCodes`](#nwperrorcodes)
+
+---
+
+## `QueryOrderClause`
+
+```typescript
+interface QueryOrderClause {
+  field: string;
+  dir:   "asc" | "desc";
+}
+```
+
+---
+
+## `VectorSearchOptions`
+
+```typescript
+interface VectorSearchOptions {
+  vector:       readonly number[];
+  topK?:        number;
+  minScore?:    number;
+  vectorField?: string;
+}
+```
+
+Attached to a `QueryFrame.vectorSearch` when the target Memory Node
+advertises `nwp:vector`.
+
+---
+
+## `AsyncActionResponse`
+
+```typescript
+interface AsyncActionResponse {
+  taskId:   string;
+  status:   string;   // "pending" | "running" | …
+  pollUrl?: string;
+}
+
+function asyncActionResponseFromDict(
+  data: Record<string, unknown>,
+): AsyncActionResponse;
+```
+
+Returned by `NwpClient.invoke` when the `ActionFrame` was submitted with
+`async_ === true`.
+
+---
+
+## `QueryFrame` (0x10)
+
+Structured read against a Memory Node.
+
+```typescript
+class QueryFrame {
+  readonly frameType:     FrameType.QUERY;
+  readonly preferredTier: EncodingTier.MSGPACK;
+
+  constructor(
+    public readonly anchorRef?:    string,
+    public readonly filter?:       Record<string, unknown>,
+    public readonly limit?:        number,
+    public readonly offset?:       number,
+    public readonly orderBy?:      readonly QueryOrderClause[],
+    public readonly fields?:       readonly string[],
+    public readonly vectorSearch?: VectorSearchOptions,
+    public readonly depth?:        number,
+  );
+
+  toDict(): Record<string, unknown>;
+  static fromDict(data: Record<string, unknown>): QueryFrame;
+}
+```
+
+Wire form (emitted by `toDict`) uses snake-case keys:
+`anchor_ref`, `order_by`, `vector_search` etc.
+
+---
+
+## `ActionFrame` (0x11)
+
+Operation invocation against an Action / Complex / Gateway Node.
+
+```typescript
+class ActionFrame {
+  readonly frameType:     FrameType.ACTION;
+  readonly preferredTier: EncodingTier.MSGPACK;
+
+  constructor(
+    public readonly actionId:        string,
+    public readonly params?:         Record<string, unknown>,
+    public readonly async_?:         boolean,
+    public readonly idempotencyKey?: string,
+    public readonly timeoutMs?:      number,
+  );
+
+  toDict(): Record<string, unknown>;
+  static fromDict(data: Record<string, unknown>): ActionFrame;
+}
+```
+
+- `actionId` is the identifier declared under the Action Node's
+  `.nwm.json` → `endpoints.actions[].id`.
+- `async_` is serialised as `"async"` on the wire (trailing underscore
+  avoids shadowing the JS keyword).
+- `idempotencyKey` — if present, the node MUST deduplicate within its
+  replay window.
+
+---
+
+## `NwpClient`
+
+Async HTTP client that talks to an NWP node using
+`Content-Type: application/x-nps-frame`.
+
+```typescript
+class NwpClient {
+  constructor(
+    baseUrl: string,
+    options?: {
+      defaultTier?: EncodingTier;   // default: MSGPACK
+      maxPayload?:  number;         // default: 65 535
+      registry?:    FrameRegistry;  // default: NCP + NWP frames
+    },
+  );
+
+  async sendAnchor(frame: AnchorFrame): Promise<void>;
+  async query(frame: QueryFrame): Promise<CapsFrame>;
+  stream(frame: QueryFrame): AsyncGenerator<StreamFrame>;
+  async invoke(frame: ActionFrame): Promise<unknown>;
+}
+```
+
+`baseUrl` trailing slashes are trimmed automatically.
+
+### HTTP routes
+
+| Method | Path | Body | Response |
+|--------|------|------|----------|
+| `sendAnchor` | `POST /anchor` | `AnchorFrame` wire bytes | `204 No Content` |
+| `query`      | `POST /query`  | `QueryFrame` wire bytes | `CapsFrame` wire bytes |
+| `stream`     | `POST /stream` | `QueryFrame` wire bytes | chunked `StreamFrame`s until `is_last=true` |
+| `invoke`     | `POST /invoke` | `ActionFrame` wire bytes | action result |
+
+`invoke()` dispatches by `frame.async_`:
+
+- `false` → decodes response based on content-type. If the server
+  responds with `application/x-nps-frame`, the body is decoded by the
+  codec; otherwise the response is parsed as JSON.
+- `true` → parses JSON and returns `AsyncActionResponse`. Poll
+  `pollUrl` to observe progress.
+
+All methods throw a plain `Error` on non-2xx HTTP status. Stream frames
+are emitted individually — consume the generator with `for await`.
+
+---
+
+## End-to-end example
+
+```typescript
+import {
+  NwpClient, QueryFrame, QueryOrderClause,
+  ActionFrame, AsyncActionResponse,
+  VectorSearchOptions,
+} from "@labacacia/nps-sdk/nwp";
+
+const nwp = new NwpClient("https://products.example.com");
+
+// 1) Upload an anchor once
+await nwp.sendAnchor({
+  frame:     "0x01",
+  anchor_id: "sha256:…",
+  schema:    { fields: [
+    { name: "id",    type: "uint64" },
+    { name: "price", type: "decimal", semantic: "commerce.price.usd" },
+  ]},
+  ttl:       3600,
+});
+
+// 2) Query a page
+const caps = await nwp.query(new QueryFrame(
+  "sha256:…",
+  { price: { $lt: "100.00" } },
+  50,
+  undefined,
+  [{ field: "price", dir: "asc" }],
+));
+console.log(caps.count, "rows, cursor:", caps.next_cursor);
+
+// 3) Stream the full set
+for await (const chunk of nwp.stream(new QueryFrame("sha256:…"))) {
+  for (const row of chunk.data) { /* … */ }
+  if (chunk.isLast) break;
+}
+
+// 4) Fire an async action
+const resp = await nwp.invoke(new ActionFrame(
+  "restock",
+  { sku: "sku-4242", qty: 100 },
+  true,
+));
+// resp is AsyncActionResponse
+```
+
+---
+
+## `NwpErrorCodes`
+
+String constants for the 30 NWP wire error codes (added in alpha.5).
+
+```typescript
+import { NwpErrorCodes } from "@labacacia/nps-sdk/nwp";
+```
+
+### Auth group (`NWP-AUTH-*`)
+
+| Constant | Wire value |
+|----------|------------|
+| `NwpErrorCodes.AUTH_NID_SCOPE_VIOLATION` | `"NWP-AUTH-NID-SCOPE-VIOLATION"` |
+| `NwpErrorCodes.AUTH_NID_NOT_TRUSTED` | `"NWP-AUTH-NID-NOT-TRUSTED"` |
+| `NwpErrorCodes.AUTH_NID_EXPIRED` | `"NWP-AUTH-NID-EXPIRED"` |
+| `NwpErrorCodes.AUTH_NID_REVOKED` | `"NWP-AUTH-NID-REVOKED"` |
+| `NwpErrorCodes.AUTH_SIG_INVALID` | `"NWP-AUTH-SIG-INVALID"` |
+| `NwpErrorCodes.AUTH_TOKEN_BUDGET_EXCEEDED` | `"NWP-AUTH-TOKEN-BUDGET-EXCEEDED"` |
+| `NwpErrorCodes.AUTH_RATE_LIMIT` | `"NWP-AUTH-RATE-LIMIT"` |
+
+### Query group (`NWP-QUERY-*`)
+
+| Constant | Wire value |
+|----------|------------|
+| `NwpErrorCodes.QUERY_ANCHOR_NOT_FOUND` | `"NWP-QUERY-ANCHOR-NOT-FOUND"` |
+| `NwpErrorCodes.QUERY_ANCHOR_EXPIRED` | `"NWP-QUERY-ANCHOR-EXPIRED"` |
+| `NwpErrorCodes.QUERY_SCHEMA_MISMATCH` | `"NWP-QUERY-SCHEMA-MISMATCH"` |
+| `NwpErrorCodes.QUERY_LIMIT_EXCEEDED` | `"NWP-QUERY-LIMIT-EXCEEDED"` |
+| `NwpErrorCodes.QUERY_DEPTH_EXCEEDED` | `"NWP-QUERY-DEPTH-EXCEEDED"` |
+| `NwpErrorCodes.QUERY_FILTER_INVALID` | `"NWP-QUERY-FILTER-INVALID"` |
+| `NwpErrorCodes.QUERY_VECTOR_UNSUPPORTED` | `"NWP-QUERY-VECTOR-UNSUPPORTED"` |
+| `NwpErrorCodes.QUERY_CURSOR_INVALID` | `"NWP-QUERY-CURSOR-INVALID"` |
+
+### Action, Task, Subscribe, Infrastructure groups
+
+| Constant | Wire value |
+|----------|------------|
+| `NwpErrorCodes.ACTION_NOT_FOUND` | `"NWP-ACTION-NOT-FOUND"` |
+| `NwpErrorCodes.ACTION_PARAM_INVALID` | `"NWP-ACTION-PARAM-INVALID"` |
+| `NwpErrorCodes.ACTION_IDEMPOTENCY_CONFLICT` | `"NWP-ACTION-IDEMPOTENCY-CONFLICT"` |
+| `NwpErrorCodes.TASK_NOT_FOUND` | `"NWP-TASK-NOT-FOUND"` |
+| `NwpErrorCodes.TASK_ALREADY_COMPLETE` | `"NWP-TASK-ALREADY-COMPLETE"` |
+| `NwpErrorCodes.TASK_TIMEOUT` | `"NWP-TASK-TIMEOUT"` |
+| `NwpErrorCodes.TASK_CANCELLED` | `"NWP-TASK-CANCELLED"` |
+| `NwpErrorCodes.SUBSCRIBE_TOPIC_NOT_FOUND` | `"NWP-SUBSCRIBE-TOPIC-NOT-FOUND"` |
+| `NwpErrorCodes.SUBSCRIBE_ALREADY_ACTIVE` | `"NWP-SUBSCRIBE-ALREADY-ACTIVE"` |
+| `NwpErrorCodes.SUBSCRIBE_QUOTA_EXCEEDED` | `"NWP-SUBSCRIBE-QUOTA-EXCEEDED"` |
+| `NwpErrorCodes.SUBSCRIBE_FILTER_INVALID` | `"NWP-SUBSCRIBE-FILTER-INVALID"` |
+| `NwpErrorCodes.SUBSCRIBE_NOT_FOUND` | `"NWP-SUBSCRIBE-NOT-FOUND"` |
+| `NwpErrorCodes.INFRA_NODE_OVERLOADED` | `"NWP-INFRA-NODE-OVERLOADED"` |
+| `NwpErrorCodes.INFRA_UPSTREAM_TIMEOUT` | `"NWP-INFRA-UPSTREAM-TIMEOUT"` |
+| `NwpErrorCodes.INFRA_UPSTREAM_ERROR` | `"NWP-INFRA-UPSTREAM-ERROR"` |
+| `NwpErrorCodes.INFRA_STORAGE_ERROR` | `"NWP-INFRA-STORAGE-ERROR"` |
+| `NwpErrorCodes.INFRA_CONFIG_ERROR` | `"NWP-INFRA-CONFIG-ERROR"` |
+
+### Manifest, Topology, Reserved groups
+
+| Constant | Wire value |
+|----------|------------|
+| `NwpErrorCodes.MANIFEST_NOT_FOUND` | `"NWP-MANIFEST-NOT-FOUND"` |
+| `NwpErrorCodes.MANIFEST_PARSE_ERROR` | `"NWP-MANIFEST-PARSE-ERROR"` |
+| `NwpErrorCodes.MANIFEST_VERSION_MISMATCH` | `"NWP-MANIFEST-VERSION-MISMATCH"` |
+| `NwpErrorCodes.TOPOLOGY_UNAUTHORIZED` | `"NWP-TOPOLOGY-UNAUTHORIZED"` |
+| `NwpErrorCodes.TOPOLOGY_NOT_AVAILABLE` | `"NWP-TOPOLOGY-NOT-AVAILABLE"` |
+| `NwpErrorCodes.TOPOLOGY_SNAPSHOT_TOO_LARGE` | `"NWP-TOPOLOGY-SNAPSHOT-TOO-LARGE"` |
+| `NwpErrorCodes.TOPOLOGY_STREAM_INTERRUPTED` | `"NWP-TOPOLOGY-STREAM-INTERRUPTED"` |
+| `NwpErrorCodes.RESERVED_TYPE_UNSUPPORTED` | `"NWP-RESERVED-TYPE-UNSUPPORTED"` |