@labacacia/nps-sdk 1.0.0-alpha.5 → 1.0.0-alpha.7

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,47 +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",
-  NPS_SERVER_UNSUPPORTED: "NPS-SERVER-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 = "1.0.0-alpha.2";

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)",
-    );
-  }
-}

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

@@ -1,35 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// StreamFrame (0x03) — Streaming data chunks with flow control
-// NPS-1 §4.3
-
-import { NcpError } from "../../core/frame-header.js";
-
-export interface StreamFrame {
-  frame: string;
-  stream_id: string;
-  seq: number;
-  is_last: boolean;
-  anchor_ref?: string;
-  data: unknown[];
-  window_size?: number;
-  error_code?: string;
-}
-
-// UUID v4 format: xxxxxxxx-xxxx-4xxx-[89ab]xxx-xxxxxxxxxxxx
-const UUID_V4_RE =
-  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-
-/**
- * Validate stream_id is a valid UUID v4.
- * @throws {NcpError} NPS-CLIENT-BAD-FRAME if stream_id is not a valid UUID v4.
- */
-export function validateStreamFrame(frame: StreamFrame): void {
-  if (!UUID_V4_RE.test(frame.stream_id)) {
-    throw new NcpError(
-      "NPS-CLIENT-BAD-FRAME",
-      `stream_id "${frame.stream_id}" is not a valid UUID v4`,
-    );
-  }
-}

package/src/ncp/frames.ts

