@seanhogg/builderforce-memory-engine 2026.6.31 → 2026.6.34

package/dist/export/gguf.js

@@ -0,0 +1,158 @@
+/**
+ * export/gguf.ts — export weights to a GGUF v3 container (the llama.cpp format).
+ *
+ * Emits a spec-valid GGUF file: magic + version, KV metadata (architecture, dims,
+ * expert counts…), aligned tensor-info table, then aligned tensor data. ggml
+ * stores dimensions innermost-first, so row-major shapes are reversed here.
+ *
+ * NOTE: GGUF is a *container*. llama.cpp can only RUN a file whose
+ * `general.architecture` it has a graph for; "evermind" is custom, so this file
+ * is a valid, inspectable artifact (gguf tooling reads it) but won't execute in
+ * stock llama.cpp until the architecture is upstreamed. It exists so the same
+ * weights can travel through GGUF-native tooling. For an executable export use
+ * {@link ./onnx} or {@link ./safetensors}.
+ */
+import { archOf, namedTensors } from "./tensors.js";
+import { floatToFp16 } from "../utils/quantization.js";
+const GGUF_MAGIC = 0x46554747; // "GGUF" little-endian
+const GGUF_VERSION = 3;
+const ALIGNMENT = 32;
+// GGUF metadata value types
+const T_UINT32 = 4;
+const T_STRING = 8;
+// ggml tensor types
+const GGML_F32 = 0;
+const GGML_F16 = 1;
+/** A growable little-endian byte buffer. */
+class ByteBuf {
+    buf = new Uint8Array(1024);
+    len = 0;
+    ensure(n) {
+        if (this.len + n <= this.buf.length)
+            return;
+        let cap = this.buf.length * 2;
+        while (cap < this.len + n)
+            cap *= 2;
+        const next = new Uint8Array(cap);
+        next.set(this.buf.subarray(0, this.len));
+        this.buf = next;
+    }
+    u32(v) {
+        this.ensure(4);
+        new DataView(this.buf.buffer).setUint32(this.len, v, true);
+        this.len += 4;
+    }
+    u64(v) {
+        this.ensure(8);
+        new DataView(this.buf.buffer).setBigUint64(this.len, BigInt(v), true);
+        this.len += 8;
+    }
+    raw(bytes) {
+        this.ensure(bytes.length);
+        this.buf.set(bytes, this.len);
+        this.len += bytes.length;
+    }
+    /** Pad with zeros until the length is a multiple of `align`. */
+    alignTo(align) {
+        const pad = (align - (this.len % align)) % align;
+        if (pad > 0) {
+            this.ensure(pad);
+            this.len += pad;
+        }
+    }
+    string(s) {
+        const bytes = new TextEncoder().encode(s);
+        this.u64(bytes.length);
+        this.raw(bytes);
+    }
+    get length() {
+        return this.len;
+    }
+    bytes() {
+        return this.buf.subarray(0, this.len);
+    }
+}
+function tensorBytes(data, fp16) {
+    if (!fp16) {
+        const out = new Uint8Array(data.length * 4);
+        const dv = new DataView(out.buffer);
+        for (let i = 0; i < data.length; i++)
+            dv.setFloat32(i * 4, data[i], true);
+        return out;
+    }
+    const out = new Uint8Array(data.length * 2);
+    const dv = new DataView(out.buffer);
+    for (let i = 0; i < data.length; i++)
+        dv.setUint16(i * 2, floatToFp16(data[i]), true);
+    return out;
+}
+/** Export a trained LM to GGUF bytes. */
+export function exportGguf(lm, opts = {}) {
+    const fp16 = opts.fp16 ?? false;
+    const a = archOf(lm);
+    const tensors = namedTensors(lm);
+    const ggmlType = fp16 ? GGML_F16 : GGML_F32;
+    const bytesPer = fp16 ? 2 : 4;
+    const kvU32 = [
+        ["evermind.vocab_size", a.vocabSize],
+        ["evermind.embedding_length", a.dModel],
+        ["evermind.block_count", a.numLayers],
+        ["evermind.conv_kernel", a.convKernel],
+        ["evermind.feed_forward_length", a.hiddenDim],
+        ["evermind.expert_count", a.numExperts],
+        ["evermind.expert_used_count", a.topK],
+        ["general.alignment", ALIGNMENT],
+    ];
+    const kvStr = [
+        ["general.architecture", "evermind"],
+        ["general.name", opts.name ?? "Evermind"],
+    ];
+    // Header: magic, version, tensor_count, metadata_kv_count, KVs.
+    const head = new ByteBuf();
+    head.u32(GGUF_MAGIC);
+    head.u32(GGUF_VERSION);
+    head.u64(tensors.length);
+    head.u64(kvU32.length + kvStr.length);
+    for (const [k, v] of kvStr) {
+        head.string(k);
+        head.u32(T_STRING);
+        head.string(v);
+    }
+    for (const [k, v] of kvU32) {
+        head.string(k);
+        head.u32(T_UINT32);
+        head.u32(v);
+    }
+    // Tensor-info table. Offsets are relative to the start of the (aligned) tensor
+    // data section; each tensor starts at an ALIGNMENT boundary within it.
+    const dims = (t) => [...t.shape].reverse(); // ggml: innermost first
+    let dataOffset = 0;
+    const offsets = [];
+    for (const t of tensors) {
+        offsets.push(dataOffset);
+        const nbytes = t.data.length * bytesPer;
+        dataOffset += nbytes;
+        dataOffset += (ALIGNMENT - (dataOffset % ALIGNMENT)) % ALIGNMENT;
+    }
+    tensors.forEach((t, i) => {
+        head.string(t.name);
+        const d = dims(t);
+        head.u32(d.length);
+        for (const dim of d)
+            head.u64(dim);
+        head.u32(ggmlType);
+        head.u64(offsets[i]);
+    });
+    // Pad header to the alignment boundary, then write aligned tensor data.
+    head.alignTo(ALIGNMENT);
+    const dataStart = head.length;
+    for (let i = 0; i < tensors.length; i++) {
+        // Re-establish alignment relative to the data section start.
+        const want = dataStart + offsets[i];
+        while (head.length < want)
+            head.raw(new Uint8Array(1));
+        head.raw(tensorBytes(tensors[i].data, fp16));
+    }
+    return head.bytes();
+}
+//# sourceMappingURL=gguf.js.map

