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

package/dist/ncp/frames.d.ts

@@ -0,0 +1,94 @@
+import { EncodingTier, FrameType } from "../core/frames.js";
+import type { NpsFrame } from "../core/codec.js";
+export interface SchemaField {
+    name: string;
+    type: string;
+    semantic?: string;
+    nullable?: boolean;
+}
+export interface FrameSchema {
+    fields: readonly SchemaField[];
+}
+export declare class AnchorFrame implements NpsFrame {
+    readonly anchorId: string;
+    readonly schema: FrameSchema;
+    readonly ttl: number;
+    readonly frameType = FrameType.ANCHOR;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(anchorId: string, schema: FrameSchema, ttl?: number);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): AnchorFrame;
+}
+export interface JsonPatchOperation {
+    op: string;
+    path: string;
+    value?: unknown;
+}
+export declare class DiffFrame implements NpsFrame {
+    readonly anchorRef: string;
+    readonly baseSeq: number;
+    readonly patch: readonly JsonPatchOperation[];
+    readonly entityId?: string | undefined;
+    readonly frameType = FrameType.DIFF;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(anchorRef: string, baseSeq: number, patch: readonly JsonPatchOperation[], entityId?: string | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): DiffFrame;
+}
+export declare class StreamFrame implements NpsFrame {
+    readonly streamId: string;
+    readonly seq: number;
+    readonly isLast: boolean;
+    readonly data: readonly Record<string, unknown>[];
+    readonly anchorRef?: string | undefined;
+    readonly windowSize?: number | undefined;
+    readonly frameType = FrameType.STREAM;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(streamId: string, seq: number, isLast: boolean, data: readonly Record<string, unknown>[], anchorRef?: string | undefined, windowSize?: number | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): StreamFrame;
+}
+export declare class CapsFrame implements NpsFrame {
+    readonly anchorRef: string;
+    readonly count: number;
+    readonly data: readonly Record<string, unknown>[];
+    readonly nextCursor?: string | undefined;
+    readonly tokenEst?: number | undefined;
+    readonly cached?: boolean | undefined;
+    readonly tokenizerUsed?: string | undefined;
+    readonly frameType = FrameType.CAPS;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(anchorRef: string, count: number, data: readonly Record<string, unknown>[], nextCursor?: string | undefined, tokenEst?: number | undefined, cached?: boolean | undefined, tokenizerUsed?: string | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): CapsFrame;
+}
+export declare class ErrorFrame implements NpsFrame {
+    readonly status: string;
+    readonly error: string;
+    readonly message?: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    readonly frameType = FrameType.ERROR;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(status: string, error: string, message?: string | undefined, details?: Record<string, unknown> | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): ErrorFrame;
+}
+export declare class HelloFrame implements NpsFrame {
+    readonly npsVersion: string;
+    readonly supportedEncodings: readonly string[];
+    readonly supportedProtocols: readonly string[];
+    minVersion?: string | undefined;
+    agentId?: string | undefined;
+    maxFramePayload: number;
+    extSupport: boolean;
+    maxConcurrentStreams: number;
+    e2eEncAlgorithms?: readonly string[] | undefined;
+    readonly frameType = FrameType.HELLO;
+    readonly preferredTier = EncodingTier.JSON;
+    static readonly DEFAULT_MAX_FRAME_PAYLOAD = 65535;
+    static readonly DEFAULT_MAX_CONCURRENT_STREAMS = 32;
+    constructor(npsVersion: string, supportedEncodings: readonly string[], supportedProtocols: readonly string[], minVersion?: string | undefined, agentId?: string | undefined, maxFramePayload?: number, extSupport?: boolean, maxConcurrentStreams?: number, e2eEncAlgorithms?: readonly string[] | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): HelloFrame;
+}
+//# sourceMappingURL=frames.d.ts.map

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

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

package/dist/ncp/frames.js

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

package/dist/ncp/frames.js.map

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

