@nexart/codemode-sdk 1.8.4 → 1.10.0

package/dist/types/sdk/codemode/types.d.ts

@@ -149,6 +149,102 @@ export interface ExecuteCodeModeResult {
     frames?: ImageData[];
     metadata: ProtocolMetadata;
 }
+/**
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Verification Reason Codes (v1.9.0)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Stable, string-valued reason codes returned by all Code Mode verification
+ * functions.  Additive-only: existing codes will never be renamed or removed.
+ */
+export declare const CodeVerifyCode: {
+    readonly OK: "OK";
+    readonly CERTIFICATE_HASH_MISMATCH: "CERTIFICATE_HASH_MISMATCH";
+    readonly SNAPSHOT_HASH_MISMATCH: "SNAPSHOT_HASH_MISMATCH";
+    readonly RENDER_HASH_MISMATCH: "RENDER_HASH_MISMATCH";
+    readonly INVALID_SHA256_FORMAT: "INVALID_SHA256_FORMAT";
+    readonly CANONICALIZATION_ERROR: "CANONICALIZATION_ERROR";
+    readonly SCHEMA_ERROR: "SCHEMA_ERROR";
+    readonly NODE_RECEIPT_MISSING: "NODE_RECEIPT_MISSING";
+    readonly NODE_RECEIPT_KEY_NOT_FOUND: "NODE_RECEIPT_KEY_NOT_FOUND";
+    readonly NODE_RECEIPT_INVALID_SIGNATURE: "NODE_RECEIPT_INVALID_SIGNATURE";
+    readonly NODE_RECEIPT_KEY_FORMAT_UNSUPPORTED: "NODE_RECEIPT_KEY_FORMAT_UNSUPPORTED";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type CodeVerifyCode = typeof CodeVerifyCode[keyof typeof CodeVerifyCode];
+/**
+ * Verification result returned by Code Mode verification functions.
+ * `ok`      — true on success
+ * `code`    — stable machine-readable reason code (CodeVerifyCode)
+ * `details` — optional human-readable detail lines
+ */
+export interface CodeVerificationResult {
+    ok: boolean;
+    code: CodeVerifyCode;
+    details?: string[];
+}
+/**
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Signed Attestation Receipt — Code Mode (v1.9.0)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Payload signed by the attestation node over a Code Mode snapshot bundle.
+ * The signature is Ed25519 over the canonical JSON bytes of this object.
+ */
+export interface SignedAttestationReceipt {
+    receiptVersion: 'attestation.receipt.v1';
+    attestationId: string;
+    attestedAt: string;
+    nodeId: string;
+    attestorKeyId: string;
+    nodeRuntimeHash: string;
+    certificateHash: string;
+    protocolVersion: string;
+    [key: string]: unknown;
+}
+/**
+ * Node Keys Document
+ * Fetched from /.well-known/nexart-node.json on the attestation node.
+ */
+export interface NodeKeysDocument {
+    nodeId: string;
+    activeKid?: string;
+    keys: Array<{
+        kid: string;
+        alg: 'Ed25519';
+        use: 'sig';
+        publicKeyJwk?: {
+            kty: 'OKP';
+            crv: 'Ed25519';
+            x: string;
+        };
+        publicKey?: string;
+        publicKeySpkiB64?: string;
+        createdAt?: string;
+    }>;
+}
+/**
+ * Result of node receipt signature verification (Code Mode variant).
+ * Alias of CodeVerificationResult — kept as a distinct named type for
+ * clarity in function signatures.
+ */
+export type NodeReceiptVerifyResult = CodeVerificationResult;
+/**
+ * Normalised attestation receipt extracted from any Code Mode bundle format.
+ * Returned by getAttestationReceipt().
+ */
+export interface CodeAttestationReceipt {
+    attestationId: string;
+    attestedAt: string;
+    nodeId?: string;
+    attestorKeyId?: string;
+    nodeRuntimeHash?: string;
+    certificateHash?: string;
+    protocolVersion?: string;
+    receipt?: SignedAttestationReceipt;
+    signature?: string;
+    [key: string]: unknown;
+}
 /**
  * Builder Manifest (v1.6.0)
  *

package/dist/types/sdk/codemode/types.d.ts.map

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

package/dist/types/sdk/codemode/verifyDetailed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * verifyCodeModeSnapshotDetailed — protocol-aligned Code Mode snapshot verifier
+ *
+ * Returns a CerVerificationResult conforming to the CER Protocol spec.
+ *
+ * bundleIntegrity   — PASS if snapshot structure is valid AND (when outputHash
+ *                     is provided) the output hash matches the snapshot value.
+ * nodeSignature     — always SKIPPED (Code Mode snapshots carry no node signature)
+ * receiptConsistency — always SKIPPED (same reason)
+ */
+import { type CerVerificationResult } from './cerProtocol';
+export interface VerifyCodeModeOptions {
+    /** Actual output hash (sha256:...) to compare against snapshot.outputHash. */
+    outputHash?: string;
+    /** Actual code hash to compare against snapshot.codeHash. */
+    codeHash?: string;
+}
+/**
+ * Verify a Code Mode snapshot and return a structured CerVerificationResult.
+ *
+ * @param snapshot - The NexArtSnapshotV1 object to verify
+ * @param options  - Optional actual hashes to compare against the snapshot
+ */
+export declare function verifyCodeModeSnapshotDetailed(snapshot: unknown, options?: VerifyCodeModeOptions): CerVerificationResult;
+//# sourceMappingURL=verifyDetailed.d.ts.map

package/dist/types/sdk/codemode/verifyDetailed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyDetailed.d.ts","sourceRoot":"","sources":["../../../../verifyDetailed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAA6B,KAAK,qBAAqB,EAAqC,MAAM,eAAe,CAAC;AAEzH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6BD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,qBAA0B,GAClC,qBAAqB,CAuCvB"}

package/dist/types/sdk/codemode/version.d.ts

@@ -8,11 +8,11 @@
  * See package.json for the canonical npm version.
  */
 /** SDK version - must match package.json version */
-export declare const SDK_VERSION = "1.8.4";
+export declare const SDK_VERSION = "1.10.0";
 /** Protocol version - defines runtime semantics and determinism guarantees */
 export declare const PROTOCOL_VERSION = "1.2.0";
 /** Protocol phase - phase 3 = stable, production-ready */
 export declare const PROTOCOL_PHASE = 3;
 /** Combined version string for display */
-export declare const VERSION_STRING = "v1.8.4 (Protocol v1.2.0)";
+export declare const VERSION_STRING = "v1.10.0 (Protocol v1.2.0)";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/sdk/codemode/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,6BAAoD,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,8BAAoD,CAAC"}

package/examples/sketch-minimal.js

@@ -0,0 +1,27 @@
+/**
+ * Minimal NexArt Code Mode Sketch
+ * 
+ * A simple sketch demonstrating basic canvas operations.
+ * No randomness - produces identical output every run.
+ * 
+ * Canonical size: 1950x2400 (enforced by canonical renderer)
+ */
+
+createCanvas(1950, 2400);
+background(20, 20, 30);
+
+noStroke();
+
+fill(255, 100, 100);
+ellipse(width / 2, height / 3, 600, 600);
+
+fill(100, 255, 100);
+ellipse(width / 3, height * 2 / 3, 400, 400);
+
+fill(100, 100, 255);
+ellipse(width * 2 / 3, height * 2 / 3, 400, 400);
+
+stroke(255);
+strokeWeight(4);
+noFill();
+rect(100, 100, width - 200, height - 200, 50);

package/examples/sketch-vars.js

@@ -0,0 +1,59 @@
+/**
+ * VAR + Random Sketch - Demonstrates Determinism
+ * 
+ * This sketch uses VAR parameters and random() to show that
+ * NexArt Code Mode produces identical output for the same seed.
+ * 
+ * VAR[0]: Number of circles (0-100 maps to 10-50)
+ * VAR[1]: Circle size multiplier (0-100 maps to 0.5-2.0)
+ * VAR[2]: Color hue shift (0-100 maps to 0-360)
+ * 
+ * Canonical size: 1950x2400 (enforced by canonical renderer)
+ * 
+ * Usage:
+ *   nexart run sketch-vars.js --seed 12345 --vars 50,75,25
+ */
+
+createCanvas(1950, 2400);
+background(10, 10, 20);
+
+const numCircles = Math.floor(map(VAR[0], 0, 100, 10, 50));
+const sizeMultiplier = map(VAR[1], 0, 100, 0.5, 2.0);
+const hueShift = map(VAR[2], 0, 100, 0, 360);
+
+colorMode(HSB, 360, 100, 100, 100);
+
+noStroke();
+
+for (let i = 0; i < numCircles; i++) {
+  const x = random(100, width - 100);
+  const y = random(100, height - 100);
+  const baseSize = random(50, 200) * sizeMultiplier;
+  const hue = (random(360) + hueShift) % 360;
+  const sat = random(60, 100);
+  const bright = random(70, 100);
+  const alpha = random(40, 80);
+  
+  fill(hue, sat, bright, alpha);
+  ellipse(x, y, baseSize, baseSize);
+}
+
+stroke(0, 0, 100, 50);
+strokeWeight(2);
+noFill();
+
+for (let i = 0; i < 20; i++) {
+  const x1 = random(width);
+  const y1 = random(height);
+  const x2 = random(width);
+  const y2 = random(height);
+  line(x1, y1, x2, y2);
+}
+
+colorMode(RGB, 255);
+fill(255);
+noStroke();
+textSize(48);
+textAlign(CENTER, TOP);
+text(`Seed: ${SEED}`, width / 2, 50);
+text(`VAR: [${VAR[0]}, ${VAR[1]}, ${VAR[2]}]`, width / 2, 120);

package/examples/sketch.js

@@ -0,0 +1,24 @@
+function setup() {
+  const brightness = map(VAR[0], 0, 100, 20, 245);
+  background(brightness);
+
+  const diameter = map(VAR[1], 0, 100, 200, 1400);
+
+  // Deterministic palette choice (no random dependency)
+  const paletteIndex = floor(map(VAR[2], 0, 100, 0, 2.9999));
+
+  const palettes = [
+    { main: [255, 100, 120], accent: [100, 200, 255] },
+    { main: [100, 220, 180], accent: [255, 180, 100] },
+    { main: [180, 120, 255], accent: [255, 220, 100] }
+  ];
+  const palette = palettes[paletteIndex];
+
+  noStroke();
+
+  fill(palette.main[0], palette.main[1], palette.main[2]);
+  ellipse(width / 2, height / 2, diameter, diameter);
+
+  fill(palette.accent[0], palette.accent[1], palette.accent[2]);
+  ellipse(width / 2, height / 2, diameter * 0.4, diameter * 0.4);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexart/codemode-sdk",
-  "version": "1.8.4",
+  "version": "1.10.0",
   "description": "NexArt Code Mode SDK - Deterministic, reproducible, verifiable generative art runtime. Agent-first design for AI coding assistants.",
   "type": "module",
   "main": "./dist/cjs/browser.cjs",
@@ -43,7 +43,8 @@
     "build:types": "tsc -p tsconfig.types.json",
     "build:esm": "tsup --config tsup.config.ts --format esm",
     "build:cjs": "tsup --config tsup.config.ts --format cjs",
-    "test": "npx tsx smoke-test.ts",
+    "test": "npx tsx smoke-test.ts && npx tsx tests/attestation.test.ts",
+    "test:attestation": "npx tsx tests/attestation.test.ts",
     "test:node": "node scripts/smoke-node.mjs && node scripts/smoke-node.cjs",
     "example:basic": "npx tsx examples/basic.ts",
     "example:verify": "npx tsx examples/verify.ts",
@@ -82,7 +83,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@noble/ed25519": "^3.0.0",
+    "@noble/hashes": "^1.7.0"
+  },
   "devDependencies": {
+    "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   }