package/dist/export/gguf.js.map

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

package/dist/export/hf.d.ts

@@ -0,0 +1,32 @@
+/**
+ * export/hf.ts — the Hugging Face repository sidecar files.
+ *
+ * The JSON/markdown that turns raw weights into an ingestible HF model repo:
+ *   • config.json            — architecture config (model_type "evermind")
+ *   • generation_config.json — default decoding params
+ *   • tokenizer.json         — the byte-level BPE in HF `tokenizers` format
+ *   • README.md              — the model card (YAML front-matter + body)
+ *
+ * The tokenizer uses the same GPT-2 byte→unicode alphabet as {@link BPETokenizer}
+ * (a ByteLevel pre-tokenizer/decoder), so HF `tokenizers` / transformers.js
+ * reproduce our encode/decode.
+ */
+import type { EvermindLM } from "../lm/evermind_lm.js";
+import type { BPETokenizer } from "../tokenizer/bpe.js";
+export interface HfMeta {
+    name?: string;
+    version?: string;
+    license?: string;
+    author?: string;
+    description?: string;
+    tags?: string[];
+}
+/** HF `config.json` describing the Evermind architecture. */
+export declare function configJson(lm: EvermindLM): Record<string, unknown>;
+/** HF `generation_config.json` — greedy by default, matching the reference. */
+export declare function generationConfigJson(): Record<string, unknown>;
+/** HF `tokenizer.json` (the `tokenizers` fast-tokenizer format) for the BPE. */
+export declare function tokenizerJson(tok: BPETokenizer): Record<string, unknown>;
+/** HF model card (`README.md`) with YAML front-matter. */
+export declare function modelCardMarkdown(lm: EvermindLM, meta?: HfMeta): string;
+//# sourceMappingURL=hf.d.ts.map

