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

package/src/core/frame-registry.ts

@@ -1,91 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// NCP Frame Registry — Maps frame type bytes to protocol identifiers
-// NPS-0 §9 Unified frame namespace
-
-import { FrameType, NcpError } from "./frame-header.js";
-
-// ---------------------------------------------------------------------------
-// Protocol identifier for routing
-// ---------------------------------------------------------------------------
-
-export type Protocol = "ncp" | "nwp" | "nip" | "ndp" | "nop" | "system";
-
-export interface FrameRegistryEntry {
-  /** Frame type byte. */
-  frameType: number;
-  /** Human-readable name. */
-  name: string;
-  /** Protocol this frame belongs to. */
-  protocol: Protocol;
-}
-
-// ---------------------------------------------------------------------------
-// Registry
-// ---------------------------------------------------------------------------
-
-/**
- * Maps frame type bytes to metadata.
- * Built once at startup, then read-only.
- */
-export class FrameRegistry {
-  private readonly map: Map<number, FrameRegistryEntry>;
-
-  constructor(entries: FrameRegistryEntry[]) {
-    this.map = new Map(entries.map((e) => [e.frameType, e]));
-  }
-
-  /**
-   * Resolve a frame type byte to its registry entry.
-   * @throws {NcpError} NCP-FRAME-UNKNOWN-TYPE if not registered.
-   */
-  resolve(frameType: number): FrameRegistryEntry {
-    const entry = this.map.get(frameType);
-    if (!entry) {
-      throw new NcpError(
-        "NCP-FRAME-UNKNOWN-TYPE",
-        `No entry registered for frame type 0x${frameType.toString(16).padStart(2, "0")}`,
-      );
-    }
-    return entry;
-  }
-
-  /** Check if a frame type is registered. */
-  has(frameType: number): boolean {
-    return this.map.has(frameType);
-  }
-
-  /**
-   * Create a registry pre-populated with all NCP core frames.
-   * Upper-layer protocols can extend via the builder.
-   */
-  static createDefault(): FrameRegistry {
-    return new FrameRegistryBuilder()
-      .add(FrameType.Anchor, "AnchorFrame", "ncp")
-      .add(FrameType.Diff, "DiffFrame", "ncp")
-      .add(FrameType.Stream, "StreamFrame", "ncp")
-      .add(FrameType.Caps, "CapsFrame", "ncp")
-      .add(FrameType.Align, "AlignFrame", "ncp") // deprecated
-      .add(FrameType.Hello, "HelloFrame", "ncp")
-      .add(FrameType.Error, "ErrorFrame", "system")
-      .build();
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Builder
-// ---------------------------------------------------------------------------
-
-export class FrameRegistryBuilder {
-  private readonly entries: FrameRegistryEntry[] = [];
-
-  add(frameType: number, name: string, protocol: Protocol): this {
-    this.entries.push({ frameType, name, protocol });
-    return this;
-  }
-
-  build(): FrameRegistry {
-    return new FrameRegistry(this.entries);
-  }
-}

package/src/core/frames.ts

@@ -1,183 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-/**
- * NPS wire-level frame primitives: FrameType, FrameFlags, EncodingTier, FrameHeader.
- */
-
-import { NpsFrameError } from "./exceptions.js";
-
-// ── FrameType ────────────────────────────────────────────────────────────────
-
-/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
-export enum FrameType {
-  // NCP  0x01–0x0F
-  ANCHOR       = 0x01,
-  DIFF         = 0x02,
-  STREAM       = 0x03,
-  CAPS         = 0x04,
-  ALIGN        = 0x05, // deprecated — use AlignStream (0x43)
-
-  // NWP  0x10–0x1F
-  QUERY        = 0x10,
-  ACTION       = 0x11,
-
-  // NIP  0x20–0x2F
-  IDENT        = 0x20,
-  TRUST        = 0x21,
-  REVOKE       = 0x22,
-
-  // NDP  0x30–0x3F
-  ANNOUNCE     = 0x30,
-  RESOLVE      = 0x31,
-  GRAPH        = 0x32,
-
-  // NOP  0x40–0x4F
-  TASK         = 0x40,
-  DELEGATE     = 0x41,
-  SYNC         = 0x42,
-  ALIGN_STREAM = 0x43,
-
-  // Reserved / System  0xF0–0xFF
-  ERROR        = 0xFE,
-}
-
-// ── EncodingTier ─────────────────────────────────────────────────────────────
-
-/**
- * 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.
- */
-export enum EncodingTier {
-  JSON    = 0x00,
-  MSGPACK = 0x01,
-}
-
-// ── FrameFlags ───────────────────────────────────────────────────────────────
-
-/**
- * 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
- */
-export const FrameFlags = {
-  NONE:          0x00,
-  TIER1_JSON:    0x00,
-  TIER2_MSGPACK: 0x01,
-  FINAL:         0x04,
-  ENCRYPTED:     0x08,
-  EXT:           0x80,
-} as const;
-
-// ── Constants ─────────────────────────────────────────────────────────────────
-
-export const DEFAULT_HEADER_SIZE  = 4;
-export const EXTENDED_HEADER_SIZE = 8;
-export const DEFAULT_MAX_PAYLOAD  = 0xffff;        // 65 535 bytes
-export const EXTENDED_MAX_PAYLOAD = 0xffffffff;    // 4 GiB - 1
-
-// ── FrameHeader ──────────────────────────────────────────────────────────────
-
-/**
- * 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)
- */
-export class FrameHeader {
-  constructor(
-    public readonly frameType: FrameType,
-    public readonly flags: number,
-    public readonly payloadLength: number,
-  ) {}
-
-  get isExtended(): boolean {
-    return (this.flags & FrameFlags.EXT) !== 0;
-  }
-
-  get headerSize(): number {
-    return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
-  }
-
-  get encodingTier(): EncodingTier {
-    return (this.flags & 0x03) as EncodingTier;
-  }
-
-  get isFinal(): boolean {
-    return (this.flags & 0x04) !== 0;
-  }
-
-  get isEncrypted(): boolean {
-    return (this.flags & 0x08) !== 0;
-  }
-
-  // ── Parsing ───────────────────────────────────────────────────────────────
-
-  static parse(buf: Uint8Array): FrameHeader {
-    if (buf.length < 2) {
-      throw new NpsFrameError(
-        `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`,
-      );
-    }
-
-    const flags = buf[1]!;
-    const ext   = (flags & FrameFlags.EXT) !== 0;
-
-    if (ext) {
-      if (buf.length < EXTENDED_HEADER_SIZE) {
-        throw new NpsFrameError(
-          `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`,
-        );
-      }
-      const view = new DataView(buf.buffer, buf.byteOffset);
-      const payloadLength = view.getUint32(4, false); // big-endian
-      return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);
-    }
-
-    if (buf.length < DEFAULT_HEADER_SIZE) {
-      throw new NpsFrameError(
-        `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`,
-      );
-    }
-    const view = new DataView(buf.buffer, buf.byteOffset);
-    const payloadLength = view.getUint16(2, false); // big-endian
-    return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);
-  }
-
-  // ── Serialisation ─────────────────────────────────────────────────────────
-
-  toBytes(): Uint8Array {
-    if (this.isExtended) {
-      const buf  = new Uint8Array(EXTENDED_HEADER_SIZE);
-      const view = new DataView(buf.buffer);
-      view.setUint8(0, this.frameType);
-      view.setUint8(1, this.flags);
-      view.setUint16(2, 0, false);             // reserved
-      view.setUint32(4, this.payloadLength, false);
-      return buf;
-    }
-    const buf  = new Uint8Array(DEFAULT_HEADER_SIZE);
-    const view = new DataView(buf.buffer);
-    view.setUint8(0, this.frameType);
-    view.setUint8(1, this.flags);
-    view.setUint16(2, this.payloadLength, false);
-    return buf;
-  }
-
-  toString(): string {
-    return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
-  }
-}

