@labacacia/nps-sdk 1.0.0-alpha.1

package/dist/ncp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ncp/frames.ts","../../src/ncp/registry.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { EncodingTier, FrameType } from \"../core/frames.js\";\nimport type { NpsFrame } from \"../core/codec.js\";\n\n// ── FrameSchema ───────────────────────────────────────────────────────────────\n\nexport interface SchemaField {\n  name:      string;\n  type:      string;\n  semantic?: string;\n  nullable?: boolean;\n}\n\nexport interface FrameSchema {\n  fields: readonly SchemaField[];\n}\n\n// ── AnchorFrame ───────────────────────────────────────────────────────────────\n\nexport class AnchorFrame implements NpsFrame {\n  readonly frameType     = FrameType.ANCHOR;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly anchorId: string,\n    public readonly schema:   FrameSchema,\n    public readonly ttl:      number = 3600,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      anchor_id: this.anchorId,\n      schema:    { fields: this.schema.fields.map((f) => ({ ...f })) },\n      ttl:       this.ttl,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): AnchorFrame {\n    const schemaRaw = data[\"schema\"] as { fields: SchemaField[] };\n    return new AnchorFrame(\n      data[\"anchor_id\"] as string,\n      { fields: schemaRaw.fields },\n      (data[\"ttl\"] as number | undefined) ?? 3600,\n    );\n  }\n}\n\n// ── JsonPatchOperation ────────────────────────────────────────────────────────\n\nexport interface JsonPatchOperation {\n  op:     string;\n  path:   string;\n  value?: unknown;\n}\n\n// ── DiffFrame ─────────────────────────────────────────────────────────────────\n\nexport class DiffFrame implements NpsFrame {\n  readonly frameType     = FrameType.DIFF;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly anchorRef: string,\n    public readonly baseSeq:   number,\n    public readonly patch:     readonly JsonPatchOperation[],\n    public readonly entityId?: string,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      anchor_ref: this.anchorRef,\n      base_seq:   this.baseSeq,\n      patch:      this.patch.map((p) => ({ ...p })),\n      entity_id:  this.entityId ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): DiffFrame {\n    return new DiffFrame(\n      data[\"anchor_ref\"] as string,\n      data[\"base_seq\"]   as number,\n      data[\"patch\"]      as JsonPatchOperation[],\n      (data[\"entity_id\"] as string | null) ?? undefined,\n    );\n  }\n}\n\n// ── StreamFrame ───────────────────────────────────────────────────────────────\n\nexport class StreamFrame implements NpsFrame {\n  readonly frameType     = FrameType.STREAM;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly streamId:   string,\n    public readonly seq:        number,\n    public readonly isLast:     boolean,\n    public readonly data:       readonly Record<string, unknown>[],\n    public readonly anchorRef?: string,\n    public readonly windowSize?: number,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      stream_id:   this.streamId,\n      seq:         this.seq,\n      is_last:     this.isLast,\n      data:        this.data,\n      anchor_ref:  this.anchorRef  ?? null,\n      window_size: this.windowSize ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): StreamFrame {\n    return new StreamFrame(\n      data[\"stream_id\"]   as string,\n      data[\"seq\"]         as number,\n      data[\"is_last\"]     as boolean,\n      data[\"data\"]        as Record<string, unknown>[],\n      (data[\"anchor_ref\"]  as string | null)  ?? undefined,\n      (data[\"window_size\"] as number | null)  ?? undefined,\n    );\n  }\n}\n\n// ── CapsFrame ─────────────────────────────────────────────────────────────────\n\nexport class CapsFrame implements NpsFrame {\n  readonly frameType     = FrameType.CAPS;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly anchorRef:      string,\n    public readonly count:          number,\n    public readonly data:           readonly Record<string, unknown>[],\n    public readonly nextCursor?:    string,\n    public readonly tokenEst?:      number,\n    public readonly cached?:        boolean,\n    public readonly tokenizerUsed?: string,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      anchor_ref:      this.anchorRef,\n      count:           this.count,\n      data:            this.data,\n      next_cursor:     this.nextCursor    ?? null,\n      token_est:       this.tokenEst      ?? null,\n      cached:          this.cached        ?? null,\n      tokenizer_used:  this.tokenizerUsed ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): CapsFrame {\n    return new CapsFrame(\n      data[\"anchor_ref\"]     as string,\n      data[\"count\"]          as number,\n      data[\"data\"]           as Record<string, unknown>[],\n      (data[\"next_cursor\"]    as string | null) ?? undefined,\n      (data[\"token_est\"]      as number | null) ?? undefined,\n      (data[\"cached\"]         as boolean | null) ?? undefined,\n      (data[\"tokenizer_used\"] as string | null) ?? undefined,\n    );\n  }\n}\n\n// ── ErrorFrame ────────────────────────────────────────────────────────────────\n\nexport class ErrorFrame implements NpsFrame {\n  readonly frameType     = FrameType.ERROR;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly status:   string,\n    public readonly error:    string,\n    public readonly message?: string,\n    public readonly details?: Record<string, unknown>,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      status:  this.status,\n      error:   this.error,\n      message: this.message ?? null,\n      details: this.details ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): ErrorFrame {\n    return new ErrorFrame(\n      data[\"status\"]  as string,\n      data[\"error\"]   as string,\n      (data[\"message\"] as string | null) ?? undefined,\n      (data[\"details\"] as Record<string, unknown> | null) ?? undefined,\n    );\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { FrameRegistry } from \"../core/registry.js\";\nimport { FrameType } from \"../core/frames.js\";\nimport { AnchorFrame, CapsFrame, DiffFrame, ErrorFrame, StreamFrame } from \"./frames.js\";\n\nexport function registerNcpFrames(registry: FrameRegistry): void {\n  registry.register(FrameType.ANCHOR, AnchorFrame);\n  registry.register(FrameType.DIFF,   DiffFrame);\n  registry.register(FrameType.STREAM, StreamFrame);\n  registry.register(FrameType.CAPS,   CapsFrame);\n  registry.register(FrameType.ERROR,  ErrorFrame);\n}\n"]}