package/dist/export/hf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf.d.ts","sourceRoot":"","sources":["../../src/export/hf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBlE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCxE;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAyD3E"}

package/dist/export/hf.js

@@ -0,0 +1,138 @@
+/**
+ * export/hf.ts — the Hugging Face repository sidecar files.
+ *
+ * The JSON/markdown that turns raw weights into an ingestible HF model repo:
+ *   • config.json            — architecture config (model_type "evermind")
+ *   • generation_config.json — default decoding params
+ *   • tokenizer.json         — the byte-level BPE in HF `tokenizers` format
+ *   • README.md              — the model card (YAML front-matter + body)
+ *
+ * The tokenizer uses the same GPT-2 byte→unicode alphabet as {@link BPETokenizer}
+ * (a ByteLevel pre-tokenizer/decoder), so HF `tokenizers` / transformers.js
+ * reproduce our encode/decode.
+ */
+import { archOf, paramCount } from "./tensors.js";
+/** HF `config.json` describing the Evermind architecture. */
+export function configJson(lm) {
+    const a = archOf(lm);
+    return {
+        model_type: "evermind",
+        architectures: ["EvermindForCausalLM"],
+        vocab_size: a.vocabSize,
+        d_model: a.dModel,
+        hidden_size: a.dModel,
+        num_hidden_layers: a.numLayers,
+        conv_kernel: a.convKernel,
+        intermediate_size: a.hiddenDim,
+        num_experts: a.numExperts,
+        num_experts_per_tok: a.topK,
+        rms_norm_eps: 1e-5,
+        tie_word_embeddings: true,
+        torch_dtype: "float32",
+        transformers_version: "4.0.0",
+    };
+}
+/** HF `generation_config.json` — greedy by default, matching the reference. */
+export function generationConfigJson() {
+    return { do_sample: false, temperature: 1.0, max_new_tokens: 64 };
+}
+/** HF `tokenizer.json` (the `tokenizers` fast-tokenizer format) for the BPE. */
+export function tokenizerJson(tok) {
+    const vocab = {};
+    for (const [token, id] of tok.vocab)
+        vocab[token] = id;
+    const merges = [...tok.merges.keys()]; // already "a b" space-separated pairs
+    const added = [];
+    for (const content of [tok.unkToken, tok.bosToken, tok.eosToken, tok.padToken]) {
+        const id = tok.vocab.get(content);
+        if (id !== undefined && !added.some((t) => t.id === id))
+            added.push({ id, content });
+    }
+    return {
+        version: "1.0",
+        truncation: null,
+        padding: null,
+        added_tokens: added.map((t) => ({
+            id: t.id,
+            content: t.content,
+            single_word: false,
+            lstrip: false,
+            rstrip: false,
+            normalized: false,
+            special: true,
+        })),
+        normalizer: null,
+        pre_tokenizer: { type: "ByteLevel", add_prefix_space: false, trim_offsets: true, use_regex: true },
+        post_processor: { type: "ByteLevel", add_prefix_space: true, trim_offsets: false, use_regex: true },
+        decoder: { type: "ByteLevel", add_prefix_space: true, trim_offsets: true, use_regex: true },
+        model: {
+            type: "BPE",
+            dropout: null,
+            unk_token: null,
+            continuing_subword_prefix: null,
+            end_of_word_suffix: null,
+            fuse_unk: false,
+            byte_fallback: false,
+            vocab,
+            merges,
+        },
+    };
+}
+/** HF model card (`README.md`) with YAML front-matter. */
+export function modelCardMarkdown(lm, meta = {}) {
+    const a = archOf(lm);
+    const params = paramCount(lm);
+    const name = meta.name ?? "Evermind";
+    const license = meta.license ?? "mit";
+    const tags = ["evermind", "ssm", "mixture-of-experts", "text-generation", ...(meta.tags ?? [])];
+    const front = [
+        "---",
+        `license: ${license}`,
+        "library_name: builderforce-memory",
+        "pipeline_tag: text-generation",
+        "tags:",
+        ...tags.map((t) => `  - ${t}`),
+        "---",
+    ].join("\n");
+    const body = `
+# ${name}
+
+${meta.description ?? "A self-updating SSM language model built with the BuilderForce Evermind engine."}
+
+An **Evermind** model: a shared-expert hybrid SSM (depthwise causal conv token-mixer
++ top-k Mixture-of-Experts channel-mixer, tied embeddings). Trained and run natively
+in TypeScript/WebGPU; this repository is an export for the Hugging Face ecosystem.
+
+## Architecture
+
+| field | value |
+| --- | --- |
+| vocab size | ${a.vocabSize} |
+| d_model | ${a.dModel} |
+| layers | ${a.numLayers} |
+| conv kernel | ${a.convKernel} |
+| FFN hidden | ${a.hiddenDim} |
+| experts (top-k) | ${a.numExperts} (${a.topK}) |
+| parameters | ${params.toLocaleString("en-US")} |
+
+## Files
+
+- \`model.safetensors\` — weights (HF-native, F32).
+- \`model.onnx\` — runnable graph (\`input_ids\` → \`logits\`); load with onnxruntime / transformers.js.
+- \`config.json\`, \`generation_config.json\`, \`tokenizer.json\` — HF sidecars.
+- \`model.gguf\` — GGUF container (custom architecture; for GGUF tooling).
+- \`model.evermind\` — the native package; runs in \`@seanhogg/builderforce-memory\` (full self-update).
+
+## Usage (ONNX, no KV-cache — re-run full context per step)
+
+\`\`\`js
+import * as ort from "onnxruntime-web";
+const session = await ort.InferenceSession.create("model.onnx");
+const ids = BigInt64Array.from([/* token ids */].map(BigInt));
+const input_ids = new ort.Tensor("int64", ids, [1, ids.length]);
+const { logits } = await session.run({ input_ids });
+\`\`\`
+${meta.author ? `\n## Author\n\n${meta.author}\n` : ""}`;
+    return `${front}\n${body}`;
+}
+//# sourceMappingURL=hf.js.map

