@seanhogg/builderforce-memory-engine 2026.6.20 → 2026.6.27

package/dist/index.d.ts

@@ -27,6 +27,9 @@ export { ACTIVATIONS_WGSL, ACTIVATIONS_BACKWARD_WGSL, SOFTMAX_FORWARD_WGSL, SOFT
 export { SSD_FORWARD_WGSL, SSD_BACKWARD_WGSL } from './kernels/ssd.js';
 export { COMPLEX_SSD_FORWARD_WGSL, COMPLEX_SSD_BACKWARD_WGSL } from './kernels/complex_ssd.js';
 export { ATTENTION_FORWARD_WGSL, ATTENTION_BACKWARD_WGSL, SOFTMAX_WGSL } from './kernels/attention.js';
+export { REGION, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, clampDim, clampState, neutralState, stateToRecord, recordToState, LimbicModel, DEFAULT_LIMBIC_CONFIG, DEFAULT_LIMBIC_SEED, LimbicTrainer, } from './limbic/index.js';
+export type { Region, LimbicDimName, LimbicModelConfig, LimbicForward, LimbicParam, LimbicSample, LimbicTrainOptions, } from './limbic/index.js';
+export { LIMBIC_AFFECT_WGSL } from './kernels/limbic_affect.js';
 export declare const VERSION = "2.0.0";
 export declare const DESCRIPTION = "MambaCode.js: WebGPU-accelerated Mamba-1/2/3 and Hybrid SSM for browser code models";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI9E,YAAY,EACR,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,SAAS,GACZ,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/H,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAO,yBAAyB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIvF,OAAO,EACH,UAAU,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,IAAI,GACP,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACH,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACjB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAC3D,6BAA6B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,qBAAqB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,gCAAgC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MACpC,4BAA4B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAC1F,0BAA0B,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MACrC,kBAAkB,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MACrD,0BAA0B,CAAC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAC/D,wBAAwB,CAAC;AAIlC,eAAO,MAAM,OAAO,UAAc,CAAC;AACnC,eAAO,MAAM,WAAW,wFAAwF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -34,6 +34,9 @@ export { SSD_FORWARD_WGSL, SSD_BACKWARD_WGSL } from './kernels/ssd.js';
 export { COMPLEX_SSD_FORWARD_WGSL, COMPLEX_SSD_BACKWARD_WGSL } from './kernels/complex_ssd.js';
 // Attention kernels
 export { ATTENTION_FORWARD_WGSL, ATTENTION_BACKWARD_WGSL, SOFTMAX_WGSL } from './kernels/attention.js';
+// ── Limbic system (trainable affective dynamics) ──────────────────────────────
+export { REGION, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, clampDim, clampState, neutralState, stateToRecord, recordToState, LimbicModel, DEFAULT_LIMBIC_CONFIG, DEFAULT_LIMBIC_SEED, LimbicTrainer, } from './limbic/index.js';
+export { LIMBIC_AFFECT_WGSL } from './kernels/limbic_affect.js';
 // ── Version ───────────────────────────────────────────────────────────────────
 export const VERSION = '2.0.0';
 export const DESCRIPTION = 'MambaCode.js: WebGPU-accelerated Mamba-1/2/3 and Hybrid SSM for browser code models';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iFAAiF;AAEjF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,iFAAiF;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,iFAAiF;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iFAAiF;AAEjF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkB9E,iFAAiF;AAEjF,OAAO,EACH,UAAU,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,IAAI,GACP,MAAM,sBAAsB,CAAC;AAE9B,iFAAiF;AAEjF,OAAO,EACH,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACjB,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AAEjF,8BAA8B;AAC9B,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAC3D,6BAA6B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,qBAAqB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,gCAAgC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MACpC,4BAA4B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAC1F,0BAA0B,CAAC;AAEpC,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MACrC,kBAAkB,CAAC;AAE5B,8BAA8B;AAC9B,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MACrD,0BAA0B,CAAC;AAEpC,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAC/D,wBAAwB,CAAC;AAElC,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAO,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,qFAAqF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iFAAiF;AAEjF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAQ,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,iFAAiF;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,iFAAiF;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iFAAiF;AAEjF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkB9E,iFAAiF;AAEjF,OAAO,EACH,UAAU,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,IAAI,GACP,MAAM,sBAAsB,CAAC;AAE9B,iFAAiF;AAEjF,OAAO,EACH,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACjB,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AAEjF,8BAA8B;AAC9B,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAC3D,6BAA6B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,qBAAqB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAC3C,gCAAgC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MACpC,4BAA4B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAC1F,0BAA0B,CAAC;AAEpC,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MACrC,kBAAkB,CAAC;AAE5B,8BAA8B;AAC9B,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MACrD,0BAA0B,CAAC;AAEpC,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAC/D,wBAAwB,CAAC;AAElC,iFAAiF;AAEjF,OAAO,EACH,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,GAChB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAO,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,qFAAqF,CAAC"}

package/dist/kernels/limbic_affect.d.ts

@@ -0,0 +1,2 @@
+export declare const LIMBIC_AFFECT_WGSL: string;
+//# sourceMappingURL=limbic_affect.d.ts.map

package/dist/kernels/limbic_affect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limbic_affect.d.ts","sourceRoot":"","sources":["../../src/kernels/limbic_affect.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,kBAAkB,EAAE,MAwDhC,CAAC"}

package/dist/kernels/limbic_affect.js

@@ -0,0 +1,74 @@
+// Limbic Affect WGSL Kernel
+//
+// One forward step of the limbic model's recurrent affect core, run on the GPU.
+// Given the previous hidden state, previous affective state, and an experience
+// embedding, it produces the next hidden state and a bounded affect *delta*.
+//
+// This mirrors the CPU reference in limbic/limbic_model.ts exactly (same math):
+//   pre[j]  = Σ_i Win[j,i]·x[i] + Σ_k Ws[j,k]·s[k]
+//   a[j]    = sigmoid(A[j])                       // per-channel recurrence gate
+//   h'[j]   = a[j]·h[j] + (1-a[j])·tanh(pre[j])   // SSM-style leak/input
+//   Δ[k]    = tanh( Σ_j Wout[k,j]·h'[j] + b[k] )  // bounded affect change
+//
+// hidden_dim is assumed ≤ 64 (the limbic head is tiny — the heavy lifting is in
+// the hippocampus SSM that produces the experience embedding). Reward is NOT
+// computed here: it is only needed during training, which runs the CPU backward
+// path; the per-turn inference step only needs Δ and the next hidden state.
+export const LIMBIC_AFFECT_WGSL = /* wgsl */ `
+
+struct Dims {
+    input_dim  : u32,
+    hidden_dim : u32,
+    state_dim  : u32,
+    _pad       : u32,
+};
+
+@group(0) @binding(0)  var<uniform>             dims        : Dims;
+@group(0) @binding(1)  var<storage, read>       win         : array<f32>;  // hidden*input
+@group(0) @binding(2)  var<storage, read>       ws          : array<f32>;  // hidden*state
+@group(0) @binding(3)  var<storage, read>       a_logit     : array<f32>;  // hidden
+@group(0) @binding(4)  var<storage, read>       wout_state  : array<f32>;  // state*hidden
+@group(0) @binding(5)  var<storage, read>       bout_state  : array<f32>;  // state
+@group(0) @binding(6)  var<storage, read>       x_in        : array<f32>;  // input
+@group(0) @binding(7)  var<storage, read>       h_prev      : array<f32>;  // hidden
+@group(0) @binding(8)  var<storage, read>       s_prev      : array<f32>;  // state
+@group(0) @binding(9)  var<storage, read_write> h_out       : array<f32>;  // hidden
+@group(0) @binding(10) var<storage, read_write> delta_out   : array<f32>;  // state
+
+var<workgroup> hbuf : array<f32, 64>;
+
+// Single-workgroup dispatch: (1, 1, 1) with workgroup_size 64.
+@compute @workgroup_size(64, 1, 1)
+fn affect_step(
+    @builtin(local_invocation_id) lid : vec3<u32>,
+) {
+    let j = lid.x;
+
+    // Pass 1: recurrent hidden update (one thread per hidden channel).
+    if (j < dims.hidden_dim) {
+        var pre : f32 = 0.0;
+        for (var i : u32 = 0u; i < dims.input_dim; i = i + 1u) {
+            pre = pre + win[j * dims.input_dim + i] * x_in[i];
+        }
+        for (var k : u32 = 0u; k < dims.state_dim; k = k + 1u) {
+            pre = pre + ws[j * dims.state_dim + k] * s_prev[k];
+        }
+        let a  = 1.0 / (1.0 + exp(-a_logit[j]));
+        let hn = a * h_prev[j] + (1.0 - a) * tanh(pre);
+        hbuf[j]  = hn;
+        h_out[j] = hn;
+    }
+
+    workgroupBarrier();
+
+    // Pass 2: bounded affect delta (one thread per state dim).
+    if (j < dims.state_dim) {
+        var acc : f32 = bout_state[j];
+        for (var m : u32 = 0u; m < dims.hidden_dim; m = m + 1u) {
+            acc = acc + wout_state[j * dims.hidden_dim + m] * hbuf[m];
+        }
+        delta_out[j] = tanh(acc);
+    }
+}
+`;
+//# sourceMappingURL=limbic_affect.js.map

package/dist/kernels/limbic_affect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limbic_affect.js","sourceRoot":"","sources":["../../src/kernels/limbic_affect.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,mDAAmD;AACnD,iFAAiF;AACjF,0EAA0E;AAC1E,2EAA2E;AAC3E,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAW,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDpD,CAAC"}

package/dist/limbic/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Limbic system – trainable affective/motivational dynamics for agents.
+ *
+ * The dynamic counterpart to the (static) psychometric personality: where
+ * personality sets the homeostatic setpoints, the limbic model learns — in
+ * WebGPU — how an agent's affective state moves in response to experience.
+ */
+export { REGION, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, clampDim, clampState, neutralState, stateToRecord, recordToState, } from "./regions.js";
+export type { Region, LimbicDimName } from "./regions.js";
+export { LimbicModel, DEFAULT_LIMBIC_CONFIG, DEFAULT_LIMBIC_SEED } from "./limbic_model.js";
+export type { LimbicModelConfig, LimbicForward, LimbicParam } from "./limbic_model.js";
+export { LimbicTrainer } from "./limbic_trainer.js";
+export type { LimbicSample, LimbicTrainOptions } from "./limbic_trainer.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/limbic/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/limbic/index.js

@@ -0,0 +1,11 @@
+/**
+ * Limbic system – trainable affective/motivational dynamics for agents.
+ *
+ * The dynamic counterpart to the (static) psychometric personality: where
+ * personality sets the homeostatic setpoints, the limbic model learns — in
+ * WebGPU — how an agent's affective state moves in response to experience.
+ */
+export { REGION, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, clampDim, clampState, neutralState, stateToRecord, recordToState, } from "./regions.js";
+export { LimbicModel, DEFAULT_LIMBIC_CONFIG, DEFAULT_LIMBIC_SEED } from "./limbic_model.js";
+export { LimbicTrainer } from "./limbic_trainer.js";
+//# sourceMappingURL=index.js.map

package/dist/limbic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/limbic/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/limbic/limbic_model.d.ts

@@ -0,0 +1,111 @@
+/**
+ * limbic_model.ts – LimbicModel: a small, trainable recurrent affect head.
+ *
+ * The limbic model learns the *dynamics* of an agent's affective/motivational
+ * state. Given an experience embedding (produced upstream by the hippocampus
+ * SSM) and the current affective state, it predicts:
+ *   • a bounded affect *delta* (how valence/arousal/drives/attention/exploration
+ *     should move in response to this experience), and
+ *   • a scalar *reward* prediction (how good/bad this experience was).
+ *
+ * Architecture (intentionally tiny — the heavy representation work happens in
+ * the hippocampus; this head just maps representation → affect):
+ *
+ *   pre[j]  = Σ_i Win[j,i]·x[i] + Σ_k Ws[j,k]·s[k]        (hidden pre-activation)
+ *   a[j]    = sigmoid(A[j])                               (per-channel SSM gate)
+ *   h'[j]   = a[j]·h[j] + (1-a[j])·tanh(pre[j])           (recurrent leak/input)
+ *   Δ[k]    = tanh( Σ_j Wout[k,j]·h'[j] + b[k] )          (bounded affect delta)
+ *   r       = Σ_j Wr[j]·h'[j] + br                        (reward prediction)
+ *
+ * It runs on WebGPU (per-turn `step()` via {@link LIMBIC_AFFECT_WGSL}, and the
+ * AdamW optimiser via the shared WEIGHT_UPDATE_WGSL kernel during training) with
+ * a numerically-identical pure-CPU reference path used when no GPUDevice is
+ * available — the same WebGPU-or-fallback contract the rest of the engine uses.
+ *
+ * Training uses truncated BPTT(1): the recurrent state is carried forward across
+ * a sequence, but each step's gradient treats the incoming hidden state as a
+ * constant. For an affect head this is stable and sufficient — each
+ * (experience, state) → affect pair is close to an independent regression.
+ */
+export interface LimbicModelConfig {
+    /** Experience-embedding dimension (input). Default 32. */
+    inputDim: number;
+    /** Hidden recurrent width. Must be ≤ 64 (the GPU kernel's workgroup size). Default 16. */
+    hiddenDim: number;
+    /** Affective state dimension. Default {@link LIMBIC_STATE_DIM} (8). */
+    stateDim: number;
+    /** Deterministic init seed for reproducible cold-start weights. */
+    seed?: number;
+    /** Weight of the reward-prediction term in the training loss. Default 0.5. */
+    rewardWeight?: number;
+}
+export declare const DEFAULT_LIMBIC_CONFIG: Required<Omit<LimbicModelConfig, "seed">>;
+/** Result of a single forward step. */
+export interface LimbicForward {
+    /** Next hidden recurrent state (length hiddenDim). */
+    hidden: Float32Array;
+    /** Bounded affect delta in (-1, 1) per state dim (length stateDim). */
+    delta: Float32Array;
+    /** Reward prediction (scalar). */
+    reward: number;
+}
+/** A named trainable parameter tensor (flat row-major Float32Array). */
+export interface LimbicParam {
+    name: string;
+    data: Float32Array;
+    numel: number;
+}
+/** Fixed default init seed — reproducible byte-identical cold start across machines. */
+export declare const DEFAULT_LIMBIC_SEED = 296863214;
+export declare class LimbicModel {
+    readonly config: Required<Omit<LimbicModelConfig, "seed">>;
+    win: Float32Array;
+    ws: Float32Array;
+    aLogit: Float32Array;
+    woutState: Float32Array;
+    boutState: Float32Array;
+    woutReward: Float32Array;
+    boutReward: Float32Array;
+    private gWin;
+    private gWs;
+    private gALogit;
+    private gWoutState;
+    private gBoutState;
+    private gWoutReward;
+    private gBoutReward;
+    constructor(config?: Partial<LimbicModelConfig>);
+    /** Trainable parameters, in the canonical checkpoint order. */
+    parameters(): LimbicParam[];
+    /** Gradient buffers, index-aligned with {@link parameters}. */
+    gradients(): LimbicParam[];
+    zeroGrad(): void;
+    /** A fresh zeroed hidden state. */
+    initHidden(): Float32Array;
+    /**
+     * One forward step (CPU reference). Pure — does not mutate the model or the
+     * inputs. The GPU kernel path produces numerically-identical results.
+     */
+    forward(x: ArrayLike<number>, hPrev: ArrayLike<number>, sPrev: ArrayLike<number>): LimbicForward;
+    private _forwardCached;
+    /**
+     * Accumulate gradients for one (input, state) → (deltaTarget, rewardTarget)
+     * sample using truncated BPTT(1). Returns the scalar loss for this step and
+     * the next hidden state to carry forward. Call {@link zeroGrad} before a batch
+     * and apply the optimiser after.
+     */
+    backwardStep(x: ArrayLike<number>, hPrev: ArrayLike<number>, sPrev: ArrayLike<number>, deltaTarget: ArrayLike<number>, rewardTarget: number): {
+        loss: number;
+        hidden: Float32Array;
+    };
+    /**
+     * Serialise weights to a compact "LMBC" binary. fp16 (v2) halves the size at
+     * ~0.5% precision cost; f32 (v1) is exact. Layout: magic, version, [inputDim,
+     * hiddenDim, stateDim], then params in {@link parameters} order.
+     */
+    exportWeights(opts?: {
+        fp16?: boolean;
+    }): ArrayBuffer;
+    /** Load weights from an "LMBC" binary. Validates magic + dims. */
+    loadWeights(buffer: ArrayBuffer): void;
+}
+//# sourceMappingURL=limbic_model.d.ts.map

package/dist/limbic/limbic_model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limbic_model.d.ts","sourceRoot":"","sources":["../../src/limbic/limbic_model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAK3E,CAAC;AAEF,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;IACpB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,YAAa,CAAC;AAM9C,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;IAG3D,GAAG,EAAE,YAAY,CAAC;IAClB,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,YAAY,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;IAGzB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAe;gBAEtB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAuCnD,+DAA+D;IAC/D,UAAU,IAAI,WAAW,EAAE;IAY3B,+DAA+D;IAC/D,SAAS,IAAI,WAAW,EAAE;IAY1B,QAAQ,IAAI,IAAI;IAUhB,mCAAmC;IACnC,UAAU,IAAI,YAAY;IAI1B;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,aAAa;IAKhG,OAAO,CAAC,cAAc;IAsCtB;;;;;OAKG;IACH,YAAY,CACV,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EACxB,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,GACnB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE;IAoDzC;;;;OAIG;IACH,aAAa,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,WAAW;IAmCzD,kEAAkE;IAClE,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CA2BvC"}

package/dist/limbic/limbic_model.js

@@ -0,0 +1,299 @@
+/**
+ * limbic_model.ts – LimbicModel: a small, trainable recurrent affect head.
+ *
+ * The limbic model learns the *dynamics* of an agent's affective/motivational
+ * state. Given an experience embedding (produced upstream by the hippocampus
+ * SSM) and the current affective state, it predicts:
+ *   • a bounded affect *delta* (how valence/arousal/drives/attention/exploration
+ *     should move in response to this experience), and
+ *   • a scalar *reward* prediction (how good/bad this experience was).
+ *
+ * Architecture (intentionally tiny — the heavy representation work happens in
+ * the hippocampus; this head just maps representation → affect):
+ *
+ *   pre[j]  = Σ_i Win[j,i]·x[i] + Σ_k Ws[j,k]·s[k]        (hidden pre-activation)
+ *   a[j]    = sigmoid(A[j])                               (per-channel SSM gate)
+ *   h'[j]   = a[j]·h[j] + (1-a[j])·tanh(pre[j])           (recurrent leak/input)
+ *   Δ[k]    = tanh( Σ_j Wout[k,j]·h'[j] + b[k] )          (bounded affect delta)
+ *   r       = Σ_j Wr[j]·h'[j] + br                        (reward prediction)
+ *
+ * It runs on WebGPU (per-turn `step()` via {@link LIMBIC_AFFECT_WGSL}, and the
+ * AdamW optimiser via the shared WEIGHT_UPDATE_WGSL kernel during training) with
+ * a numerically-identical pure-CPU reference path used when no GPUDevice is
+ * available — the same WebGPU-or-fallback contract the rest of the engine uses.
+ *
+ * Training uses truncated BPTT(1): the recurrent state is carried forward across
+ * a sequence, but each step's gradient treats the incoming hidden state as a
+ * constant. For an affect head this is stable and sufficient — each
+ * (experience, state) → affect pair is close to an independent regression.
+ */
+import { SeededRng } from "../utils/rng.js";
+import { quantizeFp16, dequantizeFp16 } from "../utils/quantization.js";
+import { LIMBIC_STATE_DIM } from "./regions.js";
+export const DEFAULT_LIMBIC_CONFIG = {
+    inputDim: 32,
+    hiddenDim: 16,
+    stateDim: LIMBIC_STATE_DIM,
+    rewardWeight: 0.5,
+};
+const MAGIC = 0x4c4d4243; // "LMBC"
+/** Fixed default init seed — reproducible byte-identical cold start across machines. */
+export const DEFAULT_LIMBIC_SEED = 0x11b1c5ee;
+function sigmoid(x) {
+    return 1 / (1 + Math.exp(-x));
+}
+export class LimbicModel {
+    config;
+    // Parameters (flat, row-major).
+    win; // hidden × input
+    ws; // hidden × state
+    aLogit; // hidden
+    woutState; // state × hidden
+    boutState; // state
+    woutReward; // hidden
+    boutReward; // 1
+    // Gradient accumulators (same shapes), allocated lazily.
+    gWin;
+    gWs;
+    gALogit;
+    gWoutState;
+    gBoutState;
+    gWoutReward;
+    gBoutReward;
+    constructor(config = {}) {
+        const cfg = { ...DEFAULT_LIMBIC_CONFIG, ...config };
+        if (cfg.hiddenDim > 64) {
+            throw new Error(`LimbicModel hiddenDim must be ≤ 64 (got ${cfg.hiddenDim})`);
+        }
+        this.config = cfg;
+        const { inputDim, hiddenDim, stateDim } = cfg;
+        const rng = new SeededRng(((config.seed ?? DEFAULT_LIMBIC_SEED) >>> 0) || 1);
+        const randn = (std) => {
+            const u1 = Math.max(rng.next(), 1e-12);
+            const u2 = rng.next();
+            return std * Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+        };
+        const gauss = (n, std) => {
+            const a = new Float32Array(n);
+            for (let i = 0; i < n; i++)
+                a[i] = randn(std);
+            return a;
+        };
+        // Small init — affect deltas should start near zero so an untrained model is
+        // inert (no spurious mood swings) until it has learned from experience.
+        this.win = gauss(hiddenDim * inputDim, 0.1);
+        this.ws = gauss(hiddenDim * stateDim, 0.1);
+        this.aLogit = gauss(hiddenDim, 0.05); // sigmoid(~0) ≈ 0.5 leak
+        this.woutState = gauss(stateDim * hiddenDim, 0.05);
+        this.boutState = new Float32Array(stateDim);
+        this.woutReward = gauss(hiddenDim, 0.05);
+        this.boutReward = new Float32Array(1);
+        this.gWin = new Float32Array(this.win.length);
+        this.gWs = new Float32Array(this.ws.length);
+        this.gALogit = new Float32Array(this.aLogit.length);
+        this.gWoutState = new Float32Array(this.woutState.length);
+        this.gBoutState = new Float32Array(this.boutState.length);
+        this.gWoutReward = new Float32Array(this.woutReward.length);
+        this.gBoutReward = new Float32Array(1);
+    }
+    /** Trainable parameters, in the canonical checkpoint order. */
+    parameters() {
+        return [
+            { name: "win", data: this.win, numel: this.win.length },
+            { name: "ws", data: this.ws, numel: this.ws.length },
+            { name: "aLogit", data: this.aLogit, numel: this.aLogit.length },
+            { name: "woutState", data: this.woutState, numel: this.woutState.length },
+            { name: "boutState", data: this.boutState, numel: this.boutState.length },
+            { name: "woutReward", data: this.woutReward, numel: this.woutReward.length },
+            { name: "boutReward", data: this.boutReward, numel: this.boutReward.length },
+        ];
+    }
+    /** Gradient buffers, index-aligned with {@link parameters}. */
+    gradients() {
+        return [
+            { name: "win", data: this.gWin, numel: this.gWin.length },
+            { name: "ws", data: this.gWs, numel: this.gWs.length },
+            { name: "aLogit", data: this.gALogit, numel: this.gALogit.length },
+            { name: "woutState", data: this.gWoutState, numel: this.gWoutState.length },
+            { name: "boutState", data: this.gBoutState, numel: this.gBoutState.length },
+            { name: "woutReward", data: this.gWoutReward, numel: this.gWoutReward.length },
+            { name: "boutReward", data: this.gBoutReward, numel: this.gBoutReward.length },
+        ];
+    }
+    zeroGrad() {
+        this.gWin.fill(0);
+        this.gWs.fill(0);
+        this.gALogit.fill(0);
+        this.gWoutState.fill(0);
+        this.gBoutState.fill(0);
+        this.gWoutReward.fill(0);
+        this.gBoutReward.fill(0);
+    }
+    /** A fresh zeroed hidden state. */
+    initHidden() {
+        return new Float32Array(this.config.hiddenDim);
+    }
+    /**
+     * One forward step (CPU reference). Pure — does not mutate the model or the
+     * inputs. The GPU kernel path produces numerically-identical results.
+     */
+    forward(x, hPrev, sPrev) {
+        const cache = this._forwardCached(x, hPrev, sPrev);
+        return { hidden: cache.hn, delta: cache.delta, reward: cache.reward };
+    }
+    _forwardCached(x, hPrev, sPrev) {
+        const { inputDim, hiddenDim, stateDim } = this.config;
+        const xa = Float32Array.from({ length: inputDim }, (_, i) => x[i] ?? 0);
+        const ha = Float32Array.from({ length: hiddenDim }, (_, j) => hPrev[j] ?? 0);
+        const sa = Float32Array.from({ length: stateDim }, (_, k) => sPrev[k] ?? 0);
+        const a = new Float32Array(hiddenDim);
+        const t = new Float32Array(hiddenDim);
+        const hn = new Float32Array(hiddenDim);
+        for (let j = 0; j < hiddenDim; j++) {
+            let pre = 0;
+            const wiOff = j * inputDim;
+            for (let i = 0; i < inputDim; i++)
+                pre += this.win[wiOff + i] * xa[i];
+            const wsOff = j * stateDim;
+            for (let k = 0; k < stateDim; k++)
+                pre += this.ws[wsOff + k] * sa[k];
+            a[j] = sigmoid(this.aLogit[j]);
+            t[j] = Math.tanh(pre);
+            hn[j] = a[j] * ha[j] + (1 - a[j]) * t[j];
+        }
+        const delta = new Float32Array(stateDim);
+        for (let k = 0; k < stateDim; k++) {
+            let acc = this.boutState[k];
+            const off = k * hiddenDim;
+            for (let j = 0; j < hiddenDim; j++)
+                acc += this.woutState[off + j] * hn[j];
+            delta[k] = Math.tanh(acc);
+        }
+        let reward = this.boutReward[0];
+        for (let j = 0; j < hiddenDim; j++)
+            reward += this.woutReward[j] * hn[j];
+        return { x: xa, sPrev: sa, hPrev: ha, a, t, hn, delta, reward };
+    }
+    /**
+     * Accumulate gradients for one (input, state) → (deltaTarget, rewardTarget)
+     * sample using truncated BPTT(1). Returns the scalar loss for this step and
+     * the next hidden state to carry forward. Call {@link zeroGrad} before a batch
+     * and apply the optimiser after.
+     */
+    backwardStep(x, hPrev, sPrev, deltaTarget, rewardTarget) {
+        const { inputDim, hiddenDim, stateDim, rewardWeight } = this.config;
+        const c = this._forwardCached(x, hPrev, sPrev);
+        // Loss
+        let loss = 0;
+        const dDelta = new Float32Array(stateDim);
+        for (let k = 0; k < stateDim; k++) {
+            const diff = c.delta[k] - (deltaTarget[k] ?? 0);
+            loss += 0.5 * diff * diff;
+            dDelta[k] = diff;
+        }
+        const dRewardDiff = c.reward - rewardTarget;
+        loss += 0.5 * rewardWeight * dRewardDiff * dRewardDiff;
+        const dReward = rewardWeight * dRewardDiff;
+        // Backprop to hidden through both heads.
+        const dHn = new Float32Array(hiddenDim);
+        for (let k = 0; k < stateDim; k++) {
+            const dPreDelta = dDelta[k] * (1 - c.delta[k] * c.delta[k]); // tanh'
+            this.gBoutState[k] = this.gBoutState[k] + dPreDelta;
+            const off = k * hiddenDim;
+            for (let j = 0; j < hiddenDim; j++) {
+                this.gWoutState[off + j] = this.gWoutState[off + j] + dPreDelta * c.hn[j];
+                dHn[j] = dHn[j] + dPreDelta * this.woutState[off + j];
+            }
+        }
+        this.gBoutReward[0] = this.gBoutReward[0] + dReward;
+        for (let j = 0; j < hiddenDim; j++) {
+            this.gWoutReward[j] = this.gWoutReward[j] + dReward * c.hn[j];
+            dHn[j] = dHn[j] + dReward * this.woutReward[j];
+        }
+        // Backprop through the recurrent update hn = a·hPrev + (1-a)·t.
+        for (let j = 0; j < hiddenDim; j++) {
+            const aj = c.a[j];
+            const tj = c.t[j];
+            // ∂hn/∂A = (hPrev - t)·a·(1-a)
+            this.gALogit[j] = this.gALogit[j] + dHn[j] * (c.hPrev[j] - tj) * aj * (1 - aj);
+            // ∂hn/∂t = (1-a);  ∂t/∂pre = 1 - t²
+            const dPre = dHn[j] * (1 - aj) * (1 - tj * tj);
+            const wiOff = j * inputDim;
+            for (let i = 0; i < inputDim; i++)
+                this.gWin[wiOff + i] = this.gWin[wiOff + i] + dPre * c.x[i];
+            const wsOff = j * stateDim;
+            for (let k = 0; k < stateDim; k++)
+                this.gWs[wsOff + k] = this.gWs[wsOff + k] + dPre * c.sPrev[k];
+        }
+        return { loss, hidden: c.hn };
+    }
+    // ── Checkpoint serialisation ──────────────────────────────────────────────
+    /**
+     * Serialise weights to a compact "LMBC" binary. fp16 (v2) halves the size at
+     * ~0.5% precision cost; f32 (v1) is exact. Layout: magic, version, [inputDim,
+     * hiddenDim, stateDim], then params in {@link parameters} order.
+     */
+    exportWeights(opts = {}) {
+        const fp16 = opts.fp16 ?? false;
+        const params = this.parameters();
+        const total = params.reduce((n, p) => n + p.numel, 0);
+        const headerEls = 5; // magic, version, inputDim, hiddenDim, stateDim
+        const headerBytes = headerEls * 4;
+        const dataBytes = fp16 ? total * 2 : total * 4;
+        const buf = new ArrayBuffer(headerBytes + dataBytes);
+        const head = new Uint32Array(buf, 0, headerEls);
+        head[0] = MAGIC;
+        head[1] = fp16 ? 2 : 1;
+        head[2] = this.config.inputDim;
+        head[3] = this.config.hiddenDim;
+        head[4] = this.config.stateDim;
+        if (fp16) {
+            const flat = new Float32Array(total);
+            let o = 0;
+            for (const p of params) {
+                flat.set(p.data, o);
+                o += p.numel;
+            }
+            const q = quantizeFp16(flat); // Uint16Array
+            new Uint16Array(buf, headerBytes, total).set(q);
+        }
+        else {
+            const out = new Float32Array(buf, headerBytes, total);
+            let o = 0;
+            for (const p of params) {
+                out.set(p.data, o);
+                o += p.numel;
+            }
+        }
+        return buf;
+    }
+    /** Load weights from an "LMBC" binary. Validates magic + dims. */
+    loadWeights(buffer) {
+        const head = new Uint32Array(buffer, 0, 5);
+        if (head[0] !== MAGIC)
+            throw new Error("LimbicModel.loadWeights: bad magic (not an LMBC checkpoint)");
+        const version = head[1];
+        const inputDim = head[2];
+        const hiddenDim = head[3];
+        const stateDim = head[4];
+        if (inputDim !== this.config.inputDim || hiddenDim !== this.config.hiddenDim || stateDim !== this.config.stateDim) {
+            throw new Error(`LimbicModel.loadWeights: dim mismatch — checkpoint ${inputDim}/${hiddenDim}/${stateDim} vs model ${this.config.inputDim}/${this.config.hiddenDim}/${this.config.stateDim}`);
+        }
+        const params = this.parameters();
+        const total = params.reduce((n, p) => n + p.numel, 0);
+        const headerBytes = 20;
+        let flat;
+        if (version === 2) {
+            flat = dequantizeFp16(new Uint16Array(buffer, headerBytes, total));
+        }
+        else {
+            flat = new Float32Array(buffer.slice(headerBytes, headerBytes + total * 4));
+        }
+        let o = 0;
+        for (const p of params) {
+            p.data.set(flat.subarray(o, o + p.numel));
+            o += p.numel;
+        }
+    }
+}
+//# sourceMappingURL=limbic_model.js.map

package/dist/limbic/limbic_model.js.map

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