@nexart/codemode-sdk 1.8.1 → 1.8.3

package/CHANGELOG.md

@@ -4,6 +4,91 @@ All notable changes to @nexart/codemode-sdk will be documented in this file.
 
 ---
 
+## [1.8.3] — 2026-01-25
+
+### Changed — CLI v0.2 Remote Renderer + Version Bump
+
+**Non-Breaking Release**
+
+This release adds CLI v0.2 with remote canonical renderer support and ensures all version references are synchronized.
+
+#### CLI v0.2 Features
+- **Remote renderer support** — `nexart run` now calls canonical Node renderer by default
+- **`--renderer` flag** — Switch between `remote` (default) and `local` (placeholder)
+- **`--endpoint` flag** — Custom renderer endpoint URL
+- **`--include-code` flag** — Embed source code in snapshot for standalone verify/replay
+- **`NEXART_RENDERER_ENDPOINT`** — Environment variable for default endpoint
+- **Real PNG output** — When remote renderer available, produces actual rendered images
+
+#### Snapshot v1 Updates
+- `outputHash` = SHA-256 of PNG bytes (locked)
+- `runtimeHash` sourced from renderer response when using remote mode
+- Optional `code` field when `--include-code` is used
+
+#### Documentation Updates
+- Updated `docs/snapshot-v1.md` with runtimeHash sourcing and code embedding
+- CLI README now documents remote renderer as default
+- All version references updated from 1.8.2 to 1.8.3
+
+#### Package Updates
+- **SDK Version**: 1.8.3
+- **CLI Version**: 0.2.0
+
+### Unchanged
+
+- No changes to protocol semantics (v1.2.0)
+- No changes to runtime APIs
+- No changes to determinism guarantees
+- Full backward compatibility with v1.8.2
+
+---
+
+## [1.8.2] — 2026-01-24
+
+### Changed — AI Agent Adoption Friction Reduction
+
+**Non-Breaking, Documentation-Only Release**
+
+This release addresses external review feedback (Grok/Lovable/Replit) about AI agent adoption friction. No runtime, API, or behavior changes. Protocol remains v1.2.0.
+
+#### Agent Quickstart Example Added
+- **New `examples/agent-quickstart.ts`** — Copy-paste ready reference for AI agents
+  - Uses ONLY `createRuntime()` (modern, agent-first API)
+  - No canvas, no p5, browser-safe
+  - Demonstrates: seed → runtime → deterministic ops → digest → verification
+  - Shows strict mode enforcement and error handling
+
+#### Documentation Clarified — Entrypoint Selection
+- **"Which API should I use?"** section added to README
+  - Decision table: `createRuntime()` vs `executeCodeMode()`
+  - Clear guidance: `createRuntime()` = DEFAULT, `executeCodeMode()` = legacy/node-only
+- **"For AI coding agents"** section expanded with:
+  - Quick rules: always `createRuntime()`, never `Math.random()`, always `strict: true`
+  - Link to `examples/agent-quickstart.ts`
+  - Detailed strict mode explanation (why it exists, scoping, restoration)
+
+#### Version Consistency Pass
+- **New `version.ts`** — Single source of truth for SDK_VERSION, PROTOCOL_VERSION, PROTOCOL_PHASE
+- All programmatic exports (runtime.ts, core-index.ts, entry/browser.ts) now import from version.ts
+- Eliminates version drift between package.json, runtime exports, and documentation
+- All documentation updated to reference version 1.8.2
+- README, CHANGELOG, package.json all synchronized
+
+#### Package Updates
+- **Version**: 1.8.2
+- **New script**: `npm run example:agent` — Run agent quickstart example
+
+### Unchanged
+
+- No changes to runtime behavior
+- No changes to APIs or exports
+- No changes to protocol version (remains v1.2.0)
+- No changes to determinism guarantees
+- No changes to strict mode enforcement
+- Full backward compatibility with v1.8.1
+
+---
+
 ## [1.8.1] — 2026-01-24
 
 ### Changed — Documentation & Licensing Clarity