package/dist/export/hf.js.map

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

package/dist/export/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * export/index.ts — the model-export registry.
+ *
+ * One entry point — {@link exportEvermind} — turns a trained {@link EvermindLM}
+ * (+ its tokenizer) into a named set of files in a requested format. The runtime
+ * is untouched: export reads the model through its public surface only. This is
+ * the *publishing* seam — training/serving stay in the WebGPU/TS runtime; export
+ * is offered as a separate step that emits portable artifacts (ONNX, safetensors,
+ * GGUF) and a complete Hugging Face repo bundle.
+ *
+ * Formats:
+ *   • "safetensors"  → model.safetensors
+ *   • "onnx"         → model.onnx
+ *   • "gguf"         → model.gguf
+ *   • "huggingface"  → a full HF repo (safetensors + onnx + gguf + config +
+ *                      tokenizer.json + generation_config + README), ready to push
+ */
+import type { EvermindLM } from "../lm/evermind_lm.js";
+import type { BPETokenizer } from "../tokenizer/bpe.js";
+import { type HfMeta } from "./hf.js";
+export type ExportFormat = "safetensors" | "onnx" | "gguf" | "huggingface";
+/** One emitted file. `data` is bytes (binary) or a string (text). */
+export interface ExportFile {
+    path: string;
+    data: Uint8Array | string;
+    contentType: string;
+}
+export interface ExportResult {
+    format: ExportFormat;
+    files: ExportFile[];
+    /** Total trainable scalar parameters of the exported model. */
+    paramCount: number;
+}
+export interface ExportOptions extends HfMeta {
+    /** Store weights as float16 where the format supports it. Default false. */
+    fp16?: boolean;
+}
+/** Catalog of formats for UI pickers (id + human label + extension). */
+export declare const EXPORT_FORMATS: {
+    id: ExportFormat;
+    label: string;
+    description: string;
+    ext: string;
+}[];
+/**
+ * Export a trained model in the requested format. `tokenizer` is required for the
+ * "huggingface" bundle (to emit tokenizer.json); the weight-only formats ignore it.
+ */
+export declare function exportEvermind(lm: EvermindLM, format: ExportFormat, opts?: ExportOptions, tokenizer?: BPETokenizer): ExportResult;
+export { exportSafetensors, tensorsToSafetensors } from "./safetensors.js";
+export { exportOnnx } from "./onnx.js";
+export { exportGguf } from "./gguf.js";
+export { configJson, generationConfigJson, tokenizerJson, modelCardMarkdown } from "./hf.js";
+export type { HfMeta } from "./hf.js";
+export { namedTensors, evermindTensorSpec, archOf, paramCount } from "./tensors.js";
+export type { NamedTensor, EvermindArch, TensorSpec } from "./tensors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAsE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE1G,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3E,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC3C,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAKjG,CAAC;AAQF;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,UAAU,EACd,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,aAAkB,EACxB,SAAS,CAAC,EAAE,YAAY,GACvB,YAAY,CAiDd;AAED,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/export/index.js