package/dist/ncp/index.d.cts

@@ -0,0 +1,6 @@
+export { A as AnchorFrame, C as CapsFrame, D as DiffFrame, E as ErrorFrame, F as FrameSchema, J as JsonPatchOperation, S as SchemaField, a as StreamFrame } from '../frames-B3qLdl_g.cjs';
+import { F as FrameRegistry } from '../codec-CmHeovTV.cjs';
+
+declare function registerNcpFrames(registry: FrameRegistry): void;
+
+export { registerNcpFrames };

package/dist/ncp/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./frames/anchor-frame.js";
+export * from "./frames/caps-frame.js";
+export * from "./frames/diff-frame.js";
+export * from "./frames/error-frame.js";
+export * from "./frames/hello-frame.js";
+export * from "./frames/stream-frame.js";
+export * from "./ncp-error-codes.js";
+export * from "./ncp-patch-format.js";
+export * from "./handshake.js";
+export * from "./stream-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ncp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ncp/index.ts"],"names":[],"mappings":"AAEA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/ncp/index.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+export * from "./frames/anchor-frame.js";
+export * from "./frames/caps-frame.js";
+export * from "./frames/diff-frame.js";
+export * from "./frames/error-frame.js";
+export * from "./frames/hello-frame.js";
+export * from "./frames/stream-frame.js";
+export * from "./ncp-error-codes.js";
+export * from "./ncp-patch-format.js";
+export * from "./handshake.js";
+export * from "./stream-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/ncp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ncp/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/ncp/ncp-error-codes.d.ts