@@ -25,7 +110,7 @@ This release addresses external review feedback about documentation framing and
 - **COMMERCIAL.md added** — Plain language licensing terms
 - **Free for**: personal, experiments, research, open-source
 - **Commercial production**: requires license
-- **Contact**: licensing@nexart.xyz
+- **Contact**: contact@artnames.io
 - **No phase language, no future enforcement language**
 
 #### Package Updates

package/COMMERCIAL.md

@@ -1,41 +1,43 @@
-# Commercial Licensing
+# Commercial Use
 
 ## @nexart/codemode-sdk
 
 ---
 
-## Free Use
+## License: MIT (Free for All Use)
 
-You may use this SDK at no cost for:
+This SDK is released under the **MIT License**.
 
-- **Personal projects** — Learning, hobby work, portfolio pieces
-- **Experiments and prototypes** — Proof of concepts, demos, hackathons
-- **Research and education** — Academic work, teaching, scientific research
-- **Open-source projects** — Projects with source code publicly available under an OSI-approved license
-
----
-
-## Commercial Use
-
-Commercial production deployments require a license.
-
-**Commercial use includes:**
-- Products or services that generate revenue
-- Internal tools used in commercial operations
-- SaaS applications
-- Games or simulations sold or monetized
+You may use it for **any purpose**, including:
+- Personal projects
+- Commercial products
+- Revenue-generating applications
 - Enterprise deployments
+- NFT minting
+- SaaS applications
+
+**No license key required. No usage tracking. No restrictions.**
 
 ---
 
-## Get a License
+## How NexArt Monetizes
+
+NexArt follows a "monetize edges, not core" model:
 
-Contact: **licensing@artnames.io**
+| Component | Cost |
+|-----------|------|
+| SDK | Free (MIT) |
+| CLI | Free (MIT) |
+| Local run/replay/verify | Free |
+| **Hosted attestation** | Paid |
+| **Cloud retention** | Paid |
+| **SLA guarantees** | Paid |
+| **Compliance tooling** | Paid |
 
-We offer flexible licensing options for teams and enterprises.
+See [Core vs Edges](./docs/core-vs-edges.md) for the full breakdown.
 
 ---
 
 ## Questions?
 
-If you're unsure whether your use case requires a license, reach out to licensing@artnames.io. We're happy to help.
+Contact: **contact@artnames.io**

package/LICENSE.md

@@ -1,44 +1,9 @@
-NexArt Code Mode SDK — License
-
-Version: 1.6.0
-Status: DRAFT — Enforcement Not Active
-
-⸻
-
-License Status
-
-The NexArt Code Mode SDK is currently released under the MIT License.
-
-At this time, all usage — including commercial usage — is permitted under the MIT License.
-
-This document also serves as advance notice of a future commercial licensing model that may apply to certain uses of the NexArt Protocol.
-
-⸻
-
-Future Commercial Licensing (Not Active)
-
-NexArt intends to introduce a separate commercial license for specific categories of usage in a future release.
-
-Planned commercial usage categories may include (non-exhaustive):
-	•	Minting NFTs for sale
-	•	Revenue-generating applications
-	•	Products or services that charge fees
-	•	Enterprise or business deployments
-
-Enforcement is NOT active.
-
-No license keys, validation, usage tracking, or commercial restrictions are currently implemented.
-
-Until enforcement is introduced in a future version, all usage remains governed solely by the MIT License below.
-
-⸻
-
-MIT License
+# MIT License
 
 Copyright (c) 2024–2026 NexArt
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the “Software”), to deal
+of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
@@ -47,7 +12,7 @@ furnished to do so, subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
@@ -55,8 +20,12 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-⸻
+---
+
+## Summary
+
+This SDK is **MIT licensed** — free for all use, including commercial.
 
-Contact
+NexArt monetizes optional hosted services (attestation, verification, compliance), not the SDK.
 
-For future commercial licensing inquiries: arrotu@artnames.io
+See [Core vs Edges](./docs/core-vs-edges.md) for details.

package/README.md