package/dist/ncp/handshake.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Negotiate the session NPS version between client and server.
+ *
+ * Session version = numeric min of client.nps_version and server.nps_version
+ * (component-wise — "0.9" < "0.10" < "1.0").
+ * If the effective client minimum (min_version ?? nps_version) > server.nps_version,
+ * the versions are incompatible.
+ *
+ * Spec: NPS-1 §2.6
+ */
+export declare function negotiateVersion(client: {
+    nps_version: string;
+    min_version?: string;
+}, server: {
+    nps_version: string;
+}): {
+    session_version: string;
+    compatible: boolean;
+    error_code?: string;
+};
+/**
+ * Negotiate the encoding between client and server preferred lists.
+ *
+ * Returns the first mutually supported encoding, preferring "msgpack" over "json".
+ * Returns null if there is no intersection.
+ */
+export declare function negotiateEncoding(client: string[], server: string[]): {
+    encoding: string | null;
+};
+//# sourceMappingURL=handshake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/ncp/handshake.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EACrD,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAmBvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAmB7B"}

package/dist/ncp/handshake.js

@@ -0,0 +1,80 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+//
+// Handshake — Version negotiation and encoding negotiation
+// NPS-1 §2.6
+/**
+ * Parse a "major.minor" (optionally "major.minor.patch") version string into a
+ * tuple of numeric components. Invalid parts become NaN which makes subsequent
+ * comparisons return false in both directions (safe failure).
+ */
+function parseVersion(v) {
+    return v.split(".").map((p) => Number.parseInt(p, 10));
+}
+/**
+ * Numeric component-wise comparison of two version strings.
+ * Returns negative if a < b, zero if equal, positive if a > b.
+ * Avoids the lexicographic pitfall where "0.9" > "0.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;
+}
+/**
+ * Negotiate the session NPS version between client and server.
+ *
+ * Session version = numeric min of client.nps_version and server.nps_version
+ * (component-wise — "0.9" < "0.10" < "1.0").
+ * If the effective client minimum (min_version ?? nps_version) > server.nps_version,
+ * the versions are incompatible.
+ *
+ * Spec: NPS-1 §2.6
+ */
+export 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",
+        };
+    }
+    // Session version = component-wise min of client.nps_version and server.nps_version
+    const sessionVersion = compareVersions(client.nps_version, serverVersion) <= 0
+        ? client.nps_version
+        : serverVersion;
+    return { session_version: sessionVersion, compatible: true };
+}
+/**
+ * Negotiate the encoding between client and server preferred lists.
+ *
+ * Returns the first mutually supported encoding, preferring "msgpack" over "json".
+ * Returns null if there is no intersection.
+ */
+export function negotiateEncoding(client, server) {
+    const serverSet = new Set(server);
+    // Prefer msgpack over json (and over any other encoding)
+    if (client.includes("msgpack") && serverSet.has("msgpack")) {
+        return { encoding: "msgpack" };
+    }
+    if (client.includes("json") && serverSet.has("json")) {
+        return { encoding: "json" };
+    }
+    // Fall back to first intersection in client-preference order
+    for (const enc of client) {
+        if (serverSet.has(enc)) {
+            return { encoding: enc };
+        }
+    }
+    return { encoding: null };
+}
+//# sourceMappingURL=handshake.js.map

package/dist/ncp/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/ncp/handshake.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,2DAA2D;AAC3D,aAAa;AAEb;;;;GAIG;AACH,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAqD,EACrD,MAA+B;IAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;IAC3D,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC;IAEzC,IAAI,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,eAAe,EAAE,aAAa;YAC9B,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,0BAA0B;SACvC,CAAC;IACJ,CAAC;IAED,oFAAoF;IACpF,MAAM,cAAc,GAClB,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,WAAW;QACpB,CAAC,CAAC,aAAa,CAAC;IAEpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAgB,EAChB,MAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAElC,yDAAyD;IACzD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/ncp/index.d.ts