@@ -0,0 +1,22 @@
+export declare const NCP_ERROR_CODES: {
+    readonly NCP_FRAME_PARSE_ERROR: "NCP-FRAME-PARSE-ERROR";
+    readonly NCP_FRAME_INCOMPLETE: "NCP-FRAME-INCOMPLETE";
+    readonly NCP_FRAME_UNKNOWN_TYPE: "NCP-FRAME-UNKNOWN-TYPE";
+    readonly NCP_FRAME_PAYLOAD_TOO_LARGE: "NCP-FRAME-PAYLOAD-TOO-LARGE";
+    readonly NCP_FRAME_FLAGS_INVALID: "NCP-FRAME-FLAGS-INVALID";
+    readonly NCP_ANCHOR_NOT_FOUND: "NCP-ANCHOR-NOT-FOUND";
+    readonly NCP_ANCHOR_SCHEMA_INVALID: "NCP-ANCHOR-SCHEMA-INVALID";
+    readonly NCP_ANCHOR_ID_MISMATCH: "NCP-ANCHOR-ID-MISMATCH";
+    readonly NCP_ANCHOR_STALE: "NCP-ANCHOR-STALE";
+    readonly NCP_STREAM_SEQ_GAP: "NCP-STREAM-SEQ-GAP";
+    readonly NCP_STREAM_NOT_FOUND: "NCP-STREAM-NOT-FOUND";
+    readonly NCP_STREAM_LIMIT_EXCEEDED: "NCP-STREAM-LIMIT-EXCEEDED";
+    readonly NCP_STREAM_WINDOW_OVERFLOW: "NCP-STREAM-WINDOW-OVERFLOW";
+    readonly NCP_ENCODING_UNSUPPORTED: "NCP-ENCODING-UNSUPPORTED";
+    readonly NCP_DIFF_FORMAT_UNSUPPORTED: "NCP-DIFF-FORMAT-UNSUPPORTED";
+    readonly NCP_VERSION_INCOMPATIBLE: "NCP-VERSION-INCOMPATIBLE";
+    readonly NCP_ENC_NOT_NEGOTIATED: "NCP-ENC-NOT-NEGOTIATED";
+    readonly NCP_ENC_AUTH_FAILED: "NCP-ENC-AUTH-FAILED";
+};
+export type NcpErrorCode = typeof NCP_ERROR_CODES[keyof typeof NCP_ERROR_CODES];
+//# sourceMappingURL=ncp-error-codes.d.ts.map

package/dist/ncp/ncp-error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ncp-error-codes.d.ts","sourceRoot":"","sources":["../../src/ncp/ncp-error-codes.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/ncp/ncp-error-codes.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+//
+// NCP Error Codes — All v0.4 protocol error codes
+// NPS-1 §6 + §7.4
+//
+// Implementation-only codes (NCP_FRAME_PARSE_ERROR, NCP_FRAME_INCOMPLETE) cover
+// wire-layer parse failures not in spec §6. See test/ncp_test_results.md spec
+// question 2 for the proposal to register them upstream.
+export const 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",
+};
+//# sourceMappingURL=ncp-error-codes.js.map

package/dist/ncp/ncp-error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ncp-error-codes.js","sourceRoot":"","sources":["../../src/ncp/ncp-error-codes.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,kDAAkD;AAClD,kBAAkB;AAClB,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,yDAAyD;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,mFAAmF;IACnF,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB;IACrB,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;IAC1D,uBAAuB,EAAE,yBAAyB;IAClD,oBAAoB,EAAE,sBAAsB;IAC5C,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,kBAAkB;IACpC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,yBAAyB,EAAE,2BAA2B;IACtD,0BAA0B,EAAE,4BAA4B;IACxD,wBAAwB,EAAE,0BAA0B;IACpD,2BAA2B,EAAE,6BAA6B;IAC1D,wBAAwB,EAAE,0BAA0B;IACpD,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;CAClC,CAAC"}

package/dist/ncp/ncp-patch-format.d.ts

@@ -0,0 +1,7 @@
+export declare const PATCH_FORMAT: {
+    readonly JSON_PATCH: "json_patch";
+    readonly BINARY_BITSET: "binary_bitset";
+};
+export type PatchFormat = typeof PATCH_FORMAT[keyof typeof PATCH_FORMAT];
+export declare function isValidPatchFormat(v: unknown): v is PatchFormat;
+//# sourceMappingURL=ncp-patch-format.d.ts.map

package/dist/ncp/ncp-patch-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ncp-patch-format.d.ts","sourceRoot":"","sources":["../../src/ncp/ncp-patch-format.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE/D"}

package/dist/ncp/ncp-patch-format.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+//
+// NCP Patch Format — DiffFrame patch encoding types
+// NPS-1 §4.2
+export const PATCH_FORMAT = {
+    JSON_PATCH: "json_patch",
+    BINARY_BITSET: "binary_bitset",
+};
+export function isValidPatchFormat(v) {
+    return v === PATCH_FORMAT.JSON_PATCH || v === PATCH_FORMAT.BINARY_BITSET;
+}
+//# sourceMappingURL=ncp-patch-format.js.map

