@labacacia/nps-sdk 1.0.0-alpha.6 → 1.0.0-alpha.8

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+export { FrameType, EncodingTier, FrameFlags, FrameHeader, DEFAULT_HEADER_SIZE, EXTENDED_HEADER_SIZE, DEFAULT_MAX_PAYLOAD, EXTENDED_MAX_PAYLOAD, } from "./frames.js";
+export { Tier1JsonCodec, Tier2MsgPackCodec, NpsFrameCodec, } from "./codec.js";
+export type { NpsFrame } from "./codec.js";
+export { FrameRegistry } from "./registry.js";
+export type { FrameClass } from "./registry.js";
+export { AnchorFrameCache } from "./cache.js";
+export * from "./exceptions.js";
+export * from "./status-codes.js";
+export { jcsStringify, sortKeysStringify } from "./canonical-json.js";
+export type { CryptoProvider } from "./crypto-provider.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/{src/core/index.ts → dist/core/index.js}

@@ -7,36 +7,16 @@
 // clients. The parallel functional API under ./codecs/ and ./frame-header.js
 // remains importable by direct path but is not re-exported here to avoid
 // symbol collisions (both files define FrameType / EncodingTier / FrameHeader).
-
 // ── Frame primitives (OOP) ────────────────────────────────────────────────────
-export {
-  FrameType,
-  EncodingTier,
-  FrameFlags,
-  FrameHeader,
-  DEFAULT_HEADER_SIZE,
-  EXTENDED_HEADER_SIZE,
-  DEFAULT_MAX_PAYLOAD,
-  EXTENDED_MAX_PAYLOAD,
-} from "./frames.js";
-
+export { FrameType, EncodingTier, FrameFlags, FrameHeader, DEFAULT_HEADER_SIZE, EXTENDED_HEADER_SIZE, DEFAULT_MAX_PAYLOAD, EXTENDED_MAX_PAYLOAD, } from "./frames.js";
 // ── Codec (OOP) ───────────────────────────────────────────────────────────────
-export {
-  Tier1JsonCodec,
-  Tier2MsgPackCodec,
-  NpsFrameCodec,
-} from "./codec.js";
-export type { NpsFrame } from "./codec.js";
-
+export { Tier1JsonCodec, Tier2MsgPackCodec, NpsFrameCodec, } from "./codec.js";
 // ── Registry (OOP) ────────────────────────────────────────────────────────────
 export { FrameRegistry } from "./registry.js";
-export type { FrameClass } from "./registry.js";
-
 // ── Anchor cache (OOP) ────────────────────────────────────────────────────────
 export { AnchorFrameCache } from "./cache.js";
-
 // ── Exceptions / Status / Canonical JSON ──────────────────────────────────────
 export * from "./exceptions.js";
 export * from "./status-codes.js";
 export { jcsStringify, sortKeysStringify } from "./canonical-json.js";
