@labacacia/nps-sdk 1.0.0-alpha.1

package/CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contributing to NPS
+
+Thank you for your interest in contributing to the Neural Protocol Suite.
+
+## Issue Prefixes
+
+| Prefix | Usage |
+|--------|-------|
+| `spec:` | Specification questions and design discussions |
+| `impl:` | Implementation bugs and fixes |
+| `sdk:`  | SDK (Python / TypeScript) related |
+| `docs:` | Documentation improvements |
+
+## Workflow
+
+1. Open an Issue first for any non-trivial change
+2. Fork the repo and create a branch: `feature/your-feature` or `fix/your-fix`
+3. Submit a Pull Request referencing the Issue
+
+## Spec Changes
+
+Changes to files under `spec/` require a discussion Issue before a PR is accepted.
+Spec changes that affect wire format or frame structure require a version bump.
+
+## Code Style
+
+- **C# / .NET**: Follow standard Microsoft C# conventions, nullable enabled
+- **Python**: PEP 8, type hints required
+- **TypeScript**: Strict mode enabled
+
+## License
+
+By contributing, you agree your contributions will be licensed under Apache 2.0.

package/LICENSE

@@ -0,0 +1,170 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of recording and
+      managing Contributions to the Work, but excluding communication that is
+      conspicularly marked or otherwise designated in writing by the copyright
+      owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contributor's Work constitutes direct or contributory patent
+      infringement, then any patent licenses granted to You under this
+      License for that Work shall terminate as of the date such litigation
+      is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work (and each Contributor
+      provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+      OR CONDITIONS OF ANY KIND, either express or implied, including,
+      without limitation, any warranties or conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (even if such Contributor has been advised of the possibility
+      of such damages).
+
+   9. Accepting Warranty or Liability. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a fee
+      for, acceptance of support, warranty, indemnity, or other liability
+      obligations and/or rights consistent with this License. However, in
+      accepting such obligations, You may offer only obligations consistent
+      with this License and for which You can fully compensate for any
+      resulting liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 INNO LOTUS PTY LTD
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing
+   permissions and limitations under the License.

package/NOTICE

@@ -0,0 +1,7 @@
+Neural Protocol Suite (NPS)
+Copyright 2026 INNO LOTUS PTY LTD
+
+This product includes software developed under the LabAcacia open-source lab,
+operated by INNO LOTUS PTY LTD (https://innolotus.com).
+
+NCP (Neural Communication Protocol) v0.2 was developed by Ori Lynn / INNO LOTUS PTY LTD.

package/README.md

@@ -0,0 +1,153 @@
+# @labacacia/nps-sdk — TypeScript / Node.js
+
+TypeScript SDK for the **Neural Protocol Suite** (NPS) — a protocol suite designed for AI Agents.  
+Part of the [LabAcacia](https://github.com/LabAcacia) / INNO LOTUS PTY LTD open-source ecosystem.
+
+## Status
+
+**v0.1.0 — Phase 2** · 5 protocols · 139 tests · ≥ 98% coverage
+
+| Protocol | Class | Status |
+|----------|-------|--------|
+| NCP — Neural Communication Protocol | Framing, codec | ✅ |
+| NWP — Neural Web Protocol | `NwpClient` | ✅ |
+| NIP — Neural Identity Protocol | `NipIdentity` | ✅ |
+| NDP — Neural Discovery Protocol | `InMemoryNdpRegistry`, `NdpAnnounceValidator` | ✅ |
+| NOP — Neural Orchestration Protocol | `NopClient` | ✅ |
+
+## Installation
+
+```bash
+npm install @labacacia/nps-sdk
+```
+
+> **Peer requirement:** Node.js 18+
+
+## Quick Start
+
+### NWP — query a node
+
+```typescript
+import { NwpClient, QueryFrame } from "@labacacia/nps-sdk/nwp";
+
+const client = new NwpClient("http://node.example.com:17433");
+const caps   = await client.query(new QueryFrame("sha256:<anchor-id>", { active: true }, 20));
+console.log(caps.count, caps.data);
+```
+
+### NWP — stream results
+
+```typescript
+for await (const chunk of client.stream(new QueryFrame("sha256:<anchor-id>"))) {
+  console.log(chunk.seq, chunk.data);
+}
+```
+
+### NWP — invoke an action
+
+```typescript
+import { ActionFrame } from "@labacacia/nps-sdk/nwp";
+
+const result = await client.invoke(new ActionFrame("summarise", { maxTokens: 500 }));
+```
+
+### NIP — Ed25519 identity
+
+```typescript
+import { NipIdentity } from "@labacacia/nps-sdk/nip";
+
+// Generate and persist
+const id = NipIdentity.generate();
+id.save("./my-key.json", process.env.KEY_PASS!);
+
+// Load and sign
+const loaded = NipIdentity.load("./my-key.json", process.env.KEY_PASS!);
+const sig    = loaded.sign({ action: "announce", nid: "urn:nps:node:example.com:data" });
+const ok     = loaded.verify({ action: "announce", nid: "urn:nps:node:example.com:data" }, sig);
+```
+
+### NDP — registry and signature validation
+
+```typescript
+import { InMemoryNdpRegistry, NdpAnnounceValidator } from "@labacacia/nps-sdk/ndp";
+import { AnnounceFrame } from "@labacacia/nps-sdk/ndp";
+
+const registry  = new InMemoryNdpRegistry();
+const validator = new NdpAnnounceValidator();
+validator.registerPublicKey(nid, identity.pubKeyString);
+
+registry.announce(frame);
+const resolved = registry.resolve("nwp://example.com/data/items");
+```
+
+### NOP — submit and wait for a task
+
+```typescript
+import { NopClient, TaskFrame } from "@labacacia/nps-sdk/nop";
+
+const client = new NopClient("http://orchestrator.example.com:17433");
+const dag    = {
+  nodes: [{ id: "classify", action: "classify-text", agent: "urn:nps:node:ml.example.com:classifier" }],
+  edges: [],
+};
+
+const taskId = await client.submit(new TaskFrame("my-task-1", dag));
+const status = await client.wait(taskId, { timeoutMs: 30_000 });
+console.log(status.state, status.aggregatedResult);
+```
+
+## Package Exports
+
+```typescript
+import { ... } from "@labacacia/nps-sdk";           // everything
+import { ... } from "@labacacia/nps-sdk/core";       // codec, frames, registry, cache
+import { ... } from "@labacacia/nps-sdk/ncp";        // AnchorFrame, CapsFrame, StreamFrame, …
+import { ... } from "@labacacia/nps-sdk/nwp";        // NwpClient, QueryFrame, ActionFrame
+import { ... } from "@labacacia/nps-sdk/nip";        // NipIdentity, IdentFrame, TrustFrame, RevokeFrame
+import { ... } from "@labacacia/nps-sdk/ndp";        // InMemoryNdpRegistry, NdpAnnounceValidator, AnnounceFrame, …
+import { ... } from "@labacacia/nps-sdk/nop";        // NopClient, NopTaskStatus, TaskFrame, …
+```
+
+## NCP Codec
+
+The codec layer supports dual-tier encoding and direct wire-format manipulation:
+
+```typescript
+import { NpsFrameCodec, EncodingTier } from "@labacacia/nps-sdk/core";
+import { createDefaultRegistry } from "@labacacia/nps-sdk";
+
+const codec = new NpsFrameCodec(createDefaultRegistry());
+
+// Encode (defaults to MsgPack)
+const wire = codec.encode(frame);
+
+// Encode as JSON (debugging / interop)
+const json = codec.encode(frame, { overrideTier: EncodingTier.JSON });
+
+// Decode
+const decoded = codec.decode(wire);
+
+// Peek at the header without decoding the payload
+const header = NpsFrameCodec.peekHeader(wire);
+console.log(header.frameType, header.isExtended, header.payloadLength);
+```
+
+## Development
+
+```bash
+# Install (no symlinks required on restricted filesystems)
+npm install --no-bin-links
+
+# Test
+node node_modules/vitest/vitest.mjs run
+
+# Test + coverage
+node node_modules/vitest/vitest.mjs run --coverage
+
+# Build (ESM + CJS)
+node node_modules/tsup/dist/cli-default.js
+```
+
+## License
+
+Apache 2.0 — see [LICENSE](../../LICENSE)

package/dist/codec-CmHeovTV.d.cts

@@ -0,0 +1,120 @@
+/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
+declare enum FrameType {
+    ANCHOR = 1,
+    DIFF = 2,
+    STREAM = 3,
+    CAPS = 4,
+    ALIGN = 5,// deprecated — use AlignStream (0x43)
+    QUERY = 16,
+    ACTION = 17,
+    IDENT = 32,
+    TRUST = 33,
+    REVOKE = 34,
+    ANNOUNCE = 48,
+    RESOLVE = 49,
+    GRAPH = 50,
+    TASK = 64,
+    DELEGATE = 65,
+    SYNC = 66,
+    ALIGN_STREAM = 67,
+    ERROR = 254
+}
+/**
+ * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
+ * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
+ * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
+ */
+declare enum EncodingTier {
+    JSON = 0,
+    MSGPACK = 1
+}
+/**
+ * Flags byte in the NPS frame header (NPS-1 §3.2).
+ * Bit layout (LSB = bit 0):
+ *   Bits 0–1 (T0,T1) : Encoding tier
+ *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
+ *   Bit 3  (ENC)     : Payload encrypted
+ *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
+ *   Bit 7  (EXT)     : Extended 8-byte header
+ */
+declare const FrameFlags: {
+    readonly NONE: 0;
+    readonly TIER1_JSON: 0;
+    readonly TIER2_MSGPACK: 1;
+    readonly FINAL: 4;
+    readonly ENCRYPTED: 8;
+    readonly EXT: 128;
+};
+declare const DEFAULT_HEADER_SIZE = 4;
+declare const EXTENDED_HEADER_SIZE = 8;
+declare const DEFAULT_MAX_PAYLOAD = 65535;
+declare const EXTENDED_MAX_PAYLOAD = 4294967295;
+/**
+ * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
+ *
+ * Default (4 bytes, EXT=0):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags
+ *   Byte 2–3 : PayloadLength (big-endian uint16)
+ *
+ * Extended (8 bytes, EXT=1):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags (bit 7 = 1)
+ *   Byte 2–3 : Reserved (must be 0)
+ *   Byte 4–7 : PayloadLength (big-endian uint32)
+ */
+declare class FrameHeader {
+    readonly frameType: FrameType;
+    readonly flags: number;
+    readonly payloadLength: number;
+    constructor(frameType: FrameType, flags: number, payloadLength: number);
+    get isExtended(): boolean;
+    get headerSize(): number;
+    get encodingTier(): EncodingTier;
+    get isFinal(): boolean;
+    get isEncrypted(): boolean;
+    static parse(buf: Uint8Array): FrameHeader;
+    toBytes(): Uint8Array;
+    toString(): string;
+}
+
+interface FrameClass {
+    fromDict(data: Record<string, unknown>): NpsFrame;
+}
+declare class FrameRegistry {
+    private readonly _map;
+    register(frameType: FrameType, cls: FrameClass): void;
+    resolve(frameType: FrameType): FrameClass;
+}
+
+interface NpsFrame {
+    readonly frameType: FrameType;
+    readonly preferredTier: EncodingTier;
+    toDict(): Record<string, unknown>;
+}
+declare class Tier1JsonCodec {
+    encode(frame: NpsFrame): Uint8Array;
+    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
+}
+declare class Tier2MsgPackCodec {
+    encode(frame: NpsFrame): Uint8Array;
+    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
+}
+declare class NpsFrameCodec {
+    private readonly _registry;
+    private readonly _maxPayload;
+    private readonly _json;
+    private readonly _msgpack;
+    constructor(registry: FrameRegistry, options?: {
+        maxPayload?: number;
+    });
+    encode(frame: NpsFrame, options?: {
+        overrideTier?: EncodingTier;
+    }): Uint8Array;
+    decode(wire: Uint8Array): NpsFrame;
+    static peekHeader(wire: Uint8Array): FrameHeader;
+    private _buildFlags;
+    private _selectCodec;
+}
+
+export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };

package/dist/codec-CmHeovTV.d.ts

@@ -0,0 +1,120 @@
+/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
+declare enum FrameType {
+    ANCHOR = 1,
+    DIFF = 2,
+    STREAM = 3,
+    CAPS = 4,
+    ALIGN = 5,// deprecated — use AlignStream (0x43)
+    QUERY = 16,
+    ACTION = 17,
+    IDENT = 32,
+    TRUST = 33,
+    REVOKE = 34,
+    ANNOUNCE = 48,
+    RESOLVE = 49,
+    GRAPH = 50,
+    TASK = 64,
+    DELEGATE = 65,
+    SYNC = 66,
+    ALIGN_STREAM = 67,
+    ERROR = 254
+}
+/**
+ * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
+ * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
+ * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
+ */
+declare enum EncodingTier {
+    JSON = 0,
+    MSGPACK = 1
+}
+/**
+ * Flags byte in the NPS frame header (NPS-1 §3.2).
+ * Bit layout (LSB = bit 0):
+ *   Bits 0–1 (T0,T1) : Encoding tier
+ *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
+ *   Bit 3  (ENC)     : Payload encrypted
+ *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
+ *   Bit 7  (EXT)     : Extended 8-byte header
+ */
+declare const FrameFlags: {
+    readonly NONE: 0;
+    readonly TIER1_JSON: 0;
+    readonly TIER2_MSGPACK: 1;
+    readonly FINAL: 4;
+    readonly ENCRYPTED: 8;
+    readonly EXT: 128;
+};
+declare const DEFAULT_HEADER_SIZE = 4;
+declare const EXTENDED_HEADER_SIZE = 8;
+declare const DEFAULT_MAX_PAYLOAD = 65535;
+declare const EXTENDED_MAX_PAYLOAD = 4294967295;
+/**
+ * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
+ *
+ * Default (4 bytes, EXT=0):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags
+ *   Byte 2–3 : PayloadLength (big-endian uint16)
+ *
+ * Extended (8 bytes, EXT=1):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags (bit 7 = 1)
+ *   Byte 2–3 : Reserved (must be 0)
+ *   Byte 4–7 : PayloadLength (big-endian uint32)
+ */
+declare class FrameHeader {
+    readonly frameType: FrameType;
+    readonly flags: number;
+    readonly payloadLength: number;
+    constructor(frameType: FrameType, flags: number, payloadLength: number);
+    get isExtended(): boolean;
+    get headerSize(): number;
+    get encodingTier(): EncodingTier;
+    get isFinal(): boolean;
+    get isEncrypted(): boolean;
+    static parse(buf: Uint8Array): FrameHeader;
+    toBytes(): Uint8Array;
+    toString(): string;
+}
+
+interface FrameClass {
+    fromDict(data: Record<string, unknown>): NpsFrame;
+}
+declare class FrameRegistry {
+    private readonly _map;
+    register(frameType: FrameType, cls: FrameClass): void;
+    resolve(frameType: FrameType): FrameClass;
+}
+
+interface NpsFrame {
+    readonly frameType: FrameType;
+    readonly preferredTier: EncodingTier;
+    toDict(): Record<string, unknown>;
+}
+declare class Tier1JsonCodec {
+    encode(frame: NpsFrame): Uint8Array;
+    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
+}
+declare class Tier2MsgPackCodec {
+    encode(frame: NpsFrame): Uint8Array;
+    decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
+}
+declare class NpsFrameCodec {
+    private readonly _registry;
+    private readonly _maxPayload;
+    private readonly _json;
+    private readonly _msgpack;
+    constructor(registry: FrameRegistry, options?: {
+        maxPayload?: number;
+    });
+    encode(frame: NpsFrame, options?: {
+        overrideTier?: EncodingTier;
+    }): Uint8Array;
+    decode(wire: Uint8Array): NpsFrame;
+    static peekHeader(wire: Uint8Array): FrameHeader;
+    private _buildFlags;
+    private _selectCodec;
+}
+
+export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };

package/dist/core/anchor-cache.d.ts

@@ -0,0 +1,42 @@
+import type { AnchorFrame } from "../ncp/frames/anchor-frame.js";
+/**
+ * AnchorFrame cache with:
+ * - TTL-based expiry (NPS-1 §5.3)
+ * - LRU eviction at maxSize (NPS-1 §9, default 1000)
+ * - Anchor poisoning detection (NPS-1 §7.2)
+ */
+export declare class AnchorCache {
+    private readonly cache;
+    private readonly maxSize;
+    private readonly getNow;
+    constructor(options?: {
+        maxSize?: number;
+        getNow?: () => number;
+    });
+    /**
+     * Cache an AnchorFrame.
+     *
+     * - ttl=0: frame is valid but not cached (NPS-1 §4.1)
+     * - Same anchor_id + same schema: idempotent (no-op)
+     * - Same anchor_id + different schema: NCP-ANCHOR-ID-MISMATCH (poison detection)
+     *
+     * @throws {NcpError} NCP-ANCHOR-ID-MISMATCH on anchor poisoning.
+     */
+    set(frame: AnchorFrame): void;
+    /**
+     * Get a cached AnchorFrame by anchor_id.
+     *
+     * @returns The cached frame, or null if not found or expired.
+     */
+    get(anchorId: string): AnchorFrame | null;
+    /**
+     * Get a cached AnchorFrame, throwing if not found.
+     * @throws {NcpError} NCP-ANCHOR-NOT-FOUND if not in cache or expired.
+     */
+    getRequired(anchorId: string): AnchorFrame;
+    /** Current cache size. */
+    get size(): number;
+    /** Evict the least recently accessed entry. */
+    private evictLru;
+}
+//# sourceMappingURL=anchor-cache.d.ts.map

package/dist/core/anchor-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-cache.d.ts","sourceRoot":"","sources":["../../src/core/anchor-cache.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjE;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAKjE;;;;;;;;OAQG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAiC7B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAczC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAW1C,0BAA0B;IAC1B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+CAA+C;IAC/C,OAAO,CAAC,QAAQ;CAejB"}