@@ -0,0 +1,12 @@
+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";
+export * from "./preamble.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;AACpC,cAAc,eAAe,CAAC"}

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

@@ -11,3 +11,4 @@ export * from "./ncp-patch-format.js";
 export * from "./handshake.js";
 export * from "./stream-manager.js";
 export * from "./preamble.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;AACpC,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,23 @@
+export declare const NCP_ERROR_CODES: {
+    readonly NCP_FRAME_PARSE_ERROR: "NCP-FRAME-PARSE-ERROR";
+    readonly NCP_FRAME_INCOMPLETE: "NCP-FRAME-INCOMPLETE";
+    readonly NCP_PREAMBLE_INVALID: "NCP-PREAMBLE-INVALID";
+    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;;;;;;;;;;;;;;;;;;;;CAuBlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+// 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",
+    // NPS-RFC-0001 — native-mode preamble
+    NCP_PREAMBLE_INVALID: "NCP-PREAMBLE-INVALID",
+    // 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,sCAAsC;IACtC,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/preamble.d.ts

@@ -0,0 +1,47 @@
+/**
+ * NCP native-mode connection preamble — the 8-byte ASCII constant
+ * `"NPS/1.0\n"` that every native-mode client MUST emit immediately
+ * after the transport handshake and before its first HelloFrame.
+ * Defined by NPS-RFC-0001 and NPS-1 NCP §2.6.1.
+ *
+ * HTTP-mode connections do not use the preamble.
+ */
+export declare const PREAMBLE_LITERAL = "NPS/1.0\n";
+export declare const PREAMBLE_LENGTH = 8;
+export declare const PREAMBLE_BYTES: Uint8Array;
+/** Validation timeout in milliseconds (NPS-RFC-0001 §4.1). */
+export declare const PREAMBLE_READ_TIMEOUT_MS = 10000;
+/** Maximum delay before closing after a mismatch, in milliseconds. */
+export declare const PREAMBLE_CLOSE_DEADLINE_MS = 500;
+export declare const PREAMBLE_ERROR_CODE = "NCP-PREAMBLE-INVALID";
+export declare const PREAMBLE_STATUS_CODE = "NPS-PROTO-PREAMBLE-INVALID";
+export declare class NcpPreambleInvalidError extends Error {
+    readonly errorCode = "NCP-PREAMBLE-INVALID";
+    readonly statusCode = "NPS-PROTO-PREAMBLE-INVALID";
+    constructor(reason: string);
+}
+/**
+ * Returns `true` iff `buf` starts with the 8-byte NPS/1.0 preamble.
+ * Safe to call with shorter buffers.
+ */
+export declare function preambleMatches(buf: Uint8Array): boolean;
+/**
+ * Validates a presumed-preamble buffer.
+ * Returns `{ valid: true, reason: "" }` on success or `{ valid: false, reason }` on failure.
+ */
+export declare function tryValidatePreamble(buf: Uint8Array): {
+    valid: boolean;
+    reason: string;
+};
+/**
+ * Validates a presumed-preamble buffer, throwing {@link NcpPreambleInvalidError} on mismatch.
+ */
+export declare function validatePreamble(buf: Uint8Array): void;
+/**
+ * Writes the preamble bytes to `writer`.
+ * `writer` must expose a `write(buf: Uint8Array): void` method (e.g. Node.js `net.Socket`).
+ */
+export declare function writePreamble(writer: {
+    write(buf: Uint8Array): void;
+}): void;
+//# sourceMappingURL=preamble.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.d.ts","sourceRoot":"","sources":["../../src/ncp/preamble.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,cAAc,EAAE,UAAuD,CAAC;AACrF,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,eAAO,MAAM,mBAAmB,yBAA0B,CAAC;AAC3D,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AAEjE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,SAAS,0BAAwB;IAC1C,QAAQ,CAAC,UAAU,gCAAwB;gBAE/B,MAAM,EAAE,MAAM;CAI3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAMxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAavF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAGtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAE5E"}