package/dist/ncp/ncp-patch-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ncp-patch-format.js","sourceRoot":"","sources":["../../src/ncp/ncp-patch-format.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,oDAAoD;AACpD,aAAa;AAEb,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;CACtB,CAAC;AAIX,MAAM,UAAU,kBAAkB,CAAC,CAAU;IAC3C,OAAO,CAAC,KAAK,YAAY,CAAC,UAAU,IAAI,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC;AAC3E,CAAC"}

package/dist/ncp/registry.d.ts

@@ -0,0 +1,3 @@
+import { FrameRegistry } from "../core/registry.js";
+export declare function registerNcpFrames(registry: FrameRegistry): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/ncp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ncp/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAM/D"}

package/dist/ncp/registry.js

@@ -0,0 +1,12 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { FrameType } from "../core/frames.js";
+import { AnchorFrame, CapsFrame, DiffFrame, ErrorFrame, StreamFrame } from "./frames.js";
+export function registerNcpFrames(registry) {
+    registry.register(FrameType.ANCHOR, AnchorFrame);
+    registry.register(FrameType.DIFF, DiffFrame);
+    registry.register(FrameType.STREAM, StreamFrame);
+    registry.register(FrameType.CAPS, CapsFrame);
+    registry.register(FrameType.ERROR, ErrorFrame);
+}
+//# sourceMappingURL=registry.js.map

package/dist/ncp/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/ncp/registry.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAGtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzF,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAI,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAI,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAG,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/ncp/stream-manager.d.ts

@@ -0,0 +1,57 @@
+import type { StreamFrame } from "./frames/stream-frame.js";
+/**
+ * Manages concurrent StreamFrame streams.
+ *
+ * - Tracks active streams by stream_id
+ * - Validates sequential seq numbers
+ * - Enforces max concurrent stream limit (NPS-1 §7.3, default 32)
+ * - Detects early termination via error_code
+ * - Enforces window-based flow control on outgoing streams (NCP-S-07–11)
+ */
+export declare class StreamManager {
+    private readonly streams;
+    private readonly outgoing;
+    private readonly maxConcurrent;
+    constructor(options?: {
+        maxConcurrent?: number;
+    });
+    /**
+     * 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: StreamFrame): boolean;
+    /**
+     * 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: StreamFrame): void;
+    /**
+     * 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: string, newSize: number): void;
+    /**
+     * Returns true when the outgoing stream is paused (window=0 was received).
+     * Resumes (returns false) once a non-zero window update arrives.
+     */
+    isPaused(streamId: string): boolean;
+    /** Get reassembled data for a completed stream. */
+    getData(streamId: string): unknown[] | null;
+    /** Get error code if stream terminated with error. */
+    getError(streamId: string): string | undefined;
+    /** Number of active (non-completed) streams. */
+    get activeCount(): number;
+}
+//# sourceMappingURL=stream-manager.d.ts.map

package/dist/ncp/stream-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-manager.d.ts","sourceRoot":"","sources":["../../src/ncp/stream-manager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgB5D;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAIhD;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAwEpC;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA8B9B;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAerD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAInC,mDAAmD;IACnD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI;IAM3C,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,gDAAgD;IAChD,IAAI,WAAW,IAAI,MAAM,CAMxB;CACF"}

package/dist/ncp/stream-manager.js

