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

package/dist/nip/x509/verifier.js

@@ -0,0 +1,171 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Verifies NPS X.509 NID certificate chains per NPS-RFC-0002 §4.
+ *
+ * Stages (RFC §4.6):
+ * 1. Decode chain (base64url DER → @peculiar/x509 X509Certificate).
+ * 2. Leaf EKU check — critical, contains agent-identity OR node-identity OID.
+ * 3. Subject CN / SAN URI match against asserted NID.
+ * 4. Assurance-level extension match against asserted level (if both present).
+ * 5. Chain signature verification — leaf → intermediates → trusted root.
+ */
+import * as x509 from "@peculiar/x509";
+import { AssuranceLevel } from "../assurance-level.js";
+import * as ec from "../error-codes.js";
+import { EKU_AGENT_IDENTITY, EKU_NODE_IDENTITY, NID_ASSURANCE_LEVEL, OID_EXTENDED_KEY_USAGE, } from "./oids.js";
+x509.cryptoProvider.set(globalThis.crypto);
+function ok(leaf) {
+    return { valid: true, leaf };
+}
+function fail(errorCode, message) {
+    return { valid: false, errorCode, message };
+}
+export async function verify(opts) {
+    // Stage 1: decode chain ─────────────────────────────────────────────────
+    if (!opts.certChainBase64UrlDer.length) {
+        return fail(ec.CERT_FORMAT_INVALID, "cert_chain is empty");
+    }
+    let chain;
+    try {
+        chain = opts.certChainBase64UrlDer.map((s) => new x509.X509Certificate(b64uDecode(s).buffer));
+    }
+    catch (e) {
+        return fail(ec.CERT_FORMAT_INVALID, `DER decode failed: ${e.message}`);
+    }
+    const leaf = chain[0];
+    // Stage 2: EKU check ────────────────────────────────────────────────────
+    const ekuResult = checkLeafEku(leaf);
+    if (!ekuResult.valid)
+        return ekuResult;
+    // Stage 3: subject CN / SAN URI match ──────────────────────────────────
+    const subjectResult = checkSubjectNid(leaf, opts.assertedNid);
+    if (!subjectResult.valid)
+        return subjectResult;
+    // Stage 4: assurance-level extension ───────────────────────────────────
+    const assuranceResult = checkAssuranceLevel(leaf, opts.assertedAssuranceLevel);
+    if (!assuranceResult.valid)
+        return assuranceResult;
+    // Stage 5: chain signature verification ────────────────────────────────
+    const chainResult = await checkChainSignature(chain, opts.trustedRootCerts);
+    if (!chainResult.valid)
+        return chainResult;
+    return ok(leaf);
+}
+// ── Stage helpers ──────────────────────────────────────────────────────────
+function checkLeafEku(leaf) {
+    const ekuExt = leaf.extensions.find((e) => e.type === OID_EXTENDED_KEY_USAGE);
+    if (!ekuExt) {
+        return fail(ec.CERT_EKU_MISSING, "leaf has no ExtendedKeyUsage extension");
+    }
+    if (!ekuExt.critical) {
+        return fail(ec.CERT_EKU_MISSING, "ExtendedKeyUsage extension is not marked critical");
+    }
+    const usages = ekuExt.usages;
+    if (!usages.includes(EKU_AGENT_IDENTITY) && !usages.includes(EKU_NODE_IDENTITY)) {
+        return fail(ec.CERT_EKU_MISSING, "ExtendedKeyUsage does not contain agent-identity or node-identity OID");
+    }
+    return ok(leaf);
+}
+function checkSubjectNid(leaf, assertedNid) {
+    // @peculiar/x509 parses the subject DN; iterate to find CN.
+    const cn = extractCn(leaf.subject);
+    if (cn !== assertedNid) {
+        return fail(ec.CERT_SUBJECT_NID_MISMATCH, `leaf subject CN (${cn ?? "<missing>"}) does not match asserted NID (${assertedNid})`);
+    }
+    const sanExt = leaf.getExtension(x509.SubjectAlternativeNameExtension);
+    if (!sanExt) {
+        return fail(ec.CERT_SUBJECT_NID_MISMATCH, "leaf has no Subject Alternative Name extension");
+    }
+    // SubjectAlternativeNameExtension exposes general-name objects with `type: "url"` for URIs.
+    const uris = sanExt.names
+        .toJSON()
+        .filter((n) => n.type === "url")
+        .map((n) => n.value);
+    if (!uris.includes(assertedNid)) {
+        return fail(ec.CERT_SUBJECT_NID_MISMATCH, "no SAN URI matches asserted NID");
+    }
+    return ok(leaf);
+}
+function checkAssuranceLevel(leaf, asserted) {
+    if (asserted === null)
+        return ok(leaf);
+    const ext = leaf.extensions.find((e) => e.type === NID_ASSURANCE_LEVEL);
+    if (!ext) {
+        // Optional in v0.1 — pass silently.
+        return ok(leaf);
+    }
+    const der = new Uint8Array(ext.value);
+    // Decode ASN.1 ENUMERATED: tag=0x0A, len=0x01, content=<rank>.
+    if (der.length !== 3 || der[0] !== 0x0A || der[1] !== 0x01) {
+        return fail(ec.CERT_FORMAT_INVALID, `malformed assurance-level extension: ${Buffer.from(der).toString("hex")}`);
+    }
+    const rank = der[2];
+    let certLevel;
+    try {
+        certLevel = AssuranceLevel.fromRank(rank);
+    }
+    catch {
+        return fail(ec.ASSURANCE_UNKNOWN, `assurance-level extension contains unknown value: ${rank}`);
+    }
+    if (certLevel !== asserted) {
+        return fail(ec.ASSURANCE_MISMATCH, `cert assurance-level (${certLevel.wire}) does not match asserted (${asserted.wire})`);
+    }
+    return ok(leaf);
+}
+async function checkChainSignature(chain, trustedRoots) {
+    if (!trustedRoots.length) {
+        return fail(ec.CERT_FORMAT_INVALID, "no trusted X.509 roots configured");
+    }
+    try {
+        // Walk leaf → intermediates: each must be signed by its successor.
+        for (let i = 0; i < chain.length - 1; i++) {
+            const okStep = await chain[i].verify({ publicKey: await chain[i + 1].publicKey.export(), signatureOnly: true });
+            if (!okStep) {
+                return fail(ec.CERT_FORMAT_INVALID, `chain link ${i} signature did not verify`);
+            }
+        }
+        // The last cert in the chain MUST chain to a trusted root.
+        const last = chain[chain.length - 1];
+        for (const root of trustedRoots) {
+            if (Buffer.from(last.rawData).equals(Buffer.from(root.rawData))) {
+                return ok(chain[0]);
+            }
+            try {
+                const okStep = await last.verify({ publicKey: await root.publicKey.export(), signatureOnly: true });
+                if (okStep)
+                    return ok(chain[0]);
+            }
+            catch {
+                /* try next root */
+            }
+        }
+        return fail(ec.CERT_FORMAT_INVALID, "chain does not anchor to any trusted root");
+    }
+    catch (e) {
+        return fail(ec.CERT_FORMAT_INVALID, `chain signature verification error: ${e.message}`);
+    }
+}
+// ── helpers ────────────────────────────────────────────────────────────────
+function extractCn(dn) {
+    // @peculiar/x509 returns DN strings in RFC 4514 format ("CN=...,O=...").
+    for (const rdn of dn.split(",")) {
+        const trimmed = rdn.trim();
+        if (trimmed.startsWith("CN=")) {
+            let value = trimmed.slice(3);
+            // Strip surrounding quotes if any.
+            if (value.startsWith("\"") && value.endsWith("\"")) {
+                value = value.slice(1, -1);
+            }
+            // Unescape.
+            return value.replace(/\\([",+;<>\\])/g, "$1");
+        }
+    }
+    return null;
+}
+function b64uDecode(s) {
+    const padded = s + "=".repeat((4 - (s.length % 4)) % 4);
+    const std = padded.replace(/-/g, "+").replace(/_/g, "/");
+    return new Uint8Array(Buffer.from(std, "base64"));
+}
+//# sourceMappingURL=verifier.js.map

package/dist/nip/x509/verifier.js.map

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

package/dist/nop/client.d.ts

@@ -0,0 +1,34 @@
+import { EncodingTier } from "../core/frames.js";
+import { FrameRegistry } from "../core/registry.js";
+import { TaskState } from "./models.js";
+import type { TaskFrame } from "./frames.js";
+export declare class NopTaskStatus {
+    private readonly _raw;
+    constructor(_raw: Record<string, unknown>);
+    get taskId(): string;
+    get state(): TaskState;
+    get isTerminal(): boolean;
+    get aggregatedResult(): unknown;
+    get errorCode(): string | undefined;
+    get errorMessage(): string | undefined;
+    get nodeResults(): Record<string, unknown>;
+    get raw(): Record<string, unknown>;
+    toString(): string;
+}
+export declare class NopClient {
+    private readonly _baseUrl;
+    private readonly _codec;
+    private readonly _tier;
+    constructor(baseUrl: string, options?: {
+        defaultTier?: EncodingTier;
+        registry?: FrameRegistry;
+    });
+    submit(frame: TaskFrame): Promise<string>;
+    getStatus(taskId: string): Promise<NopTaskStatus>;
+    cancel(taskId: string): Promise<void>;
+    wait(taskId: string, options?: {
+        pollIntervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<NopTaskStatus>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/nop/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/nop/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1D,IAAI,MAAM,IAAc,MAAM,CAAyD;IACvF,IAAI,KAAK,IAAe,SAAS,CAAsD;IACvF,IAAI,UAAU,IAAU,OAAO,CAA6E;IAC5G,IAAI,gBAAgB,IAAI,OAAO,CAAuD;IACtF,IAAI,SAAS,IAAW,MAAM,GAAG,SAAS,CAAwE;IAClH,IAAI,YAAY,IAAQ,MAAM,GAAG,SAAS,CAAwE;IAClH,IAAI,WAAW,IAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAqF;IACpI,IAAI,GAAG,IAAiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAsB;IAErE,QAAQ,IAAI,MAAM;CAGnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAGtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;KAAO;IAclE,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQjD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,IAAI,CACR,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5D,OAAO,CAAC,aAAa,CAAC;CAgB1B"}

package/dist/nop/client.js

@@ -0,0 +1,90 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { NpsFrameCodec } from "../core/codec.js";
+import { EncodingTier } from "../core/frames.js";
+import { FrameRegistry } from "../core/registry.js";
+import { registerNcpFrames } from "../ncp/registry.js";
+import { registerNopFrames } from "./registry.js";
+import { TaskState } from "./models.js";
+const TERMINAL_STATES = new Set([
+    TaskState.COMPLETED,
+    TaskState.FAILED,
+    TaskState.CANCELLED,
+]);
+export class NopTaskStatus {
+    _raw;
+    constructor(_raw) {
+        this._raw = _raw;
+    }
+    get taskId() { return this._raw["task_id"]; }
+    get state() { return this._raw["state"]; }
+    get isTerminal() { return TERMINAL_STATES.has(this._raw["state"]); }
+    get aggregatedResult() { return this._raw["aggregated_result"]; }
+    get errorCode() { return this._raw["error_code"] ?? undefined; }
+    get errorMessage() { return this._raw["error_message"] ?? undefined; }
+    get nodeResults() { return this._raw["node_results"] ?? {}; }
+    get raw() { return this._raw; }
+    toString() {
+        return `NopTaskStatus(taskId=${this.taskId}, state=${String(this._raw["state"])})`;
+    }
+}
+export class NopClient {
+    _baseUrl;
+    _codec;
+    _tier;
+    constructor(baseUrl, options = {}) {
+        this._baseUrl = baseUrl.replace(/\/$/, "");
+        this._tier = options.defaultTier ?? EncodingTier.MSGPACK;
+        const registry = options.registry ?? (() => {
+            const r = new FrameRegistry();
+            registerNcpFrames(r);
+            registerNopFrames(r);
+            return r;
+        })();
+        this._codec = new NpsFrameCodec(registry);
+    }
+    async submit(frame) {
+        const wire = this._codec.encode(frame, { overrideTier: this._tier });
+        const res = await fetch(`${this._baseUrl}/task`, {
+            method: "POST",
+            body: wire,
+            headers: { "Content-Type": "application/x-nps-frame", "Accept": "application/json" },
+        });
+        if (!res.ok)
+            throw new Error(`NOP /task failed: HTTP ${res.status}`);
+        const data = await res.json();
+        return data["task_id"];
+    }
+    async getStatus(taskId) {
+        const res = await fetch(`${this._baseUrl}/task/${taskId}`, {
+            headers: { "Accept": "application/json" },
+        });
+        if (!res.ok)
+            throw new Error(`NOP /task/${taskId} failed: HTTP ${res.status}`);
+        return new NopTaskStatus(await res.json());
+    }
+    async cancel(taskId) {
+        const res = await fetch(`${this._baseUrl}/task/${taskId}/cancel`, {
+            method: "POST",
+            headers: { "Accept": "application/json" },
+        });
+        if (!res.ok)
+            throw new Error(`NOP /task/${taskId}/cancel failed: HTTP ${res.status}`);
+    }
+    async wait(taskId, options = {}) {
+        const pollIntervalMs = options.pollIntervalMs ?? 1000;
+        const timeoutMs = options.timeoutMs ?? 30_000;
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            const status = await this.getStatus(taskId);
+            if (status.isTerminal)
+                return status;
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                throw new Error(`Task '${taskId}' did not complete within ${timeoutMs}ms (state: ${String(status.raw["state"])}).`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, Math.min(pollIntervalMs, remaining)));
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/nop/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/nop/client.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAY;IACzC,SAAS,CAAC,SAAS;IACnB,SAAS,CAAC,MAAM;IAChB,SAAS,CAAC,SAAS;CACpB,CAAC,CAAC;AAEH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAA6B;QAA7B,SAAI,GAAJ,IAAI,CAAyB;IAAG,CAAC;IAE9D,IAAI,MAAM,KAAoC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAY,CAAC,CAAC,CAAC;IACvF,IAAI,KAAK,KAAqC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAc,CAAC,CAAC,CAAC;IACvF,IAAI,UAAU,KAAgC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAc,CAAC,CAAC,CAAC,CAAC;IAC5G,IAAI,gBAAgB,KAA0B,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACtF,IAAI,SAAS,KAAiC,OAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,CAAsB,IAAI,SAAS,CAAC,CAAC,CAAC;IAClH,IAAI,YAAY,KAA8B,OAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAmB,IAAI,SAAS,CAAC,CAAC,CAAC;IAClH,IAAI,WAAW,KAAmC,OAAQ,IAAI,CAAC,IAAI,CAAC,cAAc,CAAyC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpI,IAAI,GAAG,KAA2C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAErE,QAAQ;QACN,OAAO,wBAAwB,IAAI,CAAC,MAAM,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC;IACrF,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACH,QAAQ,CAAS;IACjB,MAAM,CAAkB;IACxB,KAAK,CAAkB;IAExC,YACE,OAAe,EACf,UAAoE,EAAE;QAEtE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAM,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,OAAO,CAAC;QAE5D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE;YACzC,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;YAC9B,iBAAiB,CAAC,CAAC,CAAC,CAAC;YACrB,iBAAiB,CAAC,CAAC,CAAC,CAAC;YACrB,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAgB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACrE,MAAM,GAAG,GAAI,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,OAAO,EAAE;YAChD,MAAM,EAAG,MAAM;YACf,IAAI,EAAK,IAAgB;YACzB,OAAO,EAAE,EAAE,cAAc,EAAE,yBAAyB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SACrF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA6B,CAAC;QACzD,OAAO,IAAI,CAAC,SAAS,CAAW,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,SAAS,MAAM,EAAE,EAAE;YACzD,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,EAA6B,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,SAAS,MAAM,SAAS,EAAE;YAChE,MAAM,EAAG,MAAM;YACf,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAc,EACd,UAA2D,EAAE;QAE7D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QACtD,MAAM,SAAS,GAAQ,OAAO,CAAC,SAAS,IAAS,MAAM,CAAC;QACxD,MAAM,QAAQ,GAAS,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,MAAM,CAAC,UAAU;gBAAE,OAAO,MAAM,CAAC;YAErC,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,6BAA6B,SAAS,cAAc,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;YACtH,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;CACF"}

package/dist/nop/frames.d.ts

@@ -0,0 +1,65 @@
+import { EncodingTier, FrameType } from "../core/frames.js";
+import type { NpsFrame } from "../core/codec.js";
+import type { AggregateStrategy, TaskContext, TaskDag, TaskPriority } from "./models.js";
+export declare class TaskFrame implements NpsFrame {
+    readonly taskId: string;
+    readonly dag: TaskDag;
+    readonly timeoutMs?: number | undefined;
+    readonly callbackUrl?: string | undefined;
+    readonly context?: TaskContext | undefined;
+    readonly priority?: TaskPriority | undefined;
+    readonly depth?: number | undefined;
+    readonly frameType = FrameType.TASK;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId: string, dag: TaskDag, timeoutMs?: number | undefined, callbackUrl?: string | undefined, context?: TaskContext | undefined, priority?: TaskPriority | undefined, depth?: number | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): TaskFrame;
+}
+export declare class DelegateFrame implements NpsFrame {
+    readonly taskId: string;
+    readonly subtaskId: string;
+    readonly action: string;
+    readonly agentNid: string;
+    readonly inputs?: Record<string, unknown> | undefined;
+    readonly params?: Record<string, unknown> | undefined;
+    readonly idempotencyKey?: string | undefined;
+    readonly frameType = FrameType.DELEGATE;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId: string, subtaskId: string, action: string, agentNid: string, inputs?: Record<string, unknown> | undefined, params?: Record<string, unknown> | undefined, idempotencyKey?: string | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): DelegateFrame;
+}
+export declare class SyncFrame implements NpsFrame {
+    readonly taskId: string;
+    readonly syncId: string;
+    readonly waitFor: readonly string[];
+    readonly minRequired: number;
+    readonly aggregate: AggregateStrategy | string;
+    readonly timeoutMs?: number | undefined;
+    readonly frameType = FrameType.SYNC;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId: string, syncId: string, waitFor: readonly string[], minRequired?: number, aggregate?: AggregateStrategy | string, timeoutMs?: number | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): SyncFrame;
+}
+export interface StreamError {
+    errorCode: string;
+    message?: string;
+}
+export declare class AlignStreamFrame implements NpsFrame {
+    readonly streamId: string;
+    readonly taskId: string;
+    readonly subtaskId: string;
+    readonly seq: number;
+    readonly isFinal: boolean;
+    readonly senderNid: string;
+    readonly data?: Record<string, unknown> | undefined;
+    readonly error?: StreamError | undefined;
+    readonly windowSize?: number | undefined;
+    readonly frameType = FrameType.ALIGN_STREAM;
+    readonly preferredTier = EncodingTier.MSGPACK;
+    constructor(streamId: string, taskId: string, subtaskId: string, seq: number, isFinal: boolean, senderNid: string, data?: Record<string, unknown> | undefined, error?: StreamError | undefined, windowSize?: number | undefined);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): AlignStreamFrame;
+}
+//# sourceMappingURL=frames.d.ts.map

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

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

package/dist/nop/frames.js

@@ -0,0 +1,148 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { EncodingTier, FrameType } from "../core/frames.js";
+// ── TaskFrame ─────────────────────────────────────────────────────────────────
+export class TaskFrame {
+    taskId;
+    dag;
+    timeoutMs;
+    callbackUrl;
+    context;
+    priority;
+    depth;
+    frameType = FrameType.TASK;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId, dag, timeoutMs, callbackUrl, context, priority, depth) {
+        this.taskId = taskId;
+        this.dag = dag;
+        this.timeoutMs = timeoutMs;
+        this.callbackUrl = callbackUrl;
+        this.context = context;
+        this.priority = priority;
+        this.depth = depth;
+    }
+    toDict() {
+        return {
+            task_id: this.taskId,
+            dag: this.dag,
+            timeout_ms: this.timeoutMs ?? null,
+            callback_url: this.callbackUrl ?? null,
+            context: this.context ?? null,
+            priority: this.priority ?? null,
+            depth: this.depth ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new TaskFrame(data["task_id"], data["dag"], data["timeout_ms"] ?? undefined, data["callback_url"] ?? undefined, data["context"] ?? undefined, data["priority"] ?? undefined, data["depth"] ?? undefined);
+    }
+}
+// ── DelegateFrame ─────────────────────────────────────────────────────────────
+export class DelegateFrame {
+    taskId;
+    subtaskId;
+    action;
+    agentNid;
+    inputs;
+    params;
+    idempotencyKey;
+    frameType = FrameType.DELEGATE;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId, subtaskId, action, agentNid, inputs, params, idempotencyKey) {
+        this.taskId = taskId;
+        this.subtaskId = subtaskId;
+        this.action = action;
+        this.agentNid = agentNid;
+        this.inputs = inputs;
+        this.params = params;
+        this.idempotencyKey = idempotencyKey;
+    }
+    toDict() {
+        return {
+            task_id: this.taskId,
+            subtask_id: this.subtaskId,
+            action: this.action,
+            agent_nid: this.agentNid,
+            inputs: this.inputs ?? null,
+            params: this.params ?? null,
+            idempotency_key: this.idempotencyKey ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new DelegateFrame(data["task_id"], data["subtask_id"], data["action"], data["agent_nid"], data["inputs"] ?? undefined, data["params"] ?? undefined, data["idempotency_key"] ?? undefined);
+    }
+}
+// ── SyncFrame ─────────────────────────────────────────────────────────────────
+export class SyncFrame {
+    taskId;
+    syncId;
+    waitFor;
+    minRequired;
+    aggregate;
+    timeoutMs;
+    frameType = FrameType.SYNC;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(taskId, syncId, waitFor, minRequired = 0, aggregate = "merge", timeoutMs) {
+        this.taskId = taskId;
+        this.syncId = syncId;
+        this.waitFor = waitFor;
+        this.minRequired = minRequired;
+        this.aggregate = aggregate;
+        this.timeoutMs = timeoutMs;
+    }
+    toDict() {
+        return {
+            task_id: this.taskId,
+            sync_id: this.syncId,
+            wait_for: this.waitFor,
+            min_required: this.minRequired,
+            aggregate: this.aggregate,
+            timeout_ms: this.timeoutMs ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new SyncFrame(data["task_id"], data["sync_id"], data["wait_for"], data["min_required"] ?? 0, data["aggregate"] ?? "merge", data["timeout_ms"] ?? undefined);
+    }
+}
+// ── AlignStreamFrame ──────────────────────────────────────────────────────────
+export class AlignStreamFrame {
+    streamId;
+    taskId;
+    subtaskId;
+    seq;
+    isFinal;
+    senderNid;
+    data;
+    error;
+    windowSize;
+    frameType = FrameType.ALIGN_STREAM;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(streamId, taskId, subtaskId, seq, isFinal, senderNid, data, error, windowSize) {
+        this.streamId = streamId;
+        this.taskId = taskId;
+        this.subtaskId = subtaskId;
+        this.seq = seq;
+        this.isFinal = isFinal;
+        this.senderNid = senderNid;
+        this.data = data;
+        this.error = error;
+        this.windowSize = windowSize;
+    }
+    toDict() {
+        return {
+            stream_id: this.streamId,
+            task_id: this.taskId,
+            subtask_id: this.subtaskId,
+            seq: this.seq,
+            is_final: this.isFinal,
+            sender_nid: this.senderNid,
+            data: this.data ?? null,
+            error: this.error ? { error_code: this.error.errorCode, message: this.error.message ?? null } : null,
+            window_size: this.windowSize ?? null,
+        };
+    }
+    static fromDict(data) {
+        const rawError = data["error"];
+        return new AlignStreamFrame(data["stream_id"], data["task_id"], data["subtask_id"], data["seq"], data["is_final"], data["sender_nid"], data["data"] ?? undefined, rawError ? { errorCode: rawError.error_code, ...(rawError.message != null ? { message: rawError.message } : {}) } : undefined, data["window_size"] ?? undefined);
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/nop/frames.js.map

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

package/dist/nop/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./models.js";
+export * from "./frames.js";
+export * from "./registry.js";
+export * from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nop/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

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

@@ -1,7 +1,7 @@
 // Copyright 2026 INNO LOTUS PTY LTD
 // SPDX-License-Identifier: Apache-2.0
-
 export * from "./models.js";
 export * from "./frames.js";
 export * from "./registry.js";
 export * from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/nop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nop/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/nop/models.d.ts

@@ -0,0 +1,58 @@
+export declare enum TaskState {
+    PENDING = "pending",
+    PREFLIGHT = "preflight",
+    RUNNING = "running",
+    WAITING_SYNC = "waiting_sync",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    SKIPPED = "skipped"
+}
+export declare enum TaskPriority {
+    LOW = "low",
+    NORMAL = "normal",
+    HIGH = "high"
+}
+export declare enum BackoffStrategy {
+    FIXED = "fixed",
+    LINEAR = "linear",
+    EXPONENTIAL = "exponential"
+}
+export declare enum AggregateStrategy {
+    MERGE = "merge",
+    FIRST = "first",
+    FASTEST_K = "fastest_k",
+    ALL = "all"
+}
+export interface RetryPolicy {
+    maxRetries: number;
+    backoff: BackoffStrategy;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+export declare function computeDelayMs(policy: RetryPolicy, attempt: number): number;
+export interface TaskContext {
+    sessionKey?: string;
+    requesterNid?: string;
+    traceId?: string;
+}
+export interface DagNode {
+    id: string;
+    action: string;
+    agent: string;
+    inputFrom?: readonly string[];
+    inputMapping?: Record<string, string>;
+    timeoutMs?: number;
+    retryPolicy?: RetryPolicy;
+    condition?: string;
+    minRequired?: number;
+}
+export interface DagEdge {
+    from: string;
+    to: string;
+}
+export interface TaskDag {
+    nodes: readonly DagNode[];
+    edges: readonly DagEdge[];
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/nop/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/nop/models.ts"],"names":[],"mappings":"AAGA,oBAAY,SAAS;IACnB,OAAO,YAAkB;IACzB,SAAS,cAAkB;IAC3B,OAAO,YAAkB;IACzB,YAAY,iBAAkB;IAC9B,SAAS,cAAkB;IAC3B,MAAM,WAAkB;IACxB,SAAS,cAAkB;IAC3B,OAAO,YAAkB;CAC1B;AAED,oBAAY,YAAY;IACtB,GAAG,QAAW;IACd,MAAM,WAAW;IACjB,IAAI,SAAW;CAChB;AAED,oBAAY,eAAe;IACzB,KAAK,UAAgB;IACrB,MAAM,WAAgB;IACtB,WAAW,gBAAgB;CAC5B;AAED,oBAAY,iBAAiB;IAC3B,KAAK,UAAe;IACpB,KAAK,UAAe;IACpB,SAAS,cAAe;IACxB,GAAG,QAAe;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAI,MAAM,CAAC;IACrB,OAAO,EAAO,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU3E;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAK,MAAM,CAAC;IACvB,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAQ,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAc,MAAM,CAAC;IACvB,MAAM,EAAU,MAAM,CAAC;IACvB,KAAK,EAAW,MAAM,CAAC;IACvB,SAAS,CAAC,EAAM,SAAS,MAAM,EAAE,CAAC;IAClC,YAAY,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,WAAW,CAAC,EAAI,WAAW,CAAC;IAC5B,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,WAAW,CAAC,EAAI,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAI,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B"}