@@ -0,0 +1,85 @@
+/**
+ * export/index.ts — the model-export registry.
+ *
+ * One entry point — {@link exportEvermind} — turns a trained {@link EvermindLM}
+ * (+ its tokenizer) into a named set of files in a requested format. The runtime
+ * is untouched: export reads the model through its public surface only. This is
+ * the *publishing* seam — training/serving stay in the WebGPU/TS runtime; export
+ * is offered as a separate step that emits portable artifacts (ONNX, safetensors,
+ * GGUF) and a complete Hugging Face repo bundle.
+ *
+ * Formats:
+ *   • "safetensors"  → model.safetensors
+ *   • "onnx"         → model.onnx
+ *   • "gguf"         → model.gguf
+ *   • "huggingface"  → a full HF repo (safetensors + onnx + gguf + config +
+ *                      tokenizer.json + generation_config + README), ready to push
+ */
+import { paramCount } from "./tensors.js";
+import { exportSafetensors } from "./safetensors.js";
+import { exportOnnx } from "./onnx.js";
+import { exportGguf } from "./gguf.js";
+import { configJson, generationConfigJson, tokenizerJson, modelCardMarkdown } from "./hf.js";
+/** Catalog of formats for UI pickers (id + human label + extension). */
+export const EXPORT_FORMATS = [
+    { id: "huggingface", label: "Hugging Face repo", description: "Full publishable repo: safetensors + ONNX + GGUF + config + tokenizer + model card", ext: "/" },
+    { id: "onnx", label: "ONNX", description: "Runnable graph for onnxruntime / transformers.js (input_ids → logits)", ext: ".onnx" },
+    { id: "safetensors", label: "Safetensors", description: "HF-native weight format (lossless F32 / half-size F16)", ext: ".safetensors" },
+    { id: "gguf", label: "GGUF", description: "llama.cpp container (custom architecture; for GGUF tooling)", ext: ".gguf" },
+];
+const JSON_CT = "application/json";
+function jsonFile(path, obj) {
+    return { path, data: JSON.stringify(obj, null, 2), contentType: JSON_CT };
+}
+/**
+ * Export a trained model in the requested format. `tokenizer` is required for the
+ * "huggingface" bundle (to emit tokenizer.json); the weight-only formats ignore it.
+ */
+export function exportEvermind(lm, format, opts = {}, tokenizer) {
+    const params = paramCount(lm);
+    const base = () => ({ format, files: [], paramCount: params });
+    switch (format) {
+        case "safetensors": {
+            const r = base();
+            r.files.push({
+                path: "model.safetensors",
+                data: exportSafetensors(lm, { fp16: opts.fp16 }),
+                contentType: "application/octet-stream",
+            });
+            return r;
+        }
+        case "onnx": {
+            const r = base();
+            r.files.push({
+                path: "model.onnx",
+                data: exportOnnx(lm, { producerVersion: opts.version }),
+                contentType: "application/octet-stream",
+            });
+            return r;
+        }
+        case "gguf": {
+            const r = base();
+            r.files.push({
+                path: "model.gguf",
+                data: exportGguf(lm, { name: opts.name, fp16: opts.fp16 }),
+                contentType: "application/octet-stream",
+            });
+            return r;
+        }
+        case "huggingface": {
+            if (!tokenizer)
+                throw new Error("exportEvermind('huggingface'): a tokenizer is required for tokenizer.json");
+            const r = base();
+            r.files.push({ path: "model.safetensors", data: exportSafetensors(lm, { fp16: opts.fp16 }), contentType: "application/octet-stream" }, { path: "model.onnx", data: exportOnnx(lm, { producerVersion: opts.version }), contentType: "application/octet-stream" }, { path: "model.gguf", data: exportGguf(lm, { name: opts.name, fp16: opts.fp16 }), contentType: "application/octet-stream" }, jsonFile("config.json", configJson(lm)), jsonFile("generation_config.json", generationConfigJson()), jsonFile("tokenizer.json", tokenizerJson(tokenizer)), { path: "README.md", data: modelCardMarkdown(lm, opts), contentType: "text/markdown" });
+            return r;
+        }
+        default:
+            throw new Error(`exportEvermind: unknown format "${String(format)}"`);
+    }
+}
+export { exportSafetensors, tensorsToSafetensors } from "./safetensors.js";
+export { exportOnnx } from "./onnx.js";
+export { exportGguf } from "./gguf.js";
+export { configJson, generationConfigJson, tokenizerJson, modelCardMarkdown } from "./hf.js";
+export { namedTensors, evermindTensorSpec, archOf, paramCount } from "./tensors.js";
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

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