@@ -1,11 +1,38 @@
 # @nexart/codemode-sdk
 
-**Version: 1.8.1 (Protocol v1.2.0)**
+**Version: 1.8.3 (Protocol v1.2.0)**
 
 A deterministic execution runtime for reproducible, verifiable computation.
 
 ---
 
+## Which API Should I Use?
+
+**Decision table for choosing the right entrypoint:**
+
+| Your Goal | Use This | Import Path |
+|-----------|----------|-------------|
+| Deterministic random/noise in any environment | **`createRuntime()`** ✅ DEFAULT | `@nexart/codemode-sdk` |
+| AI agent integration | **`createRuntime()`** ✅ DEFAULT | `@nexart/codemode-sdk` |
+| Browser/React/Vite app | **`createRuntime()`** ✅ DEFAULT | `@nexart/codemode-sdk` |
+| Server-side image rendering | `executeCodeMode()` | `@nexart/codemode-sdk/node` |
+| Full p5.js-style canvas execution | `executeCodeMode()` | `@nexart/codemode-sdk/node` |
+
+**`createRuntime()`** is the **default and recommended** API:
+- ✅ Works in browser and Node.js
+- ✅ No canvas dependency
+- ✅ Agent-first design
+- ✅ Strict mode enforcement
+- ✅ Lightweight
+
+**`executeCodeMode()`** is the **legacy / Node-only** API:
+- Requires Node.js with `canvas` package
+- Full p5.js-style execution environment
+- Returns rendered PNG/MP4
+- Use only when you need actual image/video output
+
+---
+
 ## What This SDK Does
 
 This SDK provides a **deterministic runtime layer** for executing code that must produce identical output given identical inputs — across environments, over time, and under verification.
@@ -42,7 +69,16 @@ For most applications, seeded randomness is unnecessary complexity.
 
 ## For AI Coding Agents (Replit / Lovable / Claude Code)
 
-**Use `createRuntime({ seed, strict: true })` for deterministic execution.**
+**Always start with `createRuntime()` — it is the default and recommended API.**
+
+### Quick Rules for AI Agents
+
+1. **Always use `createRuntime()`** — NOT `executeCodeMode()`
+2. **Never use `Math.random()` or `Date.now()`** — use `runtime.random()` instead
+3. **Always use `strict: true`** — unless you explicitly know why you aren't
+4. **See `examples/agent-quickstart.ts`** — copy-paste ready reference
+
+### Minimal Example
 
 ```typescript
 import { createRuntime } from "@nexart/codemode-sdk";
@@ -50,23 +86,47 @@ import { createRuntime } from "@nexart/codemode-sdk";
 const runtime = createRuntime({
   seed: "my-artwork-42",
   vars: [50, 75, 25],
-  strict: true,  // Throws on Math.random, Date.now, etc.
+  strict: true,  // ALWAYS use strict: true — throws on non-deterministic APIs
   mode: "static"
 });
 
-// Deterministic APIs
+// Deterministic APIs (use these, not Math.random!)
 const value = runtime.random();          // [0, 1)
 const intVal = runtime.randomInt(0, 10); // integer in range
-const n = runtime.noise(x, y);           // Perlin noise
+const n = runtime.noise(0.5, 0.5);       // Perlin noise
+
+// Execute with strict enforcement
+const result = runtime.run(() => {
+  // Your deterministic code here
+  return runtime.random() * 100;
+});
 
 // Verification
-console.log(runtime.digest());   // Stable hash
-console.log(runtime.getState()); // Canonical state snapshot
+console.log(runtime.digest());   // Stable hash for verification
+console.log(runtime.getState()); // Canonical state snapshot for replay
+```
+
+### Strict Mode Explained
+
+Strict mode protects determinism by intercepting non-deterministic APIs during `runtime.run()`:
+
+```typescript
+runtime.run(() => {
+  Math.random();  // Throws: NEXART_STRICT: Non-deterministic API used: Math.random. Use runtime.random() instead.
+  Date.now();     // Throws: NEXART_STRICT: Non-deterministic API used: Date.now. Pass time as an input or use deterministic counters.
+});
 ```
 