@@ -0,0 +1,163 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+//
+// StreamManager — Concurrent stream tracking, sequence validation, flow control
+// NPS-1 §4.3, §7.3
+import { NcpError } from "../core/frame-header.js";
+import { NCP_ERROR_CODES } from "./ncp-error-codes.js";
+/**
+ * Manages concurrent StreamFrame streams.
+ *
+ * - Tracks active streams by stream_id
+ * - Validates sequential seq numbers
+ * - Enforces max concurrent stream limit (NPS-1 §7.3, default 32)
+ * - Detects early termination via error_code
+ * - Enforces window-based flow control on outgoing streams (NCP-S-07–11)
+ */
+export class StreamManager {
+    streams = new Map();
+    outgoing = 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) {
+            // A stream is opened only by seq=0. Any other seq on an unknown stream_id
+            // means the opener was never seen (NCP-S-13: unknown stream_id).
+            if (frame.seq !== 0) {
+                throw new NcpError(NCP_ERROR_CODES.NCP_STREAM_NOT_FOUND, `Unknown stream_id ${frame.stream_id} — first frame must have seq=0`);
+            }
+            // New stream — check concurrent limit
+            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);
+        }
+        // Reject writes to completed streams. Per test_cases NCP-S-04, the spec does
+        // not assign a dedicated NCP code for stream-id reuse; interim mapping uses
+        // the NPS-level NPS-CLIENT-CONFLICT until a spec-side code is added.
+        if (stream.completed) {
+            throw new NcpError("NPS-CLIENT-CONFLICT", `Stream ${frame.stream_id} is already completed — cannot reuse stream_id`);
+        }
+        // Sequence validation
+        if (frame.seq !== stream.expectedSeq) {
+            // Duplicate detection — same seq as last accepted
+            if (frame.seq < stream.expectedSeq) {
+                // Ignore duplicate (idempotent)
+                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;
+        // Early termination via error_code
+        if (frame.error_code) {
+            stream.completed = true;
+            stream.errorCode = frame.error_code;
+            return true;
+        }
+        // Normal completion
+        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: undefined,
+                paused: false,
+            };
+            this.outgoing.set(frame.stream_id, out);
+        }
+        // Opening frame: initialise window from window_size if provided.
+        if (frame.seq === 0 && frame.window_size !== undefined) {
+            out.remainingWindow = frame.window_size;
+            return; // opening frame does not consume a window slot
+        }
+        // Flow control check for subsequent frames.
+        if (out.remainingWindow !== undefined) {
+            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;
+    }
+}
+//# sourceMappingURL=stream-manager.js.map

package/dist/ncp/stream-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-manager.js","sourceRoot":"","sources":["../../src/ncp/stream-manager.ts"],"names":[],"mappings":"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"}

package/dist/ndp/frames.d.ts

@@ -0,0 +1,56 @@
+import { EncodingTier, FrameType } from "../core/frames.js";
+import type { NpsFrame } from "../core/codec.js";
+export interface NdpAddress {
+    host: string;
+    port: number;
+    protocol: string;
+}
+export interface NdpGraphNode {
+    nid: string;
+    addresses: readonly NdpAddress[];
+    capabilities: readonly string[];
+    nodeType?: string;
+}
+export interface NdpResolveResult {
+    host: string;
+    port: number;
+    ttl: number;
+    certFingerprint?: string;
+}
+export declare class AnnounceFrame implements NpsFrame {
+    readonly nid: string;
+    readonly addresses: readonly NdpAddress[];
+    readonly capabilities: readonly string[];
+    readonly ttl: number;
+    readonly timestamp: string;
+    readonly signature: string;
+    readonly nodeType?: string | undefined;
+    readonly frameType = FrameType.ANNOUNCE;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(nid: string, addresses: readonly NdpAddress[], capabilities: readonly string[], ttl: number, timestamp: string, signature: string, nodeType?: string | undefined);
+    unsignedDict(): Record<string, unknown>;
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): AnnounceFrame;
+}
+export declare class ResolveFrame implements NpsFrame {
+    readonly target: string;
+    readonly requesterNid?: string | undefined;
+    readonly resolved?: NdpResolveResult | undefined;
+    readonly frameType = FrameType.RESOLVE;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(target: string, requesterNid?: string | undefined, resolved?: NdpResolveResult | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): ResolveFrame;
+}
+export declare class GraphFrame implements NpsFrame {
+    readonly seq: number;
+    readonly initialSync: boolean;
+    readonly nodes?: readonly NdpGraphNode[] | undefined;
+    readonly patch?: readonly Record<string, unknown>[] | undefined;
+    readonly frameType = FrameType.GRAPH;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(seq: number, initialSync: boolean, nodes?: readonly NdpGraphNode[] | undefined, patch?: readonly Record<string, unknown>[] | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): GraphFrame;
+}
+//# sourceMappingURL=frames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/ndp/frames.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAM,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAW,MAAM,CAAC;IACrB,SAAS,EAAK,SAAS,UAAU,EAAE,CAAC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAK,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAe,MAAM,CAAC;IAC1B,IAAI,EAAe,MAAM,CAAC;IAC1B,GAAG,EAAgB,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAG,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,QAAQ;aAK1B,GAAG,EAAW,MAAM;aACpB,SAAS,EAAK,SAAS,UAAU,EAAE;aACnC,YAAY,EAAE,SAAS,MAAM,EAAE;aAC/B,GAAG,EAAW,MAAM;aACpB,SAAS,EAAK,MAAM;aACpB,SAAS,EAAK,MAAM;aACpB,QAAQ,CAAC,EAAK,MAAM;IAVtC,QAAQ,CAAC,SAAS,sBAA0B;IAC5C,QAAQ,CAAC,aAAa,wBAAwB;gBAG5B,GAAG,EAAW,MAAM,EACpB,SAAS,EAAK,SAAS,UAAU,EAAE,EACnC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,GAAG,EAAW,MAAM,EACpB,SAAS,EAAK,MAAM,EACpB,SAAS,EAAK,MAAM,EACpB,QAAQ,CAAC,EAAK,MAAM,YAAA;IAGtC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWvC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;CAW9D;AAED,qBAAa,YAAa,YAAW,QAAQ;aAKzB,MAAM,EAAS,MAAM;aACrB,YAAY,CAAC,EAAE,MAAM;aACrB,QAAQ,CAAC,EAAM,gBAAgB;IANjD,QAAQ,CAAC,SAAS,qBAAyB;IAC3C,QAAQ,CAAC,aAAa,wBAAwB;gBAG5B,MAAM,EAAS,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,QAAQ,CAAC,EAAM,gBAAgB,YAAA;IAGjD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAO7D;AAED,qBAAa,UAAW,YAAW,QAAQ;aAKvB,GAAG,EAAU,MAAM;aACnB,WAAW,EAAE,OAAO;aACpB,KAAK,CAAC,EAAO,SAAS,YAAY,EAAE;aACpC,KAAK,CAAC,EAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAPjE,QAAQ,CAAC,SAAS,mBAAuB;IACzC,QAAQ,CAAC,aAAa,wBAAwB;gBAG5B,GAAG,EAAU,MAAM,EACnB,WAAW,EAAE,OAAO,EACpB,KAAK,CAAC,EAAO,SAAS,YAAY,EAAE,YAAA,EACpC,KAAK,CAAC,EAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAA;IAGjE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;CAQ3D"}