package/src/core/index.ts

@@ -1,10 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-export * from "./frame-header.js";
-export * from "./frame-registry.js";
-export * from "./anchor-cache.js";
-export * from "./exceptions.js";
-export * from "./status-codes.js";
-export { jcsStringify, sortKeysStringify } from "./canonical-json.js";
-export type { CryptoProvider } from "./crypto-provider.js";
-export * from "./codecs/index.js";

package/src/core/registry.ts

@@ -1,28 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-import { NpsFrameError } from "./exceptions.js";
-import { FrameType } from "./frames.js";
-import type { NpsFrame } from "./codec.js";
-
-export interface FrameClass {
-  fromDict(data: Record<string, unknown>): NpsFrame;
-}
-
-export class FrameRegistry {
-  private readonly _map = new Map<FrameType, FrameClass>();
-
-  register(frameType: FrameType, cls: FrameClass): void {
-    this._map.set(frameType, cls);
-  }
-
-  resolve(frameType: FrameType): FrameClass {
-    const cls = this._map.get(frameType);
-    if (cls === undefined) {
-      throw new NpsFrameError(
-        `No frame class registered for type 0x${frameType.toString(16).padStart(2, "0")}.`,
-      );
-    }
-    return cls;
-  }
-}

package/src/core/status-codes.ts