-**Strict mode throws actionable errors:**
-- `NEXART_STRICT: Non-deterministic API used: Math.random. Use runtime.random() instead.`
-- `NEXART_STRICT: Non-deterministic API used: Date.now. Pass time as an input or use deterministic counters.`
+**Why strict mode exists:**
+- Determinism is the core guarantee — same inputs must always produce same outputs
+- AI agents often default to `Math.random()` before reading documentation
+- Strict mode catches these mistakes immediately with actionable error messages
+- Interception is **scoped to `runtime.run()`** — it does NOT globally mutate your application
+- Globals are restored after execution
+
+**When to use `strict: false`:**
+- Almost never. Only if you're intentionally mixing deterministic and non-deterministic code.
+- If you're not sure, use `strict: true`.
 
 ---
 
@@ -176,7 +236,7 @@ These are examples — the SDK is designed for any system requiring deterministi
 |----------|-------|
 | Protocol Version | v1.2.0 |
 | Status | **STABLE** |
-| SDK Version | 1.8.1 |
+| SDK Version | 1.8.3 |
 
 **Core protocol surface is frozen. Breaking changes require v2.0.0.**
 
@@ -377,6 +437,7 @@ The following are rejected with `[Code Mode Protocol Error]`:
 ## Examples
 
 ```bash
+npm run example:agent   # Agent quickstart (RECOMMENDED for AI agents)
 npm run example:basic   # Basic usage
 npm run example:verify  # Determinism verification
 ```
@@ -389,6 +450,16 @@ See [CHANGELOG.md](./CHANGELOG.md) for version history.
 
 ---
 
+## License
+
+**MIT License** — Free for all use, including commercial.
+
+NexArt monetizes optional hosted services (attestation, verification, compliance), not the SDK.
+
+See [Core vs Edges](./docs/core-vs-edges.md) for details on what's free vs paid.
+
+---
+
 ## About
 
 This SDK is a reference implementation of a deterministic execution protocol designed for replay, verification, and long-term stability.

package/dist/sdk/codemode/core-index.d.ts

@@ -1,12 +1,13 @@
 /**
- * @nexart/codemode-sdk v1.4.0 — Core Exports
+ * @nexart/codemode-sdk — Core Exports
+ * See version.ts for SDK version (single source of truth)
  *
  * Canonical execution engine for NexArt Code Mode.
  * This is the single source of truth for Code Mode semantics.
  *
- * Protocol: v1.2.0 (Phase 3)
  * Enforcement: HARD
  */
+import { PROTOCOL_VERSION, PROTOCOL_PHASE } from './version';
 export { executeCodeMode, validateCodeModeSource, } from './execute';
 export { type RenderMode, type TimeVariables, type ProtocolMetadata, type EngineConfig, type RenderResult, type RunOptions, type ProgressInfo, type Engine, type ExecuteCodeModeInput, type ExecuteCodeModeResult, PROTOCOL_IDENTITY, DEFAULT_VARS, DEFAULT_CONFIG, } from './types';
 export { createP5Runtime, injectTimeVariables, createProtocolVAR, VAR_COUNT, VAR_MIN, VAR_MAX, CODE_MODE_PROTOCOL_VERSION, CODE_MODE_PROTOCOL_PHASE, CODE_MODE_ENFORCEMENT, type P5Runtime, type P5RuntimeConfig, } from './p5-runtime';
@@ -14,8 +15,9 @@ export { runStaticMode, } from './static-engine';
 export { runLoopMode, cancelLoopMode, } from './loop-engine';
 export { createEngine, } from './engine';
 /**
- * SDK Identity
+ * SDK Identity — imported from version.ts (single source of truth)
  */
-export declare const SDK_VERSION = "1.1.1";
+export declare const SDK_VERSION = "1.8.3";
 export declare const SDK_NAME = "@nexart/codemode-sdk";
+export { PROTOCOL_VERSION, PROTOCOL_PHASE };
 //# sourceMappingURL=core-index.d.ts.map