package/dist/ndp/frames.js

@@ -0,0 +1,87 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { EncodingTier, FrameType } from "../core/frames.js";
+export class AnnounceFrame {
+    nid;
+    addresses;
+    capabilities;
+    ttl;
+    timestamp;
+    signature;
+    nodeType;
+    frameType = FrameType.ANNOUNCE;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(nid, addresses, capabilities, ttl, timestamp, signature, nodeType) {
+        this.nid = nid;
+        this.addresses = addresses;
+        this.capabilities = capabilities;
+        this.ttl = ttl;
+        this.timestamp = timestamp;
+        this.signature = signature;
+        this.nodeType = nodeType;
+    }
+    unsignedDict() {
+        return {
+            nid: this.nid,
+            addresses: this.addresses,
+            capabilities: this.capabilities,
+            ttl: this.ttl,
+            timestamp: this.timestamp,
+            node_type: this.nodeType ?? null,
+        };
+    }
+    toDict() {
+        return { ...this.unsignedDict(), signature: this.signature };
+    }
+    static fromDict(data) {
+        return new AnnounceFrame(data["nid"], data["addresses"], data["capabilities"], data["ttl"], data["timestamp"], data["signature"], data["node_type"] ?? undefined);
+    }
+}
+export class ResolveFrame {
+    target;
+    requesterNid;
+    resolved;
+    frameType = FrameType.RESOLVE;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(target, requesterNid, resolved) {
+        this.target = target;
+        this.requesterNid = requesterNid;
+        this.resolved = resolved;
+    }
+    toDict() {
+        return {
+            target: this.target,
+            requester_nid: this.requesterNid ?? null,
+            resolved: this.resolved ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new ResolveFrame(data["target"], data["requester_nid"] ?? undefined, data["resolved"] ?? undefined);
+    }
+}
+export class GraphFrame {
+    seq;
+    initialSync;
+    nodes;
+    patch;
+    frameType = FrameType.GRAPH;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(seq, initialSync, nodes, patch) {
+        this.seq = seq;
+        this.initialSync = initialSync;
+        this.nodes = nodes;
+        this.patch = patch;
+    }
+    toDict() {
+        return {
+            seq: this.seq,
+            initial_sync: this.initialSync,
+            nodes: this.nodes ?? null,
+            patch: this.patch ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new GraphFrame(data["seq"], data["initial_sync"], data["nodes"] ?? undefined, data["patch"] ?? undefined);
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/ndp/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../../src/ndp/frames.ts"],"names":[],"mappings":"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"}