@@ -1,46 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// NPS native status codes — per spec/status-codes.md
-
-/** NPS native status code constants. */
-export const 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",
-} as const;
-
-export type NpsStatusCode = (typeof NpsStatusCodes)[keyof typeof NpsStatusCodes];

package/src/index.ts

@@ -1,10 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// @labacacia/nps-sdk — root entry point.
-// Mirrors Python root __init__.py: exports only the SDK version.
-// All protocol APIs are accessed via sub-package imports:
-//   import { ... } from "@labacacia/nps-sdk/core"
-//   import { ... } from "@labacacia/nps-sdk/ncp"
-
-export const VERSION = "0.1.0";

package/src/ncp/frames/anchor-frame.ts

@@ -1,87 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// AnchorFrame (0x01) — Schema anchor for global reference
-// NPS-1 §4.1
-
-import { createHash } from "node:crypto";
-// canonicalize ships CJS with TS `export default` — NodeNext resolves as namespace
-import canonicalizeDefault from "canonicalize";
-const canonicalize = canonicalizeDefault as unknown as (input: unknown) => string | undefined;
-import { NcpError } from "../../core/frame-header.js";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-const VALID_FIELD_TYPES = [
-  "string", "uint64", "int64", "decimal", "bool",
-  "timestamp", "bytes", "object", "array",
-] as const;
-
-export type SchemaFieldType = (typeof VALID_FIELD_TYPES)[number];
-
-export interface SchemaField {
-  name: string;
-  type: string;
-  semantic?: string;
-  nullable?: boolean;
-}
-
-export interface FrameSchema {
-  fields: SchemaField[];
-}
-
-export interface AnchorFrame {
-  frame: string;
-  anchor_id: string;
-  schema: FrameSchema;
-  ttl?: number;
-}
-
-// ---------------------------------------------------------------------------
-// anchor_id computation (RFC 8785 JCS + SHA-256)
-// ---------------------------------------------------------------------------
-
-/**
- * Compute anchor_id from schema using RFC 8785 JCS canonicalization + SHA-256.
- * Format: "sha256:{64 lowercase hex chars}"
- */
-export function computeAnchorId(schema: FrameSchema): string {
-  const canonical = canonicalize(schema);
-  if (!canonical) {
-    throw new NcpError("NCP-ANCHOR-SCHEMA-INVALID", "Schema cannot be canonicalized");
-  }
-  const hash = createHash("sha256").update(canonical).digest("hex");
-  return `sha256:${hash}`;
-}
-
-// ---------------------------------------------------------------------------
-// Validation
-// ---------------------------------------------------------------------------
-
-/**
- * Validate an AnchorFrame.
- * @throws {NcpError} NCP-ANCHOR-SCHEMA-INVALID if anchor_id doesn't match or schema is invalid.
- */
-export function validateAnchorFrame(frame: AnchorFrame): void {
-  // Validate schema field types
-  for (const field of frame.schema.fields) {
-    if (!VALID_FIELD_TYPES.includes(field.type as SchemaFieldType)) {
-      throw new NcpError(
-        "NCP-ANCHOR-SCHEMA-INVALID",
-        `Unsupported field type "${field.type}" for field "${field.name}". ` +
-          `Valid types: ${VALID_FIELD_TYPES.join(", ")}`,
-      );
-    }
-  }
-
-  // Validate anchor_id matches computed hash
-  const expected = computeAnchorId(frame.schema);
-  if (frame.anchor_id !== expected) {
-    throw new NcpError(
-      "NCP-ANCHOR-SCHEMA-INVALID",
-      `anchor_id mismatch: expected ${expected}, got ${frame.anchor_id}`,
-    );
-  }
-}