package/dist/export/onnx.d.ts

@@ -0,0 +1,32 @@
+/**
+ * export/onnx.ts — export a trained {@link EvermindLM} to a runnable ONNX graph.
+ *
+ * Produces a standard causal-LM ONNX `ModelProto`:  input `input_ids` [batch,seq]
+ * (int64) → output `logits` [batch,seq,vocab] (float). No KV cache — the model is
+ * stateless and recomputes the full context each step, so a host (onnxruntime-web,
+ * onnxruntime-node, or transformers.js driving the generation loop) re-runs the
+ * whole sequence per token. The graph reproduces the CPU reference forward
+ * EXACTLY:
+ *
+ *   • embedding  → Gather(emb, input_ids)
+ *   • RMSNorm    → Mul/ReduceMean/Add/Sqrt/Div/Mul (eps = 1e-5)
+ *   • causal     → Transpose → Conv(group=D, pads=[K-1,0], kernel reversed) → Transpose
+ *     depthwise conv (so out[t] = Σⱼ ker[j]·x[t−j], matching the reference tap order)
+ *   • MoE        → router MatMul → TopK → Softmax → ScatterElements (dense top-k mask)
+ *                  → shared FFN + Σₑ combineₑ · expertₑ(x)   (numerically identical to
+ *                  the sparse reference: non-selected experts get combine 0)
+ *   • tied head  → MatMul(x, embᵀ)
+ *
+ * Opset 18 / IR v8. Weights are emitted as raw little-endian f32 initializers that
+ * are byte-identical to {@link namedTensors} (matmul weights are transposed by a
+ * graph node at runtime, not duplicated on disk).
+ *
+ * Zero dependencies — the protobuf is hand-encoded by {@link ./protobuf}.
+ */
+import type { EvermindLM } from "../lm/evermind_lm.js";
+/** Build the ONNX bytes for a trained LM. */
+export declare function exportOnnx(lm: EvermindLM, opts?: {
+    producerName?: string;
+    producerVersion?: string;
+}): Uint8Array;
+//# sourceMappingURL=onnx.d.ts.map

package/dist/export/onnx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onnx.d.ts","sourceRoot":"","sources":["../../src/export/onnx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAwGvD,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAsGrH"}