-export type { CryptoProvider } from "./crypto-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AACtC,EAAE;AACF,uEAAuE;AACvE,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,gFAAgF;AAEhF,iFAAiF;AACjF,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,iFAAiF;AACjF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,iFAAiF;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,iFAAiF;AACjF,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,11 @@
+import { FrameType } from "./frames.js";
+import type { NpsFrame } from "./codec.js";
+export interface FrameClass {
+    fromDict(data: Record<string, unknown>): NpsFrame;
+}
+export declare class FrameRegistry {
+    private readonly _map;
+    register(frameType: FrameType, cls: FrameClass): void;
+    resolve(frameType: FrameType): FrameClass;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;CACnD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IAEzD,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAIrD,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU;CAS1C"}

package/dist/core/registry.js

@@ -0,0 +1,17 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { NpsFrameError } from "./exceptions.js";
+export class FrameRegistry {
+    _map = new Map();
+    register(frameType, cls) {
+        this._map.set(frameType, cls);
+    }
+    resolve(frameType) {
+        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;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD,MAAM,OAAO,aAAa;IACP,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEzD,QAAQ,CAAC,SAAoB,EAAE,GAAe;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,SAAoB;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,aAAa,CACrB,wCAAwC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/core/status-codes.d.ts

@@ -0,0 +1,29 @@
+/** NPS native status code constants. */
+export declare const NpsStatusCodes: {
+    readonly NPS_OK: "NPS-OK";
+    readonly NPS_OK_ACCEPTED: "NPS-OK-ACCEPTED";
+    readonly NPS_OK_NO_CONTENT: "NPS-OK-NO-CONTENT";
+    readonly NPS_AUTH_UNAUTHENTICATED: "NPS-AUTH-UNAUTHENTICATED";
+    readonly NPS_AUTH_FORBIDDEN: "NPS-AUTH-FORBIDDEN";
+    readonly NPS_CLIENT_BAD_FRAME: "NPS-CLIENT-BAD-FRAME";
+    readonly NPS_CLIENT_BAD_PARAM: "NPS-CLIENT-BAD-PARAM";
+    readonly NPS_CLIENT_NOT_FOUND: "NPS-CLIENT-NOT-FOUND";
+    readonly NPS_CLIENT_CONFLICT: "NPS-CLIENT-CONFLICT";
+    readonly NPS_CLIENT_GONE: "NPS-CLIENT-GONE";
+    readonly NPS_CLIENT_UNPROCESSABLE: "NPS-CLIENT-UNPROCESSABLE";
+    readonly NPS_SERVER_INTERNAL: "NPS-SERVER-INTERNAL";
+    readonly NPS_SERVER_UNAVAILABLE: "NPS-SERVER-UNAVAILABLE";
+    readonly NPS_SERVER_TIMEOUT: "NPS-SERVER-TIMEOUT";
+    readonly NPS_SERVER_ENCODING_UNSUPPORTED: "NPS-SERVER-ENCODING-UNSUPPORTED";
+    readonly NPS_SERVER_UNSUPPORTED: "NPS-SERVER-UNSUPPORTED";
+    readonly NPS_STREAM_SEQ_GAP: "NPS-STREAM-SEQ-GAP";
+    readonly NPS_STREAM_NOT_FOUND: "NPS-STREAM-NOT-FOUND";
+    readonly NPS_STREAM_LIMIT: "NPS-STREAM-LIMIT";
+    readonly NPS_LIMIT_RATE: "NPS-LIMIT-RATE";
+    readonly NPS_LIMIT_BUDGET: "NPS-LIMIT-BUDGET";
+    readonly NPS_LIMIT_PAYLOAD: "NPS-LIMIT-PAYLOAD";
+    readonly NPS_LIMIT_EXCEEDED: "NPS-LIMIT-EXCEEDED";
+    readonly NPS_PROTO_VERSION_INCOMPATIBLE: "NPS-PROTO-VERSION-INCOMPATIBLE";
+};
+export type NpsStatusCode = (typeof NpsStatusCodes)[keyof typeof NpsStatusCodes];
+//# sourceMappingURL=status-codes.d.ts.map

package/dist/core/status-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.d.ts","sourceRoot":"","sources":["../../src/core/status-codes.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAsCjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/core/status-codes.js

@@ -0,0 +1,39 @@
+// 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",
+};
+//# sourceMappingURL=status-codes.js.map

package/dist/core/status-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.js","sourceRoot":"","sources":["../../src/core/status-codes.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,qDAAqD;AAErD,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU;IACV,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IAEtC,OAAO;IACP,wBAAwB,EAAE,0BAA0B;IACpD,kBAAkB,EAAE,oBAAoB;IAExC,gBAAgB;IAChB,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,wBAAwB,EAAE,0BAA0B;IAEpD,gBAAgB;IAChB,mBAAmB,EAAE,qBAAqB;IAC1C,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,+BAA+B,EAAE,iCAAiC;IAClE,sBAAsB,EAAE,wBAAwB;IAEhD,SAAS;IACT,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,gBAAgB,EAAE,kBAAkB;IAEpC,QAAQ;IACR,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IAExC,WAAW;IACX,8BAA8B,EAAE,gCAAgC;CACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "1.0.0-alpha.2";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/{src/index.ts → dist/index.js}

@@ -6,5 +6,5 @@
 // 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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,yCAAyC;AACzC,iEAAiE;AACjE,0DAA0D;AAC1D,kDAAkD;AAClD,iDAAiD;AAEjD,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}

package/dist/ncp/frames/anchor-frame.d.ts

@@ -0,0 +1,29 @@
+declare const VALID_FIELD_TYPES: readonly ["string", "uint64", "int64", "decimal", "bool", "timestamp", "bytes", "object", "array"];
+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;
+}
+/**
+ * Compute anchor_id from schema using RFC 8785 JCS canonicalization + SHA-256.
+ * Format: "sha256:{64 lowercase hex chars}"
+ */
+export declare function computeAnchorId(schema: FrameSchema): string;
+/**
+ * Validate an AnchorFrame.
+ * @throws {NcpError} NCP-ANCHOR-SCHEMA-INVALID if anchor_id doesn't match or schema is invalid.
+ */
+export declare function validateAnchorFrame(frame: AnchorFrame): void;
+export {};
+//# sourceMappingURL=anchor-frame.d.ts.map

package/dist/ncp/frames/anchor-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/anchor-frame.ts"],"names":[],"mappings":"AAgBA,QAAA,MAAM,iBAAiB,oGAGb,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO3D;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAoB5D"}

package/dist/ncp/frames/anchor-frame.js

@@ -0,0 +1,54 @@
+// 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;
+import { NcpError } from "../../core/frame-header.js";
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+const VALID_FIELD_TYPES = [
+    "string", "uint64", "int64", "decimal", "bool",
+    "timestamp", "bytes", "object", "array",
+];
+// ---------------------------------------------------------------------------
+// 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) {
+    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) {
+    // Validate schema field types
+    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(", ")}`);
+        }
+    }
+    // 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}`);
+    }
+}
+//# sourceMappingURL=anchor-frame.js.map