package/src/ncp/frames/caps-frame.ts

@@ -1,59 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// CapsFrame (0x04) — Capsule response envelope
-// NPS-1 §4.4
-
-import { NcpError } from "../../core/frame-header.js";
-import {
-  computeAnchorId,
-  type AnchorFrame,
-  type FrameSchema,
-} from "./anchor-frame.js";
-
-export interface CapsFrameInlineAnchor {
-  anchor_id: string;
-  schema: FrameSchema;
-  ttl?: number;
-}
-
-export interface CapsFrame {
-  frame: string;
-  anchor_ref: string;
-  count: number;
-  data: unknown[];
-  next_cursor?: string | null;
-  token_est?: number;
-  tokenizer_used?: string;
-  cached?: boolean;
-  inline_anchor?: CapsFrameInlineAnchor;
-}
-
-/**
- * Validate a CapsFrame.
- *
- * Checks:
- * - count matches data.length (NPS-CLIENT-BAD-FRAME)
- * - if inline_anchor present, recomputes anchor_id and validates match (NCP-ANCHOR-SCHEMA-INVALID)
- *
- * @throws {NcpError} NPS-CLIENT-BAD-FRAME if count doesn't match data length.
- * @throws {NcpError} NCP-ANCHOR-SCHEMA-INVALID if inline_anchor.anchor_id doesn't match schema.
- */
-export function validateCapsFrame(frame: CapsFrame): void {
-  if (frame.count !== frame.data.length) {
-    throw new NcpError(
-      "NPS-CLIENT-BAD-FRAME",
-      `CapsFrame count mismatch: count=${frame.count}, data.length=${frame.data.length}`,
-    );
-  }
-
-  if (frame.inline_anchor !== undefined) {
-    const computed = computeAnchorId(frame.inline_anchor.schema);
-    if (frame.inline_anchor.anchor_id !== computed) {
-      throw new NcpError(
-        "NCP-ANCHOR-SCHEMA-INVALID",
-        `inline_anchor anchor_id mismatch: expected ${computed}, got ${frame.inline_anchor.anchor_id}`,
-      );
-    }
-  }
-}

package/src/ncp/frames/diff-frame.ts

