@seanhogg/builderforce-memory-engine 2026.7.14 → 2026.9.27

package/dist/{moe/moe_package.js → evermind/package.js}

@@ -1,5 +1,5 @@
 /**
- * moe_package.ts — EvermindModelPackage: the portable, publishable AI artifact.
+ * evermind/package.ts — EvermindModelPackage: the portable, publishable AI artifact.
  *
  * This is the unit a creator publishes to the marketplace and a buyer downloads
  * and runs: a self-describing manifest (name, version, config, model card,
@@ -10,9 +10,10 @@
  * Zero-dep and isomorphic: serialises via TextEncoder/TextDecoder, runs in the
  * browser (where models are trained) and in Node/Workers (where they execute).
  */
-import { SharedExpertMoE } from "./moe_model.js";
+import { SharedExpertMoE } from "../moe/moe_model.js";
 import { EvermindLM } from "../lm/evermind_lm.js";
 import { VideoRVQCodec } from "../codec/video_rvq.js";
+import { BPETokenizer } from "../tokenizer/bpe.js";
 /** First 4 bytes of a serialised package: "EVM1". */
 const PKG_MAGIC = 0x45564d31;
 const PKG_VERSION = 1;
@@ -34,17 +35,47 @@ export class EvermindModelPackage {
     manifest;
     checkpoint;
     codec;
+    tokenizer;
     constructor(manifest, checkpoint, 
     /** Serialized media codec ("VRQ0" blob), present for video/image packages. */
-    codec) {
+    codec, 
+    /** Serialized BPE tokenizer ("BPE0" blob) — present when the package embeds one. */
+    tokenizer) {
         this.manifest = manifest;
         this.checkpoint = checkpoint;
         this.codec = codec;
+        this.tokenizer = tokenizer;
+    }
+    /**
+     * Serialise `meta.tokenizer` and the manifest fields describing it, or `{}` when
+     * no tokenizer was supplied. Shared by every `from*` factory so the vocab-size
+     * cross-check exists in exactly one place.
+     */
+    static _tokenizerSection(meta, modelVocabSize) {
+        if (!meta.tokenizer)
+            return { fields: {} };
+        const vocabSize = meta.tokenizer.vocabSize;
+        if (modelVocabSize != null && vocabSize !== modelVocabSize) {
+            throw new Error(`EvermindModelPackage: tokenizer vocabSize (${vocabSize}) must equal the model's (${modelVocabSize}) — ` +
+                "a mismatched pair decodes to nonsense.");
+        }
+        const blob = meta.tokenizer.serialize();
+        return {
+            blob,
+            fields: {
+                tokenizerFormat: "BPE0",
+                tokenizerBytes: blob.byteLength,
+                tokenizerChecksum: fnv1a(new Uint8Array(blob)),
+                tokenizerVocabSize: vocabSize,
+            },
+        };
     }
     /** Package a trained model with its publishing metadata. */
     static fromModel(model, meta) {
         const fp16 = meta.fp16 ?? false;
         const checkpoint = model.exportWeights({ fp16 });
+        // A bare MoE layer has no vocabulary of its own, so there is nothing to cross-check.
+        const tokenizer = EvermindModelPackage._tokenizerSection(meta, undefined);
         const manifest = {
             schema: "evermind.model/1",
             name: meta.name,
@@ -54,16 +85,19 @@ export class EvermindModelPackage {
             paramCount: model.parameters().reduce((n, p) => n + p.numel, 0),
             checkpointFormat: "MoE0",
             checkpointFp16: fp16,
+            ...(tokenizer.blob ? { checkpointBytes: checkpoint.byteLength } : {}),
             checksum: fnv1a(new Uint8Array(checkpoint)),
+            ...tokenizer.fields,
             card: meta.card,
             ...(meta.createdAt ? { createdAt: meta.createdAt } : {}),
         };
-        return new EvermindModelPackage(manifest, checkpoint);
+        return new EvermindModelPackage(manifest, checkpoint, undefined, tokenizer.blob);
     }
     /** Package a trained generative {@link EvermindLM} — the runnable marketplace AI. */
     static fromLM(lm, meta) {
         const fp16 = meta.fp16 ?? false;
         const checkpoint = lm.exportWeights({ fp16 });
+        const tokenizer = EvermindModelPackage._tokenizerSection(meta, lm.config.vocabSize);
         const manifest = {
             schema: "evermind.model/1",
             name: meta.name,
@@ -73,11 +107,13 @@ export class EvermindModelPackage {
             paramCount: lm.parameters().reduce((n, p) => n + p.data.length, 0),
             checkpointFormat: "EVL0",
             checkpointFp16: fp16,
+            ...(tokenizer.blob ? { checkpointBytes: checkpoint.byteLength } : {}),
             checksum: fnv1a(new Uint8Array(checkpoint)),
+            ...tokenizer.fields,
             card: meta.card,
             ...(meta.createdAt ? { createdAt: meta.createdAt } : {}),
         };
-        return new EvermindModelPackage(manifest, checkpoint);
+        return new EvermindModelPackage(manifest, checkpoint, undefined, tokenizer.blob);
     }
     /**
      * Package a video/image generative model: its {@link EvermindLM} weights AND the
@@ -92,6 +128,7 @@ export class EvermindModelPackage {
         const fp16 = meta.fp16 ?? false;
         const checkpoint = lm.exportWeights({ fp16 });
         const codecBlob = codec.serialize();
+        const tokenizer = EvermindModelPackage._tokenizerSection(meta, lm.config.vocabSize);
         const manifest = {
             schema: "evermind.model/1",
             name: meta.name,
@@ -105,18 +142,25 @@ export class EvermindModelPackage {
             checkpointBytes: checkpoint.byteLength,
             checksum: fnv1a(new Uint8Array(checkpoint)),
             codecFormat: "VRQ0",
+            ...(tokenizer.blob ? { codecBytes: codecBlob.byteLength } : {}),
             codecChecksum: fnv1a(new Uint8Array(codecBlob)),
+            ...tokenizer.fields,
             card: meta.card,
             ...(meta.createdAt ? { createdAt: meta.createdAt } : {}),
         };
-        return new EvermindModelPackage(manifest, checkpoint, codecBlob);
+        return new EvermindModelPackage(manifest, checkpoint, codecBlob, tokenizer.blob);
     }
-    /** Serialise to a single `.evermind` blob: magic, version, manifest, checkpoint[, codec]. */
+    /**
+     * Serialise to a single `.evermind` blob: magic, version, manifest, checkpoint
+     * [, codec][, tokenizer]. Each section's length is fixed in the manifest whenever
+     * another section follows it, so the reader never has to guess where one ends.
+     */
     toBlob() {
         const manifestBytes = new TextEncoder().encode(JSON.stringify(this.manifest));
         const headerBytes = 12; // magic, version, manifestLen
         const codecBytes = this.codec?.byteLength ?? 0;
-        const out = new ArrayBuffer(headerBytes + manifestBytes.byteLength + this.checkpoint.byteLength + codecBytes);
+        const tokBytes = this.tokenizer?.byteLength ?? 0;
+        const out = new ArrayBuffer(headerBytes + manifestBytes.byteLength + this.checkpoint.byteLength + codecBytes + tokBytes);
         const head = new Uint32Array(out, 0, 3);
         head[0] = PKG_MAGIC;
         head[1] = PKG_VERSION;
@@ -126,8 +170,12 @@ export class EvermindModelPackage {
         o += manifestBytes.byteLength;
         new Uint8Array(out, o, this.checkpoint.byteLength).set(new Uint8Array(this.checkpoint));
         o += this.checkpoint.byteLength;
-        if (this.codec)
+        if (this.codec) {
             new Uint8Array(out, o, codecBytes).set(new Uint8Array(this.codec));
+            o += codecBytes;
+        }
+        if (this.tokenizer)
+            new Uint8Array(out, o, tokBytes).set(new Uint8Array(this.tokenizer));
         return out;
     }
     /** Parse a `.evermind` blob. Throws on bad magic / truncation. */
@@ -145,18 +193,34 @@ export class EvermindModelPackage {
         const manifestBytes = new Uint8Array(buffer, headerBytes, manifestLen);
         const manifest = JSON.parse(new TextDecoder().decode(manifestBytes));
         const bodyStart = headerBytes + manifestLen;
-        // A codec section follows the checkpoint only when the manifest fixed the
-        // checkpoint length; otherwise the checkpoint runs to end-of-blob (text layout).
+        // Sections run checkpoint -> codec -> tokenizer, each present only when the
+        // manifest says so. A section's length is explicit whenever another follows it;
+        // the last section runs to end-of-blob. That keeps every package written before
+        // the codec and tokenizer sections existed readable byte for byte.
         const cpBytes = manifest.checkpointBytes;
-        if (cpBytes != null) {
-            if (bodyStart + cpBytes > buffer.byteLength) {
-                throw new Error("EvermindModelPackage.fromBlob: truncated (checkpointBytes exceeds blob)");
+        if (cpBytes == null)
+            return new EvermindModelPackage(manifest, buffer.slice(bodyStart));
+        if (bodyStart + cpBytes > buffer.byteLength) {
+            throw new Error("EvermindModelPackage.fromBlob: truncated (checkpointBytes exceeds blob)");
+        }
+        const checkpoint = buffer.slice(bodyStart, bodyStart + cpBytes);
+        let o = bodyStart + cpBytes;
+        const tokBytes = manifest.tokenizerBytes ?? 0;
+        if (o + tokBytes > buffer.byteLength) {
+            throw new Error("EvermindModelPackage.fromBlob: truncated (tokenizerBytes exceeds blob)");
+        }
+        const tokStart = buffer.byteLength - tokBytes;
+        let codec;
+        if (o < tokStart) {
+            const codecEnd = manifest.codecBytes != null ? o + manifest.codecBytes : tokStart;
+            if (codecEnd > tokStart) {
+                throw new Error("EvermindModelPackage.fromBlob: truncated (codecBytes overruns the tokenizer section)");
             }
-            const checkpoint = buffer.slice(bodyStart, bodyStart + cpBytes);
-            const codec = bodyStart + cpBytes < buffer.byteLength ? buffer.slice(bodyStart + cpBytes) : undefined;
-            return new EvermindModelPackage(manifest, checkpoint, codec);
+            codec = buffer.slice(o, codecEnd);
+            o = codecEnd;
         }
-        return new EvermindModelPackage(manifest, buffer.slice(bodyStart));
+        const tokenizer = tokBytes > 0 ? buffer.slice(tokStart) : undefined;
+        return new EvermindModelPackage(manifest, checkpoint, codec, tokenizer);
     }
     /** Verify integrity + structural sanity before trusting a downloaded package. */
     validate() {
@@ -195,8 +259,43 @@ export class EvermindModelPackage {
                 }
             }
         }
+        // An embedded tokenizer must be intact AND agree with the model's vocabulary —
+        // a corrupt or mismatched one decodes confidently into nonsense.
+        if (this.manifest.tokenizerFormat) {
+            if (!this.tokenizer) {
+                errors.push("manifest declares an embedded tokenizer but the package has no tokenizer section");
+            }
+            else {
+                const tokActual = fnv1a(new Uint8Array(this.tokenizer));
+                if (tokActual !== this.manifest.tokenizerChecksum) {
+                    errors.push(`tokenizer checksum mismatch (manifest ${this.manifest.tokenizerChecksum}, actual ${tokActual}) - corrupt tokenizer`);
+                }
+                const modelVocab = this.manifest.config?.['vocabSize'];
+                const tokVocab = this.manifest.tokenizerVocabSize;
+                if (modelVocab != null && tokVocab != null && modelVocab !== tokVocab) {
+                    errors.push(`tokenizer vocabSize (${tokVocab}) does not match the model's (${modelVocab})`);
+                }
+            }
+        }
         return { ok: errors.length === 0, errors };
     }
+    /**
+     * The tokenizer embedded in this package, or `null` when it carries none.
+     *
+     * A package WITH one is self-contained: a consumer runs `loadLM()` +
+     * `loadTokenizer()` and can turn text into tokens and back with the exact
+     * vocabulary the model was trained on. A package without one still loads — every
+     * artifact published before this section existed is in that shape — but the
+     * consumer must supply the matching vocabulary itself.
+     */
+    loadTokenizer() {
+        if (!this.manifest.tokenizerFormat || !this.tokenizer)
+            return null;
+        const v = this.validate();
+        if (!v.ok)
+            throw new Error(`EvermindModelPackage.loadTokenizer: ${v.errors.join("; ")}`);
+        return BPETokenizer.deserialize(this.tokenizer);
+    }
     /** Reconstruct the bare MoE layer. Validates first; throws if invalid / wrong type. */
     loadModel() {
         const v = this.validate();
@@ -237,4 +336,4 @@ export class EvermindModelPackage {
         return { lm: this.loadLM(), codec: VideoRVQCodec.deserialize(this.codec), modality };
     }
 }
-//# sourceMappingURL=moe_package.js.map
+//# sourceMappingURL=package.js.map

package/dist/evermind/package.js.map

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

package/dist/import/foreign/adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * import/foreign/adapter.ts — what every foreign-architecture adapter provides,
+ * plus the shared `config.json` readers so no adapter re-implements them.
+ *
+ * An adapter answers two questions about a published checkpoint:
+ *   1. what {@link HybridMambaModelConfig} do these weights fit? and
+ *   2. which {@link PortPlan} moves them onto this engine's parameters?
+ * Everything downstream (detection, execution, upload) is architecture-agnostic.
+ */
+import type { HybridMambaModelConfig } from "../../model/mamba_model.js";
+import type { PortPlan } from "./plan.js";
+/** A checkpoint's parsed `config.json` (HF) or `params.json` (Mistral-native). */
+export type ForeignConfig = Record<string, unknown>;
+/** Everything a port needs to know about one checkpoint. */
+export interface PortTarget {
+    /** Construct a `HybridMambaModel` with this to receive the ported weights. */
+    modelConfig: HybridMambaModelConfig;
+    plan: PortPlan;
+}
+export interface ForeignMambaAdapter {
+    /** Stable id, e.g. `falcon_mamba`. */
+    readonly id: string;
+    /** Human-readable label for errors and reports. */
+    readonly label: string;
+    /** `config.model_type` values this adapter claims. */
+    readonly modelTypes: readonly string[];
+    /** `config.architectures[]` entries this adapter claims. */
+    readonly architectures: readonly string[];
+    /** Read the checkpoint's geometry and build its port plan. */
+    describe(config: ForeignConfig): PortTarget;
+}
+/** A positive integer field, required. */
+export declare function requireInt(config: ForeignConfig, key: string): number;
+/** The first of `keys` present as a positive integer, else `undefined`. */
+export declare function firstInt(config: ForeignConfig, keys: readonly string[]): number | undefined;
+/**
+ * The mixer's inner width.
+ *
+ * `intermediate_size` is authoritative and `expand` is NOT trustworthy:
+ * `tiiuae/falcon-mamba-7b` ships `expand: 16` against `hidden_size: 4096` while
+ * its weights are `d_inner = 8192`. Transformers only tolerates it because the
+ * JSON's `intermediate_size` is re-applied over the derived value, so a port
+ * that trusted `expand` would build a model 8× too wide. Fall back to
+ * `expand * hidden_size` only when `intermediate_size` is absent.
+ */
+export declare function readInnerSize(config: ForeignConfig, dModel: number): number;
+/**
+ * `d_inner / d_model` as this engine's integer `expand` factor — the blocks size
+ * themselves from it, so a non-integer ratio cannot be represented and must fail
+ * loudly rather than silently truncate.
+ */
+export declare function expandFactor(dInner: number, dModel: number, label: string): number;
+/**
+ * `time_step_rank`, resolving HF's `"auto"` to `ceil(hidden_size / 16)` — the
+ * same default `Mamba1Block` applies, so an `"auto"` checkpoint and this engine
+ * agree without the caller doing anything.
+ */
+export declare function readTimeStepRank(config: ForeignConfig, dModel: number): number;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/import/foreign/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/import/foreign/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,WAAW,EAAE,sBAAsB,CAAC;IACpC,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAAC;CAC7C;AAQD,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAM3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9E"}

package/dist/import/foreign/adapter.js

@@ -0,0 +1,76 @@
+/**
+ * import/foreign/adapter.ts — what every foreign-architecture adapter provides,
+ * plus the shared `config.json` readers so no adapter re-implements them.
+ *
+ * An adapter answers two questions about a published checkpoint:
+ *   1. what {@link HybridMambaModelConfig} do these weights fit? and
+ *   2. which {@link PortPlan} moves them onto this engine's parameters?
+ * Everything downstream (detection, execution, upload) is architecture-agnostic.
+ */
+// ── config.json readers ──────────────────────────────────────────────────────
+function fail(key, detail) {
+    throw new Error(`import/foreign: config field "${key}" ${detail}`);
+}
+/** A positive integer field, required. */
+export function requireInt(config, key) {
+    const v = config[key];
+    if (typeof v !== "number" || !Number.isInteger(v) || v <= 0) {
+        fail(key, `must be a positive integer, got ${JSON.stringify(v)}`);
+    }
+    return v;
+}
+/** The first of `keys` present as a positive integer, else `undefined`. */
+export function firstInt(config, keys) {
+    for (const key of keys) {
+        const v = config[key];
+        if (typeof v === "number" && Number.isInteger(v) && v > 0)
+            return v;
+    }
+    return undefined;
+}
+/**
+ * The mixer's inner width.
+ *
+ * `intermediate_size` is authoritative and `expand` is NOT trustworthy:
+ * `tiiuae/falcon-mamba-7b` ships `expand: 16` against `hidden_size: 4096` while
+ * its weights are `d_inner = 8192`. Transformers only tolerates it because the
+ * JSON's `intermediate_size` is re-applied over the derived value, so a port
+ * that trusted `expand` would build a model 8× too wide. Fall back to
+ * `expand * hidden_size` only when `intermediate_size` is absent.
+ */
+export function readInnerSize(config, dModel) {
+    const stated = firstInt(config, ["intermediate_size"]);
+    if (stated !== undefined)
+        return stated;
+    const expand = firstInt(config, ["expand"]);
+    if (expand === undefined) {
+        fail("intermediate_size", "is absent and no usable \"expand\" was found");
+    }
+    return expand * dModel;
+}
+/**
+ * `d_inner / d_model` as this engine's integer `expand` factor — the blocks size
+ * themselves from it, so a non-integer ratio cannot be represented and must fail
+ * loudly rather than silently truncate.
+ */
+export function expandFactor(dInner, dModel, label) {
+    if (dInner % dModel !== 0) {
+        throw new Error(`import/foreign: ${label} has d_inner ${dInner} which is not a whole multiple of ` +
+            `d_model ${dModel} — this engine's blocks are sized by an integer expand factor`);
+    }
+    return dInner / dModel;
+}
+/**
+ * `time_step_rank`, resolving HF's `"auto"` to `ceil(hidden_size / 16)` — the
+ * same default `Mamba1Block` applies, so an `"auto"` checkpoint and this engine
+ * agree without the caller doing anything.
+ */
+export function readTimeStepRank(config, dModel) {
+    const v = config["time_step_rank"];
+    if (typeof v === "number" && Number.isInteger(v) && v > 0)
+        return v;
+    if (v === undefined || v === "auto")
+        return Math.ceil(dModel / 16);
+    fail("time_step_rank", `must be a positive integer or "auto", got ${JSON.stringify(v)}`);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/import/foreign/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/import/foreign/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4BH,gFAAgF;AAEhF,SAAS,IAAI,CAAC,GAAW,EAAE,MAAc;IACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,GAAW;IAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,GAAG,EAAE,mCAAmC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,MAAqB,EAAE,IAAuB;IACrE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,mBAAmB,EAAE,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa;IACxE,IAAI,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,gBAAgB,MAAM,oCAAoC;YAChF,WAAW,MAAM,+DAA+D,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB,EAAE,MAAc;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,gBAAgB,EAAE,6CAA6C,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/import/foreign/apply.d.ts

@@ -0,0 +1,23 @@
+/**
+ * import/foreign/apply.ts — write ported weights into a live model.
+ *
+ * Kept separate from the port itself so the mapping stays device-free and
+ * testable: {@link portForeignMamba} produces plain `Float32Array`s, this is the
+ * only piece that needs a `GPUDevice`.
+ *
+ * Matching is by parameter NAME, never by position, so a change to
+ * `HybridMambaModel.parameters()` ordering can never silently mis-assign a
+ * buffer — an unexpected or missing name throws instead.
+ */
+import type { HybridMambaModel } from "../../model/mamba_model.js";
+import type { PortedTensors } from "./plan.js";
+/**
+ * Upload every ported tensor into `model`'s parameter buffers.
+ *
+ * Throws when the model expects a parameter the port did not produce, when an
+ * element count disagrees, or when the port produced a name the model does not
+ * have — all three mean the model was built from a different config than
+ * {@link PortedCheckpoint.modelConfig}.
+ */
+export declare function applyPortedWeights(model: HybridMambaModel, ported: PortedTensors): void;
+//# sourceMappingURL=apply.d.ts.map

package/dist/import/foreign/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/import/foreign/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA6BvF"}

package/dist/import/foreign/apply.js

@@ -0,0 +1,43 @@
+/**
+ * import/foreign/apply.ts — write ported weights into a live model.
+ *
+ * Kept separate from the port itself so the mapping stays device-free and
+ * testable: {@link portForeignMamba} produces plain `Float32Array`s, this is the
+ * only piece that needs a `GPUDevice`.
+ *
+ * Matching is by parameter NAME, never by position, so a change to
+ * `HybridMambaModel.parameters()` ordering can never silently mis-assign a
+ * buffer — an unexpected or missing name throws instead.
+ */
+import { uploadBuffer } from "../../utils/gpu_utils.js";
+/**
+ * Upload every ported tensor into `model`'s parameter buffers.
+ *
+ * Throws when the model expects a parameter the port did not produce, when an
+ * element count disagrees, or when the port produced a name the model does not
+ * have — all three mean the model was built from a different config than
+ * {@link PortedCheckpoint.modelConfig}.
+ */
+export function applyPortedWeights(model, ported) {
+    const params = model.parameters();
+    const expected = new Set(params.map((p) => p.name));
+    const extra = [...ported.weights.keys()].filter((name) => !expected.has(name));
+    if (extra.length > 0) {
+        throw new Error(`import/foreign: ported tensors ${extra.slice(0, 5).map((n) => `"${n}"`).join(", ")}` +
+            `${extra.length > 5 ? ` (+${extra.length - 5} more)` : ""} have no parameter on this model — ` +
+            `build it from the port's modelConfig`);
+    }
+    for (const param of params) {
+        const data = ported.weights.get(param.name);
+        if (!data) {
+            throw new Error(`import/foreign: no ported tensor for parameter "${param.name}" — ` +
+                `the model was built from a different config than the port's modelConfig`);
+        }
+        if (data.length !== param.numel) {
+            throw new Error(`import/foreign: parameter "${param.name}" expects ${param.numel} elements, ` +
+                `the port produced ${data.length}`);
+        }
+        uploadBuffer(model.device, param.buf, data);
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/import/foreign/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/import/foreign/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB,EAAE,MAAqB;IAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnF,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,qCAAqC;YAC9F,sCAAsC,CACzC,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,mDAAmD,KAAK,CAAC,IAAI,MAAM;gBACjE,yEAAyE,CAC5E,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,KAAK,aAAa;gBAC3E,qBAAqB,IAAI,CAAC,MAAM,EAAE,CACrC,CAAC;QACJ,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/import/foreign/codestral_mamba.d.ts

@@ -0,0 +1,57 @@
+/**
+ * import/foreign/codestral_mamba.ts — weight port for Codestral-Mamba
+ * (`mistralai/Mamba-Codestral-7B-v0.1`, `Mamba2ForCausalLM`,
+ * `model_type: "mamba2"`, Mamba-2 / SSD).
+ *
+ * Source layout confirmed against the repo's published HF `config.json`, its
+ * `model.safetensors.index.json` (579 tensors = 9 per layer × 64 + 3 globals),
+ * the header of `consolidated.safetensors`, and
+ * `transformers/models/mamba2/modeling_mamba2.py`:
+ *
+ *   backbone.embeddings.weight                    [vocab, d_model]
+ *   backbone.layers.{N}.norm.weight               [d_model]
+ *   backbone.layers.{N}.mixer.in_proj.weight      [2*d_inner + 2*n_groups*d_state + n_heads, d_model]
+ *   backbone.layers.{N}.mixer.conv1d.weight       [conv_dim, 1, d_conv]
+ *   backbone.layers.{N}.mixer.conv1d.bias         [conv_dim]
+ *   backbone.layers.{N}.mixer.dt_bias             [n_heads]
+ *   backbone.layers.{N}.mixer.A_log               [n_heads]
+ *   backbone.layers.{N}.mixer.D                   [n_heads]
+ *   backbone.layers.{N}.mixer.norm.weight         [d_inner]
+ *   backbone.layers.{N}.mixer.out_proj.weight     [d_model, d_inner]
+ *   backbone.norm_f.weight                        [d_model]
+ *   lm_head.weight                                [vocab, d_model]
+ *
+ * where `conv_dim = d_inner + 2 * n_groups * d_state`. Mamba-2 has no `x_proj`
+ * and no `dt_proj`: B, C and dt all come out of the fused `in_proj`.
+ *
+ * Three reconciliations against `Mamba2Block`:
+ *
+ *  1. **`in_proj` row order.** Upstream splits
+ *     `[gate (d_inner), x|B|C (conv_dim), dt (n_heads)]`; this engine's fused
+ *     projection is `[x (d_inner), B (n_groups*d_state), C (n_groups*d_state),
+ *     dt (n_heads)]` — the SAME tail, minus the leading gate rows. So the port
+ *     is one contiguous row slice starting at `d_inner`, and the gate rows are
+ *     declared as a discard (see 3).
+ *  2. **`A_log` convention.** Upstream uses `A = -exp(A_log)`; `ssd.ts` uses
+ *     `A = -softplus(A_log)`. The port re-expresses the same `A` as
+ *     `softplus⁻¹(exp(A_log))` so decay rates are preserved exactly, rather than
+ *     copying the raw value and silently changing every head's decay.
+ *  3. **The gate branch.** `Mamba2Block` has no `z` gate: it RMS-norms the scan
+ *     output and projects out, where upstream computes
+ *     `norm(y * silu(z))`. The `d_inner × d_model` gate rows therefore have no
+ *     target. That is a REAL loss of capability, not a formatting detail, and it
+ *     is reported as a `PortDiscard` on every layer so a caller sees it.
+ *
+ * Also mapped without transform: `mixer.norm.weight` → the block's inner
+ * `normWeight` (applied ungated here, per 3), `backbone.layers.N.norm.weight` →
+ * `preNormWeight`, `conv1d.{weight,bias}` (depthwise, taps reversed) → the fused
+ * `[x, B, C]` conv, and `D` / `dt_bias` per head. Linear weights are
+ * `[out, in]` row-major on both sides, so no transposes.
+ *
+ * `tie_word_embeddings: false`, so `lm_head.weight` is a real stored tensor with
+ * no target here (`HybridMambaModel` ties its head to the embedding) — it is
+ * reported as unmapped.
+ */
+import { type ForeignMambaAdapter } from "./adapter.js";
+export declare const codestralMambaAdapter: ForeignMambaAdapter;
+//# sourceMappingURL=codestral_mamba.d.ts.map

package/dist/import/foreign/codestral_mamba.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codestral_mamba.d.ts","sourceRoot":"","sources":["../../../src/import/foreign/codestral_mamba.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAIH,OAAO,EAML,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AA6FtB,eAAO,MAAM,qBAAqB,EAAE,mBAiEnC,CAAC"}