package/dist/ncp/frames/anchor-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/anchor-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,0DAA0D;AAC1D,aAAa;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,mFAAmF;AACnF,OAAO,mBAAmB,MAAM,cAAc,CAAC;AAC/C,MAAM,YAAY,GAAG,mBAAwE,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG;IACxB,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;IAC9C,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO;CAC/B,CAAC;AAsBX,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,2BAA2B,EAAE,gCAAgC,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,8BAA8B;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAuB,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,QAAQ,CAChB,2BAA2B,EAC3B,2BAA2B,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,IAAI,KAAK;gBAClE,gBAAgB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAChB,2BAA2B,EAC3B,gCAAgC,QAAQ,SAAS,KAAK,CAAC,SAAS,EAAE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ncp/frames/caps-frame.d.ts

@@ -0,0 +1,29 @@
+import { 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 declare function validateCapsFrame(frame: CapsFrame): void;
+//# sourceMappingURL=caps-frame.d.ts.map

package/dist/ncp/frames/caps-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caps-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/caps-frame.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAiBxD"}

package/dist/ncp/frames/caps-frame.js

@@ -0,0 +1,29 @@
+// 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, } from "./anchor-frame.js";
+/**
+ * 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) {
+    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}`);
+        }
+    }
+}
+//# sourceMappingURL=caps-frame.js.map

package/dist/ncp/frames/caps-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caps-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/caps-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,+CAA+C;AAC/C,aAAa;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EACL,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAoB3B;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,mCAAmC,KAAK,CAAC,KAAK,iBAAiB,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,aAAa,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,QAAQ,CAChB,2BAA2B,EAC3B,8CAA8C,QAAQ,SAAS,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/ncp/frames/diff-frame.d.ts

@@ -0,0 +1,32 @@
+import { EncodingTier } from "../../core/frame-header.js";
+import { 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 declare function validateDiffSeq(frame: DiffFrame, currentSeq: number): void;
+/**
+ * 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 declare function validateDiffFrame(frame: DiffFrame, encodingTier: EncodingTier | number): void;
+//# sourceMappingURL=diff-frame.d.ts.map

package/dist/ncp/frames/diff-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/diff-frame.ts"],"names":[],"mappings":"AAMA,OAAO,EAAY,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,KAAK,EAAE,kBAAkB,EAAE,GAAG,UAAU,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,YAAY,GAAG,MAAM,GAClC,IAAI,CAkBN"}

package/dist/ncp/frames/diff-frame.js

@@ -0,0 +1,37 @@
+// 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 } from "../ncp-patch-format.js";
+/**
+ * Validate DiffFrame base_seq against current sequence.
+ * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequences don't match.
+ */
+export 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}`);
+    }
+}
+/**
+ * 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, encodingTier) {
+    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");
+    }
+}
+//# sourceMappingURL=diff-frame.js.map

package/dist/ncp/frames/diff-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/diff-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,4CAA4C;AAC5C,aAAa;AAEb,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,wBAAwB,CAAC;AAkB9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,UAAkB;IAClE,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,QAAQ,CAChB,oBAAoB,EACpB,sBAAsB,KAAK,CAAC,QAAQ,+BAA+B,UAAU,EAAE,CAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAgB,EAChB,YAAmC;IAEnC,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC;IAE/B,uBAAuB;IACvB,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,QAAQ,CAChB,6BAA6B,EAC7B,yBAAyB,MAAM,CAAC,GAAG,CAAC,GAAG,CACxC,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,IAAI,GAAG,KAAK,eAAe,IAAI,YAAY,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,IAAI,QAAQ,CAChB,6BAA6B,EAC7B,6DAA6D,CAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ncp/frames/error-frame.d.ts

@@ -0,0 +1,16 @@
+/** 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 declare function isErrorFrame(obj: unknown): obj is ErrorFrame;
+//# sourceMappingURL=error-frame.d.ts.map

package/dist/ncp/frames/error-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/error-frame.ts"],"names":[],"mappings":"AAMA,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAI5D"}

package/dist/ncp/frames/error-frame.js

@@ -0,0 +1,13 @@
+// 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
+/** Type guard for ErrorFrame. */
+export 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";
+}
+//# sourceMappingURL=error-frame.js.map

package/dist/ncp/frames/error-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/error-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,sEAAsE;AACtE,aAAa;AAgBb,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC3F,CAAC"}

package/dist/ncp/frames/hello-frame.d.ts

@@ -0,0 +1,21 @@
+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 declare function validateHelloFrame(frame: HelloFrame): void;
+//# sourceMappingURL=hello-frame.d.ts.map

package/dist/ncp/frames/hello-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/hello-frame.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAqB1D"}

package/dist/ncp/frames/hello-frame.js

@@ -0,0 +1,25 @@
+// 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";
+/**
+ * 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) {
+    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)");
+    }
+}
+//# sourceMappingURL=hello-frame.js.map

package/dist/ncp/frames/hello-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/hello-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,mDAAmD;AACnD,aAAa;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAetD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,gDAAgD,CACjD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,4EAA4E,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ncp/frames/stream-frame.d.ts

@@ -0,0 +1,16 @@
+export interface StreamFrame {
+    frame: string;
+    stream_id: string;
+    seq: number;
+    is_last: boolean;
+    anchor_ref?: string;
+    data: unknown[];
+    window_size?: number;
+    error_code?: string;
+}
+/**
+ * Validate stream_id is a valid UUID v4.
+ * @throws {NcpError} NPS-CLIENT-BAD-FRAME if stream_id is not a valid UUID v4.
+ */
+export declare function validateStreamFrame(frame: StreamFrame): void;
+//# sourceMappingURL=stream-frame.d.ts.map

package/dist/ncp/frames/stream-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-frame.d.ts","sourceRoot":"","sources":["../../../src/ncp/frames/stream-frame.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAO5D"}

package/dist/ncp/frames/stream-frame.js

@@ -0,0 +1,18 @@
+// 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";
+// 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) {
+    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`);
+    }
+}
+//# sourceMappingURL=stream-frame.js.map

package/dist/ncp/frames/stream-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-frame.js","sourceRoot":"","sources":["../../../src/ncp/frames/stream-frame.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,+DAA+D;AAC/D,aAAa;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAatD,4DAA4D;AAC5D,MAAM,UAAU,GACd,wEAAwE,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,cAAc,KAAK,CAAC,SAAS,0BAA0B,CACxD,CAAC;IACJ,CAAC;AACH,CAAC"}