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

package/dist/ncp/index.cjs

@@ -1,388 +0,0 @@
-'use strict';
-
-var crypto = require('crypto');
-var canonicalizeDefault = require('canonicalize');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var canonicalizeDefault__default = /*#__PURE__*/_interopDefault(canonicalizeDefault);
-
-// src/ncp/frames/anchor-frame.ts
-
-// src/core/frame-header.ts
-var NcpError = class extends Error {
-  // `code` accepts NcpErrorCode constants (preferred) as well as NPS status
-  // strings that are not NCP-prefixed (e.g. "NPS-CLIENT-CONFLICT") for cases
-  // where the spec delegates to NPS-level codes without assigning an NCP code.
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-    this.name = "NcpError";
-  }
-  code;
-};
-
-// src/ncp/frames/anchor-frame.ts
-var canonicalize = canonicalizeDefault__default.default;
-var VALID_FIELD_TYPES = [
-  "string",
-  "uint64",
-  "int64",
-  "decimal",
-  "bool",
-  "timestamp",
-  "bytes",
-  "object",
-  "array"
-];
-function computeAnchorId(schema) {
-  const canonical = canonicalize(schema);
-  if (!canonical) {
-    throw new NcpError("NCP-ANCHOR-SCHEMA-INVALID", "Schema cannot be canonicalized");
-  }
-  const hash = crypto.createHash("sha256").update(canonical).digest("hex");
-  return `sha256:${hash}`;
-}
-function validateAnchorFrame(frame) {
-  for (const field of frame.schema.fields) {
-    if (!VALID_FIELD_TYPES.includes(field.type)) {
-      throw new NcpError(
-        "NCP-ANCHOR-SCHEMA-INVALID",
-        `Unsupported field type "${field.type}" for field "${field.name}". Valid types: ${VALID_FIELD_TYPES.join(", ")}`
-      );
-    }
-  }
-  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}`
-    );
-  }
-}
-
-// src/ncp/frames/caps-frame.ts
-function validateCapsFrame(frame) {
-  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 !== void 0) {
-    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}`
-      );
-    }
-  }
-}
-
-// src/ncp/ncp-patch-format.ts
-var PATCH_FORMAT = {
-  JSON_PATCH: "json_patch",
-  BINARY_BITSET: "binary_bitset"
-};
-function isValidPatchFormat(v) {
-  return v === PATCH_FORMAT.JSON_PATCH || v === PATCH_FORMAT.BINARY_BITSET;
-}
-
-// src/ncp/frames/diff-frame.ts
-function validateDiffSeq(frame, currentSeq) {
-  if (frame.base_seq !== currentSeq) {
-    throw new NcpError(
-      "NCP-STREAM-SEQ-GAP",
-      `DiffFrame base_seq=${frame.base_seq} does not match current seq=${currentSeq}`
-    );
-  }
-}
-function validateDiffFrame(frame, encodingTier) {
-  const fmt = frame.patch_format;
-  if (fmt !== void 0 && !isValidPatchFormat(fmt)) {
-    throw new NcpError(
-      "NCP-DIFF-FORMAT-UNSUPPORTED",
-      `Unknown patch_format "${String(fmt)}"`
-    );
-  }
-  if (fmt === "binary_bitset" && encodingTier !== 1 /* MsgPack */) {
-    throw new NcpError(
-      "NCP-DIFF-FORMAT-UNSUPPORTED",
-      "patch_format=binary_bitset requires Tier-2 MsgPack encoding"
-    );
-  }
-}
-
-// src/ncp/frames/error-frame.ts
-function isErrorFrame(obj) {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj;
-  return o.frame === "0xFE" && typeof o.status === "string" && typeof o.error === "string";
-}
-
-// src/ncp/frames/hello-frame.ts
-function validateHelloFrame(frame) {
-  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)"
-    );
-  }
-}
-
-// src/ncp/frames/stream-frame.ts
-var 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;
-function validateStreamFrame(frame) {
-  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`
-    );
-  }
-}
-
-// src/ncp/ncp-error-codes.ts
-var NCP_ERROR_CODES = {
-  // Implementation-only codes (not in spec §6 — see test_results.md spec question 2)
-  NCP_FRAME_PARSE_ERROR: "NCP-FRAME-PARSE-ERROR",
-  NCP_FRAME_INCOMPLETE: "NCP-FRAME-INCOMPLETE",
-  // Spec-defined codes
-  NCP_FRAME_UNKNOWN_TYPE: "NCP-FRAME-UNKNOWN-TYPE",
-  NCP_FRAME_PAYLOAD_TOO_LARGE: "NCP-FRAME-PAYLOAD-TOO-LARGE",
-  NCP_FRAME_FLAGS_INVALID: "NCP-FRAME-FLAGS-INVALID",
-  NCP_ANCHOR_NOT_FOUND: "NCP-ANCHOR-NOT-FOUND",
-  NCP_ANCHOR_SCHEMA_INVALID: "NCP-ANCHOR-SCHEMA-INVALID",
-  NCP_ANCHOR_ID_MISMATCH: "NCP-ANCHOR-ID-MISMATCH",
-  NCP_ANCHOR_STALE: "NCP-ANCHOR-STALE",
-  NCP_STREAM_SEQ_GAP: "NCP-STREAM-SEQ-GAP",
-  NCP_STREAM_NOT_FOUND: "NCP-STREAM-NOT-FOUND",
-  NCP_STREAM_LIMIT_EXCEEDED: "NCP-STREAM-LIMIT-EXCEEDED",
-  NCP_STREAM_WINDOW_OVERFLOW: "NCP-STREAM-WINDOW-OVERFLOW",
-  NCP_ENCODING_UNSUPPORTED: "NCP-ENCODING-UNSUPPORTED",
-  NCP_DIFF_FORMAT_UNSUPPORTED: "NCP-DIFF-FORMAT-UNSUPPORTED",
-  NCP_VERSION_INCOMPATIBLE: "NCP-VERSION-INCOMPATIBLE",
-  NCP_ENC_NOT_NEGOTIATED: "NCP-ENC-NOT-NEGOTIATED",
-  NCP_ENC_AUTH_FAILED: "NCP-ENC-AUTH-FAILED"
-};
-
-// src/ncp/handshake.ts
-function parseVersion(v) {
-  return v.split(".").map((p) => Number.parseInt(p, 10));
-}
-function compareVersions(a, b) {
-  const partsA = parseVersion(a);
-  const partsB = parseVersion(b);
-  const len = Math.max(partsA.length, partsB.length);
-  for (let i = 0; i < len; i += 1) {
-    const x = partsA[i] ?? 0;
-    const y = partsB[i] ?? 0;
-    if (x !== y) return x - y;
-  }
-  return 0;
-}
-function negotiateVersion(client, server) {
-  const clientMin = client.min_version ?? client.nps_version;
-  const serverVersion = server.nps_version;
-  if (compareVersions(clientMin, serverVersion) > 0) {
-    return {
-      session_version: serverVersion,
-      compatible: false,
-      error_code: "NCP-VERSION-INCOMPATIBLE"
-    };
-  }
-  const sessionVersion = compareVersions(client.nps_version, serverVersion) <= 0 ? client.nps_version : serverVersion;
-  return { session_version: sessionVersion, compatible: true };
-}
-function negotiateEncoding(client, server) {
-  const serverSet = new Set(server);
-  if (client.includes("msgpack") && serverSet.has("msgpack")) {
-    return { encoding: "msgpack" };
-  }
-  if (client.includes("json") && serverSet.has("json")) {
-    return { encoding: "json" };
-  }
-  for (const enc of client) {
-    if (serverSet.has(enc)) {
-      return { encoding: enc };
-    }
-  }
-  return { encoding: null };
-}
-
-// src/ncp/stream-manager.ts
-var StreamManager = class {
-  streams = /* @__PURE__ */ new Map();
-  outgoing = /* @__PURE__ */ new Map();
-  maxConcurrent;
-  constructor(options) {
-    this.maxConcurrent = options?.maxConcurrent ?? 32;
-  }
-  /**
-   * Receive a StreamFrame chunk.
-   *
-   * @returns true if stream is complete (is_last=true or error_code set).
-   * @throws {NcpError} NCP-STREAM-LIMIT-EXCEEDED if too many concurrent streams.
-   * @throws {NcpError} NCP-STREAM-NOT-FOUND if frame.seq > 0 for a stream that was never opened.
-   * @throws {NcpError} NPS-CLIENT-CONFLICT if the stream_id was already completed (stream-id reuse; see test_cases NCP-S-04).
-   * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequence number is not expected.
-   */
-  receive(frame) {
-    let stream = this.streams.get(frame.stream_id);
-    if (!stream) {
-      if (frame.seq !== 0) {
-        throw new NcpError(
-          NCP_ERROR_CODES.NCP_STREAM_NOT_FOUND,
-          `Unknown stream_id ${frame.stream_id} \u2014 first frame must have seq=0`
-        );
-      }
-      if (this.streams.size >= this.maxConcurrent) {
-        throw new NcpError(
-          NCP_ERROR_CODES.NCP_STREAM_LIMIT_EXCEEDED,
-          `Max concurrent streams (${this.maxConcurrent}) exceeded`
-        );
-      }
-      stream = {
-        streamId: frame.stream_id,
-        expectedSeq: 0,
-        chunks: [],
-        completed: false
-      };
-      this.streams.set(frame.stream_id, stream);
-    }
-    if (stream.completed) {
-      throw new NcpError(
-        "NPS-CLIENT-CONFLICT",
-        `Stream ${frame.stream_id} is already completed \u2014 cannot reuse stream_id`
-      );
-    }
-    if (frame.seq !== stream.expectedSeq) {
-      if (frame.seq < stream.expectedSeq) {
-        return false;
-      }
-      throw new NcpError(
-        NCP_ERROR_CODES.NCP_STREAM_SEQ_GAP,
-        `Expected seq ${stream.expectedSeq}, got ${frame.seq} on stream ${frame.stream_id}`
-      );
-    }
-    stream.chunks.push(frame.data);
-    stream.expectedSeq = frame.seq + 1;
-    if (frame.error_code) {
-      stream.completed = true;
-      stream.errorCode = frame.error_code;
-      return true;
-    }
-    if (frame.is_last) {
-      stream.completed = true;
-      return true;
-    }
-    return false;
-  }
-  /**
-   * Send a StreamFrame on an outgoing stream, enforcing window-based flow control.
-   *
-   * - seq=0 with window_size initialises remainingWindow (no decrement for opening frame).
-   * - Subsequent sends decrement remainingWindow when flow control is active.
-   * - Throws NCP-STREAM-WINDOW-OVERFLOW when remainingWindow === 0.
-   *
-   * @throws {NcpError} NCP-STREAM-WINDOW-OVERFLOW if window is exhausted.
-   */
-  send(frame) {
-    let out = this.outgoing.get(frame.stream_id);
-    if (!out) {
-      out = {
-        streamId: frame.stream_id,
-        remainingWindow: void 0,
-        paused: false
-      };
-      this.outgoing.set(frame.stream_id, out);
-    }
-    if (frame.seq === 0 && frame.window_size !== void 0) {
-      out.remainingWindow = frame.window_size;
-      return;
-    }
-    if (out.remainingWindow !== void 0) {
-      if (out.remainingWindow === 0) {
-        throw new NcpError(
-          NCP_ERROR_CODES.NCP_STREAM_WINDOW_OVERFLOW,
-          `Window exhausted on stream ${frame.stream_id}`
-        );
-      }
-      out.remainingWindow -= 1;
-    }
-  }
-  /**
-   * Update the send window for a stream.
-   *
-   * Called when a reverse-direction StreamFrame arrives with data=[] and window_size set.
-   * Replaces remainingWindow with new_size. Sets paused=true when new_size === 0.
-   */
-  updateWindow(streamId, newSize) {
-    let out = this.outgoing.get(streamId);
-    if (!out) {
-      out = {
-        streamId,
-        remainingWindow: newSize,
-        paused: newSize === 0
-      };
-      this.outgoing.set(streamId, out);
-      return;
-    }
-    out.remainingWindow = newSize;
-    out.paused = newSize === 0;
-  }
-  /**
-   * Returns true when the outgoing stream is paused (window=0 was received).
-   * Resumes (returns false) once a non-zero window update arrives.
-   */
-  isPaused(streamId) {
-    return this.outgoing.get(streamId)?.paused ?? false;
-  }
-  /** Get reassembled data for a completed stream. */
-  getData(streamId) {
-    const stream = this.streams.get(streamId);
-    if (!stream || !stream.completed) return null;
-    return stream.chunks.flat();
-  }
-  /** Get error code if stream terminated with error. */
-  getError(streamId) {
-    return this.streams.get(streamId)?.errorCode;
-  }
-  /** Number of active (non-completed) streams. */
-  get activeCount() {
-    let count = 0;
-    for (const s of this.streams.values()) {
-      if (!s.completed) count++;
-    }
-    return count;
-  }
-};
-
-exports.NCP_ERROR_CODES = NCP_ERROR_CODES;
-exports.PATCH_FORMAT = PATCH_FORMAT;
-exports.StreamManager = StreamManager;
-exports.computeAnchorId = computeAnchorId;
-exports.isErrorFrame = isErrorFrame;
-exports.isValidPatchFormat = isValidPatchFormat;
-exports.negotiateEncoding = negotiateEncoding;
-exports.negotiateVersion = negotiateVersion;
-exports.validateAnchorFrame = validateAnchorFrame;
-exports.validateCapsFrame = validateCapsFrame;
-exports.validateDiffFrame = validateDiffFrame;
-exports.validateDiffSeq = validateDiffSeq;
-exports.validateHelloFrame = validateHelloFrame;
-exports.validateStreamFrame = validateStreamFrame;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/ncp/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/frame-header.ts","../../src/ncp/frames/anchor-frame.ts","../../src/ncp/frames/caps-frame.ts","../../src/ncp/ncp-patch-format.ts","../../src/ncp/frames/diff-frame.ts","../../src/ncp/frames/error-frame.ts","../../src/ncp/frames/hello-frame.ts","../../src/ncp/frames/stream-frame.ts","../../src/ncp/ncp-error-codes.ts","../../src/ncp/handshake.ts","../../src/ncp/stream-manager.ts"],"names":["canonicalizeDefault","createHash"],"mappings":"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","file":"index.cjs","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// NCP Frame Header — Binary parse/write for NPS wire format\n// NPS-1 Neural Communication Protocol §3.1, §3.2\n\n// ---------------------------------------------------------------------------\n// Enums\n// ---------------------------------------------------------------------------\n\n/** Wire encoding tier (NPS-1 §3.2, flags bits 0-1). */\nexport enum EncodingTier {\n  /** Tier-1: UTF-8 JSON — development & compatibility. */\n  Json = 0x00,\n  /** Tier-2: MessagePack binary — production (~60% compression). */\n  MsgPack = 0x01,\n  // 0x02 = Reserved\n  // 0x03 = Reserved\n}\n\n/** Unified frame type namespace for the full NPS suite (NPS-0 §9). */\nexport enum FrameType {\n  // NCP 0x01–0x0F\n  Anchor = 0x01,\n  Diff = 0x02,\n  Stream = 0x03,\n  Caps = 0x04,\n  Align = 0x05, // deprecated — use AlignStream (0x43)\n  Hello = 0x06,\n  // NWP 0x10–0x1F\n  Query = 0x10,\n  Action = 0x11,\n  Subscribe = 0x12,\n  // NIP 0x20–0x2F\n  Ident = 0x20,\n  Trust = 0x21,\n  Revoke = 0x22,\n  // NDP 0x30–0x3F\n  Announce = 0x30,\n  Resolve = 0x31,\n  Graph = 0x32,\n  // NOP 0x40–0x4F\n  Task = 0x40,\n  Delegate = 0x41,\n  Sync = 0x42,\n  AlignStream = 0x43,\n  // System 0xF0–0xFF\n  Error = 0xfe,\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Default (compact) header size in bytes. */\nexport const DEFAULT_HEADER_SIZE = 4;\n\n/** Extended header size in bytes (EXT=1). */\nexport const EXTENDED_HEADER_SIZE = 8;\n\n/** Maximum payload in default mode (64 KiB − 1). */\nexport const DEFAULT_MAX_PAYLOAD = 0xffff;\n\n/** Maximum payload in extended mode (4 GiB − 1). */\nexport const EXTENDED_MAX_PAYLOAD = 0xffffffff;\n\n// Flag bit positions (NPS-1 §3.2)\nconst TIER_MASK = 0x03; // bits 0-1\nconst FINAL_BIT = 0x04; // bit 2\nconst ENC_BIT = 0x08; // bit 3\nconst RESERVED_MASK = 0x70; // bits 4-6\nconst EXT_BIT = 0x80; // bit 7\n\n// ---------------------------------------------------------------------------\n// Error\n// ---------------------------------------------------------------------------\n\n/** NCP protocol error with machine-readable error code. */\nexport class NcpError extends Error {\n  // `code` accepts NcpErrorCode constants (preferred) as well as NPS status\n  // strings that are not NCP-prefixed (e.g. \"NPS-CLIENT-CONFLICT\") for cases\n  // where the spec delegates to NPS-level codes without assigning an NCP code.\n  constructor(\n    public readonly code: string,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"NcpError\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Parsed header\n// ---------------------------------------------------------------------------\n\n/** Parsed frame header. */\nexport interface FrameHeader {\n  /** Raw frame type byte. */\n  frameType: number;\n  /** Raw flags byte. */\n  flags: number;\n  /** Payload length in bytes. */\n  payloadLength: number;\n  /** Encoding tier extracted from flags bits 0-1. */\n  tier: EncodingTier;\n  /** True when FINAL flag (bit 2) is set. */\n  isFinal: boolean;\n  /** True when ENC flag (bit 3) is set. */\n  isEncrypted: boolean;\n  /** True when EXT flag (bit 7) is set — 8-byte header. */\n  isExtended: boolean;\n  /** Header size in bytes (4 or 8). */\n  headerSize: number;\n}\n\n// ---------------------------------------------------------------------------\n// Parse\n// ---------------------------------------------------------------------------\n\n/**\n * Parse a frame header from the start of the buffer.\n * Reads 2 bytes first to determine EXT, then reads remaining bytes.\n *\n * @throws {NcpError} NCP-FRAME-FLAGS-INVALID if reserved bits 4-6 are non-zero.\n * @throws {NcpError} NCP-FRAME-PARSE-ERROR if buffer is too small.\n * @throws {NcpError} NCP-FRAME-PAYLOAD-TOO-LARGE if opts.max_frame_payload is set and exceeded.\n */\nexport function parseFrameHeader(\n  buffer: Uint8Array,\n  opts?: { max_frame_payload?: number },\n): FrameHeader {\n  if (buffer.length < 2) {\n    throw new NcpError(\n      \"NCP-FRAME-PARSE-ERROR\",\n      `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buffer.length}`,\n    );\n  }\n\n  const frameType = buffer[0]!;\n  const flags = buffer[1]!;\n\n  // Validate reserved bits (NPS-1 §3.2: bits 4-6 MUST be 0)\n  if ((flags & RESERVED_MASK) !== 0) {\n    throw new NcpError(\n      \"NCP-FRAME-FLAGS-INVALID\",\n      \"Reserved flag bits 4-6 must be zero\",\n    );\n  }\n\n  const isExtended = (flags & EXT_BIT) !== 0;\n\n  if (isExtended) {\n    if (buffer.length < EXTENDED_HEADER_SIZE) {\n      throw new NcpError(\n        \"NCP-FRAME-PARSE-ERROR\",\n        `Buffer too small for extended header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buffer.length}`,\n      );\n    }\n\n    const view = new DataView(\n      buffer.buffer,\n      buffer.byteOffset,\n      buffer.byteLength,\n    );\n    const payloadLength = view.getUint32(2, false); // big-endian\n\n    if (\n      opts?.max_frame_payload !== undefined &&\n      payloadLength > opts.max_frame_payload\n    ) {\n      throw new NcpError(\n        \"NCP-FRAME-PAYLOAD-TOO-LARGE\",\n        `Payload length ${payloadLength} exceeds max_frame_payload ${opts.max_frame_payload}`,\n      );\n    }\n\n    return {\n      frameType,\n      flags,\n      payloadLength,\n      tier: (flags & TIER_MASK) as EncodingTier,\n      isFinal: (flags & FINAL_BIT) !== 0,\n      isEncrypted: (flags & ENC_BIT) !== 0,\n      isExtended: true,\n      headerSize: EXTENDED_HEADER_SIZE,\n    };\n  }\n\n  // Default 4-byte header\n  if (buffer.length < DEFAULT_HEADER_SIZE) {\n    throw new NcpError(\n      \"NCP-FRAME-PARSE-ERROR\",\n      `Buffer too small for header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buffer.length}`,\n    );\n  }\n\n  const view = new DataView(\n    buffer.buffer,\n    buffer.byteOffset,\n    buffer.byteLength,\n  );\n  const payloadLength = view.getUint16(2, false); // big-endian\n\n  if (\n    opts?.max_frame_payload !== undefined &&\n    payloadLength > opts.max_frame_payload\n  ) {\n    throw new NcpError(\n      \"NCP-FRAME-PAYLOAD-TOO-LARGE\",\n      `Payload length ${payloadLength} exceeds max_frame_payload ${opts.max_frame_payload}`,\n    );\n  }\n\n  return {\n    frameType,\n    flags,\n    payloadLength,\n    tier: (flags & TIER_MASK) as EncodingTier,\n    isFinal: (flags & FINAL_BIT) !== 0,\n    isEncrypted: (flags & ENC_BIT) !== 0,\n    isExtended: false,\n    headerSize: DEFAULT_HEADER_SIZE,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Write\n// ---------------------------------------------------------------------------\n\n/**\n * Write a frame header into the buffer.\n * @returns Number of bytes written (4 or 8).\n * @throws {Error} if buffer is too small.\n */\nexport function writeFrameHeader(\n  header: FrameHeader,\n  buffer: Uint8Array,\n): number {\n  const size = header.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;\n  if (buffer.length < size) {\n    throw new Error(\n      `Destination buffer must be at least ${size} bytes, got ${buffer.length}`,\n    );\n  }\n\n  buffer[0] = header.frameType;\n  buffer[1] = header.flags;\n\n  const view = new DataView(\n    buffer.buffer,\n    buffer.byteOffset,\n    buffer.byteLength,\n  );\n\n  if (header.isExtended) {\n    view.setUint32(2, header.payloadLength, false); // big-endian\n    buffer[6] = 0; // reserved\n    buffer[7] = 0; // reserved\n  } else {\n    view.setUint16(2, header.payloadLength, false); // big-endian\n  }\n\n  return size;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Build a flags byte from individual options. */\nexport function buildFlags(options: {\n  tier?: EncodingTier;\n  final?: boolean;\n  encrypted?: boolean;\n  extended?: boolean;\n}): number {\n  let flags = (options.tier ?? EncodingTier.Json) & TIER_MASK;\n  if (options.final) flags |= FINAL_BIT;\n  if (options.encrypted) flags |= ENC_BIT;\n  if (options.extended) flags |= EXT_BIT;\n  return flags;\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// AnchorFrame (0x01) — Schema anchor for global reference\n// NPS-1 §4.1\n\nimport { createHash } from \"node:crypto\";\n// canonicalize ships CJS with TS `export default` — NodeNext resolves as namespace\nimport canonicalizeDefault from \"canonicalize\";\nconst canonicalize = canonicalizeDefault as unknown as (input: unknown) => string | undefined;\nimport { NcpError } from \"../../core/frame-header.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nconst VALID_FIELD_TYPES = [\n  \"string\", \"uint64\", \"int64\", \"decimal\", \"bool\",\n  \"timestamp\", \"bytes\", \"object\", \"array\",\n] as const;\n\nexport type SchemaFieldType = (typeof VALID_FIELD_TYPES)[number];\n\nexport interface SchemaField {\n  name: string;\n  type: string;\n  semantic?: string;\n  nullable?: boolean;\n}\n\nexport interface FrameSchema {\n  fields: SchemaField[];\n}\n\nexport interface AnchorFrame {\n  frame: string;\n  anchor_id: string;\n  schema: FrameSchema;\n  ttl?: number;\n}\n\n// ---------------------------------------------------------------------------\n// anchor_id computation (RFC 8785 JCS + SHA-256)\n// ---------------------------------------------------------------------------\n\n/**\n * Compute anchor_id from schema using RFC 8785 JCS canonicalization + SHA-256.\n * Format: \"sha256:{64 lowercase hex chars}\"\n */\nexport function computeAnchorId(schema: FrameSchema): string {\n  const canonical = canonicalize(schema);\n  if (!canonical) {\n    throw new NcpError(\"NCP-ANCHOR-SCHEMA-INVALID\", \"Schema cannot be canonicalized\");\n  }\n  const hash = createHash(\"sha256\").update(canonical).digest(\"hex\");\n  return `sha256:${hash}`;\n}\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validate an AnchorFrame.\n * @throws {NcpError} NCP-ANCHOR-SCHEMA-INVALID if anchor_id doesn't match or schema is invalid.\n */\nexport function validateAnchorFrame(frame: AnchorFrame): void {\n  // Validate schema field types\n  for (const field of frame.schema.fields) {\n    if (!VALID_FIELD_TYPES.includes(field.type as SchemaFieldType)) {\n      throw new NcpError(\n        \"NCP-ANCHOR-SCHEMA-INVALID\",\n        `Unsupported field type \"${field.type}\" for field \"${field.name}\". ` +\n          `Valid types: ${VALID_FIELD_TYPES.join(\", \")}`,\n      );\n    }\n  }\n\n  // Validate anchor_id matches computed hash\n  const expected = computeAnchorId(frame.schema);\n  if (frame.anchor_id !== expected) {\n    throw new NcpError(\n      \"NCP-ANCHOR-SCHEMA-INVALID\",\n      `anchor_id mismatch: expected ${expected}, got ${frame.anchor_id}`,\n    );\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// CapsFrame (0x04) — Capsule response envelope\n// NPS-1 §4.4\n\nimport { NcpError } from \"../../core/frame-header.js\";\nimport {\n  computeAnchorId,\n  type AnchorFrame,\n  type FrameSchema,\n} from \"./anchor-frame.js\";\n\nexport interface CapsFrameInlineAnchor {\n  anchor_id: string;\n  schema: FrameSchema;\n  ttl?: number;\n}\n\nexport interface CapsFrame {\n  frame: string;\n  anchor_ref: string;\n  count: number;\n  data: unknown[];\n  next_cursor?: string | null;\n  token_est?: number;\n  tokenizer_used?: string;\n  cached?: boolean;\n  inline_anchor?: CapsFrameInlineAnchor;\n}\n\n/**\n * Validate a CapsFrame.\n *\n * Checks:\n * - count matches data.length (NPS-CLIENT-BAD-FRAME)\n * - if inline_anchor present, recomputes anchor_id and validates match (NCP-ANCHOR-SCHEMA-INVALID)\n *\n * @throws {NcpError} NPS-CLIENT-BAD-FRAME if count doesn't match data length.\n * @throws {NcpError} NCP-ANCHOR-SCHEMA-INVALID if inline_anchor.anchor_id doesn't match schema.\n */\nexport function validateCapsFrame(frame: CapsFrame): void {\n  if (frame.count !== frame.data.length) {\n    throw new NcpError(\n      \"NPS-CLIENT-BAD-FRAME\",\n      `CapsFrame count mismatch: count=${frame.count}, data.length=${frame.data.length}`,\n    );\n  }\n\n  if (frame.inline_anchor !== undefined) {\n    const computed = computeAnchorId(frame.inline_anchor.schema);\n    if (frame.inline_anchor.anchor_id !== computed) {\n      throw new NcpError(\n        \"NCP-ANCHOR-SCHEMA-INVALID\",\n        `inline_anchor anchor_id mismatch: expected ${computed}, got ${frame.inline_anchor.anchor_id}`,\n      );\n    }\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// NCP Patch Format — DiffFrame patch encoding types\n// NPS-1 §4.2\n\nexport const PATCH_FORMAT = {\n  JSON_PATCH: \"json_patch\",\n  BINARY_BITSET: \"binary_bitset\",\n} as const;\n\nexport type PatchFormat = typeof PATCH_FORMAT[keyof typeof PATCH_FORMAT];\n\nexport function isValidPatchFormat(v: unknown): v is PatchFormat {\n  return v === PATCH_FORMAT.JSON_PATCH || v === PATCH_FORMAT.BINARY_BITSET;\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// DiffFrame (0x02) — Incremental data patch\n// NPS-1 §4.2\n\nimport { NcpError, EncodingTier } from \"../../core/frame-header.js\";\nimport { isValidPatchFormat, type PatchFormat } from \"../ncp-patch-format.js\";\n\nexport interface JsonPatchOperation {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  value?: unknown;\n  from?: string;\n}\n\nexport interface DiffFrame {\n  frame: string;\n  anchor_ref: string;\n  base_seq: number;\n  patch_format?: PatchFormat;\n  patch: JsonPatchOperation[] | Uint8Array;\n  entity_id?: string;\n}\n\n/**\n * Validate DiffFrame base_seq against current sequence.\n * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequences don't match.\n */\nexport function validateDiffSeq(frame: DiffFrame, currentSeq: number): void {\n  if (frame.base_seq !== currentSeq) {\n    throw new NcpError(\n      \"NCP-STREAM-SEQ-GAP\",\n      `DiffFrame base_seq=${frame.base_seq} does not match current seq=${currentSeq}`,\n    );\n  }\n}\n\n/**\n * Validate DiffFrame patch_format against the encoding tier.\n *\n * binary_bitset is only supported on Tier-2 (MsgPack) frames.\n * Unknown patch_format values are also rejected.\n *\n * @throws {NcpError} NCP-DIFF-FORMAT-UNSUPPORTED if binary_bitset on non-Tier-2,\n *   or if patch_format is an unknown value.\n */\nexport function validateDiffFrame(\n  frame: DiffFrame,\n  encodingTier: EncodingTier | number,\n): void {\n  const fmt = frame.patch_format;\n\n  // Unknown patch_format\n  if (fmt !== undefined && !isValidPatchFormat(fmt)) {\n    throw new NcpError(\n      \"NCP-DIFF-FORMAT-UNSUPPORTED\",\n      `Unknown patch_format \"${String(fmt)}\"`,\n    );\n  }\n\n  // binary_bitset requires Tier-2 MsgPack\n  if (fmt === \"binary_bitset\" && encodingTier !== EncodingTier.MsgPack) {\n    throw new NcpError(\n      \"NCP-DIFF-FORMAT-UNSUPPORTED\",\n      \"patch_format=binary_bitset requires Tier-2 MsgPack encoding\",\n    );\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// ErrorFrame (0xFE) — Unified error frame for all NPS protocol layers\n// NPS-1 §4.7\n\n/** Unified error frame shared across all NPS protocol layers. */\nexport interface ErrorFrame {\n  /** Fixed value \"0xFE\". */\n  frame: string;\n  /** NPS status code, e.g. \"NPS-CLIENT-NOT-FOUND\". */\n  status: string;\n  /** Protocol-level error code, e.g. \"NCP-ANCHOR-NOT-FOUND\". */\n  error: string;\n  /** Human-readable error description. */\n  message?: string;\n  /** Structured error details (e.g. anchor_ref, stream_id). */\n  details?: Record<string, unknown>;\n}\n\n/** Type guard for ErrorFrame. */\nexport function isErrorFrame(obj: unknown): obj is ErrorFrame {\n  if (typeof obj !== \"object\" || obj === null) return false;\n  const o = obj as Record<string, unknown>;\n  return o.frame === \"0xFE\" && typeof o.status === \"string\" && typeof o.error === \"string\";\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// HelloFrame (0x06) — Native-mode client handshake\n// NPS-1 §4.6\n\nimport { NcpError } from \"../../core/frame-header.js\";\n\nexport interface HelloFrame {\n  frame: string;\n  nps_version: string;\n  min_version?: string;\n  supported_encodings: string[];\n  supported_protocols: string[];\n  agent_id?: string;\n  max_frame_payload?: number;\n  ext_support?: boolean;\n  max_concurrent_streams?: number;\n  e2e_enc_algorithms?: string[];\n}\n\n/**\n * Validate a HelloFrame.\n *\n * Required fields: nps_version, supported_encodings (non-empty), supported_protocols (non-empty).\n *\n * @throws {NcpError} NPS-CLIENT-BAD-FRAME if any required field is missing or empty.\n */\nexport function validateHelloFrame(frame: HelloFrame): void {\n  if (!frame.nps_version) {\n    throw new NcpError(\n      \"NPS-CLIENT-BAD-FRAME\",\n      \"HelloFrame missing required field: nps_version\",\n    );\n  }\n\n  if (!frame.supported_encodings || frame.supported_encodings.length === 0) {\n    throw new NcpError(\n      \"NPS-CLIENT-BAD-FRAME\",\n      \"HelloFrame missing required field: supported_encodings (must be non-empty)\",\n    );\n  }\n\n  if (!frame.supported_protocols || frame.supported_protocols.length === 0) {\n    throw new NcpError(\n      \"NPS-CLIENT-BAD-FRAME\",\n      \"HelloFrame missing required field: supported_protocols (must be non-empty)\",\n    );\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// StreamFrame (0x03) — Streaming data chunks with flow control\n// NPS-1 §4.3\n\nimport { NcpError } from \"../../core/frame-header.js\";\n\nexport interface StreamFrame {\n  frame: string;\n  stream_id: string;\n  seq: number;\n  is_last: boolean;\n  anchor_ref?: string;\n  data: unknown[];\n  window_size?: number;\n  error_code?: string;\n}\n\n// UUID v4 format: xxxxxxxx-xxxx-4xxx-[89ab]xxx-xxxxxxxxxxxx\nconst UUID_V4_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Validate stream_id is a valid UUID v4.\n * @throws {NcpError} NPS-CLIENT-BAD-FRAME if stream_id is not a valid UUID v4.\n */\nexport function validateStreamFrame(frame: StreamFrame): void {\n  if (!UUID_V4_RE.test(frame.stream_id)) {\n    throw new NcpError(\n      \"NPS-CLIENT-BAD-FRAME\",\n      `stream_id \"${frame.stream_id}\" is not a valid UUID v4`,\n    );\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// NCP Error Codes — All v0.4 protocol error codes\n// NPS-1 §6 + §7.4\n//\n// Implementation-only codes (NCP_FRAME_PARSE_ERROR, NCP_FRAME_INCOMPLETE) cover\n// wire-layer parse failures not in spec §6. See test/ncp_test_results.md spec\n// question 2 for the proposal to register them upstream.\n\nexport const NCP_ERROR_CODES = {\n  // Implementation-only codes (not in spec §6 — see test_results.md spec question 2)\n  NCP_FRAME_PARSE_ERROR: \"NCP-FRAME-PARSE-ERROR\",\n  NCP_FRAME_INCOMPLETE: \"NCP-FRAME-INCOMPLETE\",\n  // Spec-defined codes\n  NCP_FRAME_UNKNOWN_TYPE: \"NCP-FRAME-UNKNOWN-TYPE\",\n  NCP_FRAME_PAYLOAD_TOO_LARGE: \"NCP-FRAME-PAYLOAD-TOO-LARGE\",\n  NCP_FRAME_FLAGS_INVALID: \"NCP-FRAME-FLAGS-INVALID\",\n  NCP_ANCHOR_NOT_FOUND: \"NCP-ANCHOR-NOT-FOUND\",\n  NCP_ANCHOR_SCHEMA_INVALID: \"NCP-ANCHOR-SCHEMA-INVALID\",\n  NCP_ANCHOR_ID_MISMATCH: \"NCP-ANCHOR-ID-MISMATCH\",\n  NCP_ANCHOR_STALE: \"NCP-ANCHOR-STALE\",\n  NCP_STREAM_SEQ_GAP: \"NCP-STREAM-SEQ-GAP\",\n  NCP_STREAM_NOT_FOUND: \"NCP-STREAM-NOT-FOUND\",\n  NCP_STREAM_LIMIT_EXCEEDED: \"NCP-STREAM-LIMIT-EXCEEDED\",\n  NCP_STREAM_WINDOW_OVERFLOW: \"NCP-STREAM-WINDOW-OVERFLOW\",\n  NCP_ENCODING_UNSUPPORTED: \"NCP-ENCODING-UNSUPPORTED\",\n  NCP_DIFF_FORMAT_UNSUPPORTED: \"NCP-DIFF-FORMAT-UNSUPPORTED\",\n  NCP_VERSION_INCOMPATIBLE: \"NCP-VERSION-INCOMPATIBLE\",\n  NCP_ENC_NOT_NEGOTIATED: \"NCP-ENC-NOT-NEGOTIATED\",\n  NCP_ENC_AUTH_FAILED: \"NCP-ENC-AUTH-FAILED\",\n} as const;\n\nexport type NcpErrorCode = typeof NCP_ERROR_CODES[keyof typeof NCP_ERROR_CODES];\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// Handshake — Version negotiation and encoding negotiation\n// NPS-1 §2.6\n\n/**\n * Parse a \"major.minor\" (optionally \"major.minor.patch\") version string into a\n * tuple of numeric components. Invalid parts become NaN which makes subsequent\n * comparisons return false in both directions (safe failure).\n */\nfunction parseVersion(v: string): number[] {\n  return v.split(\".\").map((p) => Number.parseInt(p, 10));\n}\n\n/**\n * Numeric component-wise comparison of two version strings.\n * Returns negative if a < b, zero if equal, positive if a > b.\n * Avoids the lexicographic pitfall where \"0.9\" > \"0.10\".\n */\nfunction compareVersions(a: string, b: string): number {\n  const partsA = parseVersion(a);\n  const partsB = parseVersion(b);\n  const len = Math.max(partsA.length, partsB.length);\n  for (let i = 0; i < len; i += 1) {\n    const x = partsA[i] ?? 0;\n    const y = partsB[i] ?? 0;\n    if (x !== y) return x - y;\n  }\n  return 0;\n}\n\n/**\n * Negotiate the session NPS version between client and server.\n *\n * Session version = numeric min of client.nps_version and server.nps_version\n * (component-wise — \"0.9\" < \"0.10\" < \"1.0\").\n * If the effective client minimum (min_version ?? nps_version) > server.nps_version,\n * the versions are incompatible.\n *\n * Spec: NPS-1 §2.6\n */\nexport function negotiateVersion(\n  client: { nps_version: string; min_version?: string },\n  server: { nps_version: string },\n): { session_version: string; compatible: boolean; error_code?: string } {\n  const clientMin = client.min_version ?? client.nps_version;\n  const serverVersion = server.nps_version;\n\n  if (compareVersions(clientMin, serverVersion) > 0) {\n    return {\n      session_version: serverVersion,\n      compatible: false,\n      error_code: \"NCP-VERSION-INCOMPATIBLE\",\n    };\n  }\n\n  // Session version = component-wise min of client.nps_version and server.nps_version\n  const sessionVersion =\n    compareVersions(client.nps_version, serverVersion) <= 0\n      ? client.nps_version\n      : serverVersion;\n\n  return { session_version: sessionVersion, compatible: true };\n}\n\n/**\n * Negotiate the encoding between client and server preferred lists.\n *\n * Returns the first mutually supported encoding, preferring \"msgpack\" over \"json\".\n * Returns null if there is no intersection.\n */\nexport function negotiateEncoding(\n  client: string[],\n  server: string[],\n): { encoding: string | null } {\n  const serverSet = new Set(server);\n\n  // Prefer msgpack over json (and over any other encoding)\n  if (client.includes(\"msgpack\") && serverSet.has(\"msgpack\")) {\n    return { encoding: \"msgpack\" };\n  }\n  if (client.includes(\"json\") && serverSet.has(\"json\")) {\n    return { encoding: \"json\" };\n  }\n\n  // Fall back to first intersection in client-preference order\n  for (const enc of client) {\n    if (serverSet.has(enc)) {\n      return { encoding: enc };\n    }\n  }\n\n  return { encoding: null };\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// StreamManager — Concurrent stream tracking, sequence validation, flow control\n// NPS-1 §4.3, §7.3\n\nimport { NcpError } from \"../core/frame-header.js\";\nimport { NCP_ERROR_CODES } from \"./ncp-error-codes.js\";\nimport type { StreamFrame } from \"./frames/stream-frame.js\";\n\ninterface ActiveStream {\n  streamId: string;\n  expectedSeq: number;\n  chunks: unknown[][];\n  completed: boolean;\n  errorCode?: string;\n}\n\ninterface OutgoingStream {\n  streamId: string;\n  remainingWindow: number | undefined; // undefined = no flow control\n  paused: boolean;\n}\n\n/**\n * Manages concurrent StreamFrame streams.\n *\n * - Tracks active streams by stream_id\n * - Validates sequential seq numbers\n * - Enforces max concurrent stream limit (NPS-1 §7.3, default 32)\n * - Detects early termination via error_code\n * - Enforces window-based flow control on outgoing streams (NCP-S-07–11)\n */\nexport class StreamManager {\n  private readonly streams = new Map<string, ActiveStream>();\n  private readonly outgoing = new Map<string, OutgoingStream>();\n  private readonly maxConcurrent: number;\n\n  constructor(options?: { maxConcurrent?: number }) {\n    this.maxConcurrent = options?.maxConcurrent ?? 32;\n  }\n\n  /**\n   * Receive a StreamFrame chunk.\n   *\n   * @returns true if stream is complete (is_last=true or error_code set).\n   * @throws {NcpError} NCP-STREAM-LIMIT-EXCEEDED if too many concurrent streams.\n   * @throws {NcpError} NCP-STREAM-NOT-FOUND if frame.seq > 0 for a stream that was never opened.\n   * @throws {NcpError} NPS-CLIENT-CONFLICT if the stream_id was already completed (stream-id reuse; see test_cases NCP-S-04).\n   * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequence number is not expected.\n   */\n  receive(frame: StreamFrame): boolean {\n    let stream = this.streams.get(frame.stream_id);\n\n    if (!stream) {\n      // A stream is opened only by seq=0. Any other seq on an unknown stream_id\n      // means the opener was never seen (NCP-S-13: unknown stream_id).\n      if (frame.seq !== 0) {\n        throw new NcpError(\n          NCP_ERROR_CODES.NCP_STREAM_NOT_FOUND,\n          `Unknown stream_id ${frame.stream_id} — first frame must have seq=0`,\n        );\n      }\n\n      // New stream — check concurrent limit\n      if (this.streams.size >= this.maxConcurrent) {\n        throw new NcpError(\n          NCP_ERROR_CODES.NCP_STREAM_LIMIT_EXCEEDED,\n          `Max concurrent streams (${this.maxConcurrent}) exceeded`,\n        );\n      }\n\n      stream = {\n        streamId: frame.stream_id,\n        expectedSeq: 0,\n        chunks: [],\n        completed: false,\n      };\n      this.streams.set(frame.stream_id, stream);\n    }\n\n    // Reject writes to completed streams. Per test_cases NCP-S-04, the spec does\n    // not assign a dedicated NCP code for stream-id reuse; interim mapping uses\n    // the NPS-level NPS-CLIENT-CONFLICT until a spec-side code is added.\n    if (stream.completed) {\n      throw new NcpError(\n        \"NPS-CLIENT-CONFLICT\",\n        `Stream ${frame.stream_id} is already completed — cannot reuse stream_id`,\n      );\n    }\n\n    // Sequence validation\n    if (frame.seq !== stream.expectedSeq) {\n      // Duplicate detection — same seq as last accepted\n      if (frame.seq < stream.expectedSeq) {\n        // Ignore duplicate (idempotent)\n        return false;\n      }\n      throw new NcpError(\n        NCP_ERROR_CODES.NCP_STREAM_SEQ_GAP,\n        `Expected seq ${stream.expectedSeq}, got ${frame.seq} on stream ${frame.stream_id}`,\n      );\n    }\n\n    stream.chunks.push(frame.data);\n    stream.expectedSeq = frame.seq + 1;\n\n    // Early termination via error_code\n    if (frame.error_code) {\n      stream.completed = true;\n      stream.errorCode = frame.error_code;\n      return true;\n    }\n\n    // Normal completion\n    if (frame.is_last) {\n      stream.completed = true;\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Send a StreamFrame on an outgoing stream, enforcing window-based flow control.\n   *\n   * - seq=0 with window_size initialises remainingWindow (no decrement for opening frame).\n   * - Subsequent sends decrement remainingWindow when flow control is active.\n   * - Throws NCP-STREAM-WINDOW-OVERFLOW when remainingWindow === 0.\n   *\n   * @throws {NcpError} NCP-STREAM-WINDOW-OVERFLOW if window is exhausted.\n   */\n  send(frame: StreamFrame): void {\n    let out = this.outgoing.get(frame.stream_id);\n\n    if (!out) {\n      out = {\n        streamId: frame.stream_id,\n        remainingWindow: undefined,\n        paused: false,\n      };\n      this.outgoing.set(frame.stream_id, out);\n    }\n\n    // Opening frame: initialise window from window_size if provided.\n    if (frame.seq === 0 && frame.window_size !== undefined) {\n      out.remainingWindow = frame.window_size;\n      return; // opening frame does not consume a window slot\n    }\n\n    // Flow control check for subsequent frames.\n    if (out.remainingWindow !== undefined) {\n      if (out.remainingWindow === 0) {\n        throw new NcpError(\n          NCP_ERROR_CODES.NCP_STREAM_WINDOW_OVERFLOW,\n          `Window exhausted on stream ${frame.stream_id}`,\n        );\n      }\n      out.remainingWindow -= 1;\n    }\n  }\n\n  /**\n   * Update the send window for a stream.\n   *\n   * Called when a reverse-direction StreamFrame arrives with data=[] and window_size set.\n   * Replaces remainingWindow with new_size. Sets paused=true when new_size === 0.\n   */\n  updateWindow(streamId: string, newSize: number): void {\n    let out = this.outgoing.get(streamId);\n    if (!out) {\n      out = {\n        streamId,\n        remainingWindow: newSize,\n        paused: newSize === 0,\n      };\n      this.outgoing.set(streamId, out);\n      return;\n    }\n    out.remainingWindow = newSize;\n    out.paused = newSize === 0;\n  }\n\n  /**\n   * Returns true when the outgoing stream is paused (window=0 was received).\n   * Resumes (returns false) once a non-zero window update arrives.\n   */\n  isPaused(streamId: string): boolean {\n    return this.outgoing.get(streamId)?.paused ?? false;\n  }\n\n  /** Get reassembled data for a completed stream. */\n  getData(streamId: string): unknown[] | null {\n    const stream = this.streams.get(streamId);\n    if (!stream || !stream.completed) return null;\n    return stream.chunks.flat();\n  }\n\n  /** Get error code if stream terminated with error. */\n  getError(streamId: string): string | undefined {\n    return this.streams.get(streamId)?.errorCode;\n  }\n\n  /** Number of active (non-completed) streams. */\n  get activeCount(): number {\n    let count = 0;\n    for (const s of this.streams.values()) {\n      if (!s.completed) count++;\n    }\n    return count;\n  }\n}\n"]}