package/dist/sdk/codemode/core-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-index.d.ts","sourceRoot":"","sources":["../../../core-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,GACb,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,QAAQ,yBAAyB,CAAC"}
+{"version":3,"file":"core-index.d.ts","sourceRoot":"","sources":["../../../core-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA+B,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG1F,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,GACb,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,WAAW,UAAe,CAAC;AACxC,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC"}

package/dist/sdk/codemode/core-index.js

@@ -1,12 +1,13 @@
 /**
- * @nexart/codemode-sdk v1.4.0 — Core Exports
+ * @nexart/codemode-sdk — Core Exports
+ * See version.ts for SDK version (single source of truth)
  *
  * Canonical execution engine for NexArt Code Mode.
  * This is the single source of truth for Code Mode semantics.
  *
- * Protocol: v1.2.0 (Phase 3)
  * Enforcement: HARD
  */
+import { SDK_VERSION as _SDK_VERSION, PROTOCOL_VERSION, PROTOCOL_PHASE } from './version';
 // Core execution
 export { executeCodeMode, validateCodeModeSource, } from './execute';
 // Protocol types
@@ -20,7 +21,8 @@ export { runLoopMode, cancelLoopMode, } from './loop-engine';
 // Engine utilities
 export { createEngine, } from './engine';
 /**
- * SDK Identity
+ * SDK Identity — imported from version.ts (single source of truth)
  */
-export const SDK_VERSION = '1.1.1';
+export const SDK_VERSION = _SDK_VERSION;
 export const SDK_NAME = '@nexart/codemode-sdk';
+export { PROTOCOL_VERSION, PROTOCOL_PHASE };

package/dist/{entry → sdk/codemode/entry}/browser.d.ts

@@ -1,8 +1,9 @@
 /**
  * @nexart/codemode-sdk/browser — Browser-Safe Entry Point
+ * See ../version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  BROWSER-SAFE SDK ENTRY POINT (v1.8.0)                                   ║
+ * ║  BROWSER-SAFE SDK ENTRY POINT                                            ║
  * ║                                                                          ║
  * ║  This entrypoint exports ONLY browser-safe modules.                      ║
  * ║  It does NOT include static-engine or any Node.js dependencies.          ║
@@ -25,7 +26,9 @@ export { createEngine, } from '../engine';
 export { registerBuilderManifest, } from '../builder-manifest';
 export { createRuntime, NexArtRuntime, RUNTIME_VERSION, } from '../runtime';
 export type { RuntimeOptions, RuntimeState, NexArtRuntime as NexArtRuntimeType, } from '../runtime';
-export declare const SDK_VERSION = "1.8.0";
+export { renderSoundArtViaCodeMode, canRenderViaCodeMode, getCodeModeAvailableStyles, } from '../soundart-engine';
+export type { TweakParams, SoundArtEngineConfig, SoundArtRenderOptions, SoundArtRenderResult, SoundArtMetadata, SoundSnapshot, SoundFeatures, SoundArtSketchName, } from '../soundart-engine';
+export declare const SDK_VERSION = "1.8.3";
 export declare const SDK_NAME = "@nexart/codemode-sdk";
 export declare const SDK_ENTRY = "browser";
 /**

package/dist/sdk/codemode/entry/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../entry/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,YAAY,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,SAAS,EACT,eAAe,GAChB,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,YAAY,GACb,MAAM,WAAW,CAAC;AAKnB,OAAO,EACL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,IAAI,iBAAiB,GACnC,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAK5B,eAAO,MAAM,WAAW,UAAe,CAAC;AACxC,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAC/C,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC;;;;;;;;;;;GAWG"}

package/dist/{entry → sdk/codemode/entry}/browser.js

@@ -1,8 +1,9 @@
 /**
  * @nexart/codemode-sdk/browser — Browser-Safe Entry Point
+ * See ../version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  BROWSER-SAFE SDK ENTRY POINT (v1.8.0)                                   ║
+ * ║  BROWSER-SAFE SDK ENTRY POINT                                            ║
  * ║                                                                          ║
  * ║  This entrypoint exports ONLY browser-safe modules.                      ║
  * ║  It does NOT include static-engine or any Node.js dependencies.          ║
@@ -14,6 +15,7 @@
  * ║  AI AGENTS: Start with createRuntime({ seed, strict: true })             ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
  */
+import { SDK_VERSION as _SDK_VERSION } from '../version';
 export { PROTOCOL_IDENTITY, DEFAULT_VARS, DEFAULT_CONFIG, } from '../types';
 // ═══════════════════════════════════════════════════════════════════════════
 // EXECUTION SANDBOX — Browser-safe (no Node dependencies)
@@ -40,13 +42,17 @@ export { createEngine, } from '../engine';
 // ═══════════════════════════════════════════════════════════════════════════
 export { registerBuilderManifest, } from '../builder-manifest';
 // ═══════════════════════════════════════════════════════════════════════════
-// AGENT-FIRST RUNTIME — v1.8.0 (Browser-safe, no Node dependencies)
+// AGENT-FIRST RUNTIME — Browser-safe, no Node dependencies
 // ═══════════════════════════════════════════════════════════════════════════
 export { createRuntime, NexArtRuntime, RUNTIME_VERSION, } from '../runtime';
 // ═══════════════════════════════════════════════════════════════════════════
-// SDK IDENTITY
+// SOUNDART ENGINE — Browser-safe (canvas-based rendering)
 // ═══════════════════════════════════════════════════════════════════════════
-export const SDK_VERSION = '1.8.0';
+export { renderSoundArtViaCodeMode, canRenderViaCodeMode, getCodeModeAvailableStyles, } from '../soundart-engine';
+// ═══════════════════════════════════════════════════════════════════════════
+// SDK IDENTITY — imported from version.ts (single source of truth)
+// ═══════════════════════════════════════════════════════════════════════════
+export const SDK_VERSION = _SDK_VERSION;
 export const SDK_NAME = '@nexart/codemode-sdk';
 export const SDK_ENTRY = 'browser';
 /**

package/dist/{entry → sdk/codemode/entry}/node.d.ts

@@ -1,8 +1,9 @@
 /**
  * @nexart/codemode-sdk/node — Node.js Entry Point
+ * See ../version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  NODE.JS SDK ENTRY POINT (v1.8.0)                                        ║
+ * ║  NODE.JS SDK ENTRY POINT                                                 ║
  * ║                                                                          ║
  * ║  This entrypoint exports Node.js-specific modules that require:          ║
  * ║  - canvas package (node-canvas)                                          ║

package/dist/sdk/codemode/entry/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../entry/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,cAAc,WAAW,CAAC;AAK1B,OAAO,EACL,aAAa,GACd,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,eAAe,GAChB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,eAAO,MAAM,SAAS,SAAS,CAAC"}

package/dist/{entry → sdk/codemode/entry}/node.js

@@ -1,8 +1,9 @@
 /**
  * @nexart/codemode-sdk/node — Node.js Entry Point
+ * See ../version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  NODE.JS SDK ENTRY POINT (v1.8.0)                                        ║
+ * ║  NODE.JS SDK ENTRY POINT                                                 ║
  * ║                                                                          ║
  * ║  This entrypoint exports Node.js-specific modules that require:          ║
  * ║  - canvas package (node-canvas)                                          ║

package/dist/sdk/codemode/p5-runtime.d.ts

@@ -1,8 +1,9 @@
 /**
  * NexArt Code Mode Runtime SDK - p5-like Runtime
+ * See version.ts for SDK/Protocol version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  CODE MODE PROTOCOL v1.2.0 (Phase 3) — STABLE                             ║
+ * ║  CODE MODE PROTOCOL — STABLE (see version.ts for version)                 ║
  * ║                                                                          ║
  * ║  Status: HARD PROTOCOL ENFORCEMENT                                       ║
  * ║  This is the stable, canonical execution surface.                        ║
@@ -30,7 +31,7 @@
 import type { TimeVariables } from './types';
 /**
  * Code Mode Protocol Version
- * This constant defines the locked protocol version.
+ * Imports from version.ts (single source of truth).
  * Changes to the execution surface require a version bump.
  */
 export declare const CODE_MODE_PROTOCOL_VERSION = "1.2.0";

package/dist/sdk/codemode/p5-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"p5-runtime.d.ts","sourceRoot":"","sources":["../../../p5-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAEvC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,eAAe,GACvB,SAAS,CAs8BX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAmCpE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"p5-runtime.d.ts","sourceRoot":"","sources":["../../../p5-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAAmB,CAAC;AAC3D,eAAO,MAAM,wBAAwB,IAAiB,CAAC;AACvD,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAEvC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,eAAe,GACvB,SAAS,CAs8BX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAmCpE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE3E"}

package/dist/sdk/codemode/p5-runtime.js

@@ -1,8 +1,9 @@
 /**
  * NexArt Code Mode Runtime SDK - p5-like Runtime
+ * See version.ts for SDK/Protocol version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  CODE MODE PROTOCOL v1.2.0 (Phase 3) — STABLE                             ║
+ * ║  CODE MODE PROTOCOL — STABLE (see version.ts for version)                 ║
  * ║                                                                          ║
  * ║  Status: HARD PROTOCOL ENFORCEMENT                                       ║
  * ║  This is the stable, canonical execution surface.                        ║
@@ -27,13 +28,14 @@
  * ║  ⚠️  Future changes require Phase 2+                                     ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
  */
+import { PROTOCOL_VERSION, PROTOCOL_PHASE } from './version';
 /**
  * Code Mode Protocol Version
- * This constant defines the locked protocol version.
+ * Imports from version.ts (single source of truth).
  * Changes to the execution surface require a version bump.
  */
-export const CODE_MODE_PROTOCOL_VERSION = '1.2.0';
-export const CODE_MODE_PROTOCOL_PHASE = 3;
+export const CODE_MODE_PROTOCOL_VERSION = PROTOCOL_VERSION;
+export const CODE_MODE_PROTOCOL_PHASE = PROTOCOL_PHASE;
 export const CODE_MODE_ENFORCEMENT = 'HARD';
 /**
  * Create a seeded random number generator (Mulberry32)

package/dist/{runtime.d.ts → sdk/codemode/runtime.d.ts}

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode SDK - Agent-First Runtime Authority Layer
- * Version: 1.8.0 (Protocol v1.2.0)
+ * See version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
  * ║  AGENT-FIRST RUNTIME — DETERMINISTIC EXECUTION AUTHORITY                 ║
@@ -18,7 +18,7 @@
  * ║  BROWSER-SAFE: No Node.js dependencies. Works in Vite/Next/React.        ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
  */
-export declare const RUNTIME_VERSION = "1.8.0";
+export declare const RUNTIME_VERSION = "1.8.3";
 export interface RuntimeOptions {
     seed: string | number;
     vars?: number[];

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,eAAO,MAAM,eAAe,UAAc,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI,MAAM,CAAC;IACjB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,IAAI,YAAY,CAAC;IACzB,OAAO,IAAI,MAAM,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAqGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAuHpE;AAED,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}

package/dist/{runtime.js → sdk/codemode/runtime.js}

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode SDK - Agent-First Runtime Authority Layer
- * Version: 1.8.0 (Protocol v1.2.0)
+ * See version.ts for SDK version (single source of truth)
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
  * ║  AGENT-FIRST RUNTIME — DETERMINISTIC EXECUTION AUTHORITY                 ║
@@ -18,7 +18,8 @@
  * ║  BROWSER-SAFE: No Node.js dependencies. Works in Vite/Next/React.        ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
  */
-export const RUNTIME_VERSION = '1.8.0';
+import { SDK_VERSION } from './version';
+export const RUNTIME_VERSION = SDK_VERSION;
 function hashSeed(seed) {
     if (typeof seed === 'number') {
         return Math.floor(seed) >>> 0;