@@ -1,69 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// DiffFrame (0x02) — Incremental data patch
-// NPS-1 §4.2
-
-import { NcpError, EncodingTier } from "../../core/frame-header.js";
-import { isValidPatchFormat, type PatchFormat } from "../ncp-patch-format.js";
-
-export interface JsonPatchOperation {
-  op: "add" | "remove" | "replace" | "move" | "copy" | "test";
-  path: string;
-  value?: unknown;
-  from?: string;
-}
-
-export interface DiffFrame {
-  frame: string;
-  anchor_ref: string;
-  base_seq: number;
-  patch_format?: PatchFormat;
-  patch: JsonPatchOperation[] | Uint8Array;
-  entity_id?: string;
-}
-
-/**
- * Validate DiffFrame base_seq against current sequence.
- * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequences don't match.
- */
-export function validateDiffSeq(frame: DiffFrame, currentSeq: number): void {
-  if (frame.base_seq !== currentSeq) {
-    throw new NcpError(
-      "NCP-STREAM-SEQ-GAP",
-      `DiffFrame base_seq=${frame.base_seq} does not match current seq=${currentSeq}`,
-    );
-  }
-}
-
-/**
- * Validate DiffFrame patch_format against the encoding tier.
- *
- * binary_bitset is only supported on Tier-2 (MsgPack) frames.
- * Unknown patch_format values are also rejected.
- *
- * @throws {NcpError} NCP-DIFF-FORMAT-UNSUPPORTED if binary_bitset on non-Tier-2,
- *   or if patch_format is an unknown value.
- */
-export function validateDiffFrame(
-  frame: DiffFrame,
-  encodingTier: EncodingTier | number,
-): void {
-  const fmt = frame.patch_format;
-
-  // Unknown patch_format
-  if (fmt !== undefined && !isValidPatchFormat(fmt)) {
-    throw new NcpError(
-      "NCP-DIFF-FORMAT-UNSUPPORTED",
-      `Unknown patch_format "${String(fmt)}"`,
-    );
-  }
-
-  // binary_bitset requires Tier-2 MsgPack
-  if (fmt === "binary_bitset" && encodingTier !== EncodingTier.MsgPack) {
-    throw new NcpError(
-      "NCP-DIFF-FORMAT-UNSUPPORTED",
-      "patch_format=binary_bitset requires Tier-2 MsgPack encoding",
-    );
-  }
-}

package/src/ncp/frames/error-frame.ts

@@ -1,26 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// ErrorFrame (0xFE) — Unified error frame for all NPS protocol layers
-// NPS-1 §4.7
-
-/** Unified error frame shared across all NPS protocol layers. */
-export interface ErrorFrame {
-  /** Fixed value "0xFE". */
-  frame: string;
-  /** NPS status code, e.g. "NPS-CLIENT-NOT-FOUND". */
-  status: string;
-  /** Protocol-level error code, e.g. "NCP-ANCHOR-NOT-FOUND". */
-  error: string;
-  /** Human-readable error description. */
-  message?: string;
-  /** Structured error details (e.g. anchor_ref, stream_id). */
-  details?: Record<string, unknown>;
-}
-
-/** Type guard for ErrorFrame. */
-export function isErrorFrame(obj: unknown): obj is ErrorFrame {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj as Record<string, unknown>;
-  return o.frame === "0xFE" && typeof o.status === "string" && typeof o.error === "string";
-}

package/src/ncp/frames/hello-frame.ts

@@ -1,50 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// HelloFrame (0x06) — Native-mode client handshake
-// NPS-1 §4.6
-
-import { NcpError } from "../../core/frame-header.js";
-
-export interface HelloFrame {
-  frame: string;
-  nps_version: string;
-  min_version?: string;
-  supported_encodings: string[];
-  supported_protocols: string[];
-  agent_id?: string;
-  max_frame_payload?: number;
-  ext_support?: boolean;
-  max_concurrent_streams?: number;
-  e2e_enc_algorithms?: string[];
-}
-
-/**
- * Validate a HelloFrame.
- *
- * Required fields: nps_version, supported_encodings (non-empty), supported_protocols (non-empty).
- *
- * @throws {NcpError} NPS-CLIENT-BAD-FRAME if any required field is missing or empty.
- */
-export function validateHelloFrame(frame: HelloFrame): void {
-  if (!frame.nps_version) {
-    throw new NcpError(
-      "NPS-CLIENT-BAD-FRAME",
-      "HelloFrame missing required field: nps_version",
-    );
-  }
-
-  if (!frame.supported_encodings || frame.supported_encodings.length === 0) {
-    throw new NcpError(
-      "NPS-CLIENT-BAD-FRAME",
-      "HelloFrame missing required field: supported_encodings (must be non-empty)",
-    );
-  }
-
-  if (!frame.supported_protocols || frame.supported_protocols.length === 0) {
-    throw new NcpError(
-      "NPS-CLIENT-BAD-FRAME",
-      "HelloFrame missing required field: supported_protocols (must be non-empty)",
-    );
-  }
-}