@@ -1,251 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-import { EncodingTier, FrameType } from "../core/frames.js";
-import type { NpsFrame } from "../core/codec.js";
-
-// ── FrameSchema ───────────────────────────────────────────────────────────────
-
-export interface SchemaField {
-  name:      string;
-  type:      string;
-  semantic?: string;
-  nullable?: boolean;
-}
-
-export interface FrameSchema {
-  fields: readonly SchemaField[];
-}
-
-// ── AnchorFrame ───────────────────────────────────────────────────────────────
-
-export class AnchorFrame implements NpsFrame {
-  readonly frameType     = FrameType.ANCHOR;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly anchorId: string,
-    public readonly schema:   FrameSchema,
-    public readonly ttl:      number = 3600,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      anchor_id: this.anchorId,
-      schema:    { fields: this.schema.fields.map((f) => ({ ...f })) },
-      ttl:       this.ttl,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): AnchorFrame {
-    const schemaRaw = data["schema"] as { fields: SchemaField[] };
-    return new AnchorFrame(
-      data["anchor_id"] as string,
-      { fields: schemaRaw.fields },
-      (data["ttl"] as number | undefined) ?? 3600,
-    );
-  }
-}
-
-// ── JsonPatchOperation ────────────────────────────────────────────────────────
-
-export interface JsonPatchOperation {
-  op:     string;
-  path:   string;
-  value?: unknown;
-}
-
-// ── DiffFrame ─────────────────────────────────────────────────────────────────
-
-export class DiffFrame implements NpsFrame {
-  readonly frameType     = FrameType.DIFF;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly anchorRef: string,
-    public readonly baseSeq:   number,
-    public readonly patch:     readonly JsonPatchOperation[],
-    public readonly entityId?: string,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      anchor_ref: this.anchorRef,
-      base_seq:   this.baseSeq,
-      patch:      this.patch.map((p) => ({ ...p })),
-      entity_id:  this.entityId ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): DiffFrame {
-    return new DiffFrame(
-      data["anchor_ref"] as string,
-      data["base_seq"]   as number,
-      data["patch"]      as JsonPatchOperation[],
-      (data["entity_id"] as string | null) ?? undefined,
-    );
-  }
-}
-
-// ── StreamFrame ───────────────────────────────────────────────────────────────
-
-export class StreamFrame implements NpsFrame {
-  readonly frameType     = FrameType.STREAM;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly streamId:   string,
-    public readonly seq:        number,
-    public readonly isLast:     boolean,
-    public readonly data:       readonly Record<string, unknown>[],
-    public readonly anchorRef?: string,
-    public readonly windowSize?: number,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      stream_id:   this.streamId,
-      seq:         this.seq,
-      is_last:     this.isLast,
-      data:        this.data,
-      anchor_ref:  this.anchorRef  ?? null,
-      window_size: this.windowSize ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): StreamFrame {
-    return new StreamFrame(
-      data["stream_id"]   as string,
-      data["seq"]         as number,
-      data["is_last"]     as boolean,
-      data["data"]        as Record<string, unknown>[],
-      (data["anchor_ref"]  as string | null)  ?? undefined,
-      (data["window_size"] as number | null)  ?? undefined,
-    );
-  }
-}
-
-// ── CapsFrame ─────────────────────────────────────────────────────────────────
-
-export class CapsFrame implements NpsFrame {
-  readonly frameType     = FrameType.CAPS;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly anchorRef:      string,
-    public readonly count:          number,
-    public readonly data:           readonly Record<string, unknown>[],
-    public readonly nextCursor?:    string,
-    public readonly tokenEst?:      number,
-    public readonly cached?:        boolean,
-    public readonly tokenizerUsed?: string,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      anchor_ref:      this.anchorRef,
-      count:           this.count,
-      data:            this.data,
-      next_cursor:     this.nextCursor    ?? null,
-      token_est:       this.tokenEst      ?? null,
-      cached:          this.cached        ?? null,
-      tokenizer_used:  this.tokenizerUsed ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): CapsFrame {
-    return new CapsFrame(
-      data["anchor_ref"]     as string,
-      data["count"]          as number,
-      data["data"]           as Record<string, unknown>[],
-      (data["next_cursor"]    as string | null) ?? undefined,
-      (data["token_est"]      as number | null) ?? undefined,
-      (data["cached"]         as boolean | null) ?? undefined,
-      (data["tokenizer_used"] as string | null) ?? undefined,
-    );
-  }
-}
-
-// ── ErrorFrame ────────────────────────────────────────────────────────────────
-
-export class ErrorFrame implements NpsFrame {
-  readonly frameType     = FrameType.ERROR;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly status:   string,
-    public readonly error:    string,
-    public readonly message?: string,
-    public readonly details?: Record<string, unknown>,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      status:  this.status,
-      error:   this.error,
-      message: this.message ?? null,
-      details: this.details ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): ErrorFrame {
-    return new ErrorFrame(
-      data["status"]  as string,
-      data["error"]   as string,
-      (data["message"] as string | null) ?? undefined,
-      (data["details"] as Record<string, unknown> | null) ?? undefined,
-    );
-  }
-}
-
-// ── HelloFrame ────────────────────────────────────────────────────────────────
-// NPS-1 §4.6 — Native-mode handshake (0x06). Always Tier-1 JSON: encoding
-// is not yet negotiated when this frame is sent.
-
-export class HelloFrame implements NpsFrame {
-  readonly frameType     = FrameType.HELLO;
-  readonly preferredTier = EncodingTier.JSON;
-
-  static readonly DEFAULT_MAX_FRAME_PAYLOAD      = 0xFFFF;
-  static readonly DEFAULT_MAX_CONCURRENT_STREAMS = 32;
-
-  constructor(
-    public readonly npsVersion:           string,
-    public readonly supportedEncodings:   readonly string[],
-    public readonly supportedProtocols:   readonly string[],
-    public          minVersion?:          string,
-    public          agentId?:             string,
-    public          maxFramePayload:      number = HelloFrame.DEFAULT_MAX_FRAME_PAYLOAD,
-    public          extSupport:           boolean = false,
-    public          maxConcurrentStreams: number = HelloFrame.DEFAULT_MAX_CONCURRENT_STREAMS,
-    public          e2eEncAlgorithms?:    readonly string[],
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      nps_version:            this.npsVersion,
-      supported_encodings:    [...this.supportedEncodings],
-      supported_protocols:    [...this.supportedProtocols],
-      min_version:            this.minVersion ?? null,
-      agent_id:               this.agentId    ?? null,
-      max_frame_payload:      this.maxFramePayload,
-      ext_support:            this.extSupport,
-      max_concurrent_streams: this.maxConcurrentStreams,
-      e2e_enc_algorithms:     this.e2eEncAlgorithms ? [...this.e2eEncAlgorithms] : null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): HelloFrame {
-    return new HelloFrame(
-      data["nps_version"]         as string,
-      (data["supported_encodings"] as string[]) ?? [],
-      (data["supported_protocols"] as string[]) ?? [],
-      (data["min_version"]        as string | null) ?? undefined,
-      (data["agent_id"]           as string | null) ?? undefined,
-      (data["max_frame_payload"]  as number | null) ?? HelloFrame.DEFAULT_MAX_FRAME_PAYLOAD,
-      (data["ext_support"]        as boolean | null) ?? false,
-      (data["max_concurrent_streams"] as number | null) ?? HelloFrame.DEFAULT_MAX_CONCURRENT_STREAMS,
-      (data["e2e_enc_algorithms"] as string[] | null) ?? undefined,
-    );
-  }
-}