@labacacia/nps-sdk 1.0.0-alpha.1

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"}

package/dist/ncp/frames.d.ts

@@ -0,0 +1,76 @@
+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;
+}
+//# 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,147 @@
+// 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);
+    }
+}
+//# 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.cjs

@@ -0,0 +1,188 @@
+'use strict';
+
+// src/ncp/frames.ts
+var AnchorFrame = class _AnchorFrame {
+  constructor(anchorId, schema, ttl = 3600) {
+    this.anchorId = anchorId;
+    this.schema = schema;
+    this.ttl = ttl;
+  }
+  anchorId;
+  schema;
+  ttl;
+  frameType = 1 /* ANCHOR */;
+  preferredTier = 1 /* MSGPACK */;
+  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
+    );
+  }
+};
+var DiffFrame = class _DiffFrame {
+  constructor(anchorRef, baseSeq, patch, entityId) {
+    this.anchorRef = anchorRef;
+    this.baseSeq = baseSeq;
+    this.patch = patch;
+    this.entityId = entityId;
+  }
+  anchorRef;
+  baseSeq;
+  patch;
+  entityId;
+  frameType = 2 /* DIFF */;
+  preferredTier = 1 /* MSGPACK */;
+  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"] ?? void 0
+    );
+  }
+};
+var StreamFrame = class _StreamFrame {
+  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;
+  }
+  streamId;
+  seq;
+  isLast;
+  data;
+  anchorRef;
+  windowSize;
+  frameType = 3 /* STREAM */;
+  preferredTier = 1 /* MSGPACK */;
+  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"] ?? void 0,
+      data["window_size"] ?? void 0
+    );
+  }
+};
+var CapsFrame = class _CapsFrame {
+  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;
+  }
+  anchorRef;
+  count;
+  data;
+  nextCursor;
+  tokenEst;
+  cached;
+  tokenizerUsed;
+  frameType = 4 /* CAPS */;
+  preferredTier = 1 /* MSGPACK */;
+  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"] ?? void 0,
+      data["token_est"] ?? void 0,
+      data["cached"] ?? void 0,
+      data["tokenizer_used"] ?? void 0
+    );
+  }
+};
+var ErrorFrame = class _ErrorFrame {
+  constructor(status, error, message, details) {
+    this.status = status;
+    this.error = error;
+    this.message = message;
+    this.details = details;
+  }
+  status;
+  error;
+  message;
+  details;
+  frameType = 254 /* ERROR */;
+  preferredTier = 1 /* MSGPACK */;
+  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"] ?? void 0,
+      data["details"] ?? void 0
+    );
+  }
+};
+
+// src/ncp/registry.ts
+function registerNcpFrames(registry) {
+  registry.register(1 /* ANCHOR */, AnchorFrame);
+  registry.register(2 /* DIFF */, DiffFrame);
+  registry.register(3 /* STREAM */, StreamFrame);
+  registry.register(4 /* CAPS */, CapsFrame);
+  registry.register(254 /* ERROR */, ErrorFrame);
+}
+
+exports.AnchorFrame = AnchorFrame;
+exports.CapsFrame = CapsFrame;
+exports.DiffFrame = DiffFrame;
+exports.ErrorFrame = ErrorFrame;
+exports.StreamFrame = StreamFrame;
+exports.registerNcpFrames = registerNcpFrames;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map