File size: 7,222 Bytes
dbcfb9e
 
 
 
daef2b2
 
 
 
 
dbcfb9e
 
 
 
 
 
 
daef2b2
dbcfb9e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
daef2b2
 
 
 
 
 
 
 
dbcfb9e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
daef2b2
dbcfb9e
 
 
 
 
 
 
 
 
 
 
 
 
 
daef2b2
 
 
 
 
 
 
dbcfb9e
daef2b2
dbcfb9e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
// SPDX-License-Identifier: MIT OR Apache-2.0
// browseML's worker: bankML's engine runs here, off the page's thread, so the page stays responsive while the
// visitor's CPU reads the prompt and writes the answer.
//
// Threads: on a cross-origin-isolated page (SharedArrayBuffer available) it runs the engine built for
// wasm32-wasip1-threads, with its thread pool on Web Workers (browseml-thread.js) sharing its memory — the pool's
// results do not depend on the thread count, so the answers are the same bits. It tries browseml-mt-relaxed.wasm
// first (relaxed SIMD: one fused multiply-add instruction where the plain build emulates it; about 1.4–1.7× faster),
// which the engine itself refuses where relaxed_madd is not fused; then browseml-mt.wasm. Elsewhere it runs
// browseml.wasm on this one thread.
//
//   page → worker  {type: "open", name, bytes: ArrayBuffer (transferred), fork, threads, ctx}  |  {type: "chat", request}
//   worker → page  {type: "log", level, text} · {type: "opened", rc, out, threads, memory} · {type: "piece", text} ·
//                  {type: "done", rc, out, memory}   (memory: the engine's WebAssembly memory, bytes)
import { wasi } from "./browseml-wasi.js";

let x = null, w = null, memory = null, builtWith = "browseml.wasm", relaxedRefused = false, pool = [];
const dec = new TextDecoder(), enc = new TextEncoder();
const text = (p, n) => dec.decode(new Uint8Array(memory.buffer).slice(p, p + n));
const put = (s) => { const b = enc.encode(s); const p = x.browseml_alloc(b.length); new Uint8Array(memory.buffer, p, b.length).set(b); return [p, b.length]; };
const out = () => text(x.browseml_out_ptr(), x.browseml_out_len());

/** The limits of the module's imported memory (env.memory), read from its import section. */
function importedMemory(bytes) {
  const b = new Uint8Array(bytes);
  let o = 8;
  const leb = () => { let r = 0, s = 0, c; do { c = b[o++]; r += (c & 0x7f) * 2 ** s; s += 7; } while (c & 0x80); return r; };
  const name = () => { const n = leb(); const t = dec.decode(b.subarray(o, o + n)); o += n; return t; };
  while (o < b.length) {
    const id = b[o++], size = leb(), end = o + size;
    if (id !== 2) { o = end; continue; }
    for (let i = 0, n = leb(); i < n; i++) {
      const mod = name(), field = name(), kind = b[o++];
      if (kind === 0) leb();
      else if (kind === 1) { o++; const f = b[o++]; leb(); if (f & 1) leb(); }
      else if (kind === 3) o += 2;
      else if (kind === 2) {
        const f = b[o++], min = leb(), max = f & 1 ? leb() : undefined;
        if (mod === "env" && field === "memory") return { initial: min, maximum: max, shared: !!(f & 2) };
      }
    }
    return null;
  }
  return null;
}

async function open({ name, bytes, fork, threads, ctx }) {
  const files = { [name]: new Uint8Array(bytes) };
  const log = (fd, s) => postMessage({ type: "log", level: fd === 2 ? 1 : 2, text: s.trimEnd() });
  const browseml = {
    piece: (p, n) => { postMessage({ type: "piece", text: text(p, n) }); return 1; },
    log: (level, p, n) => postMessage({ type: "log", level, text: text(p, n) }),
  };
  const mt = threads > 1 && typeof SharedArrayBuffer !== "undefined" && self.crossOriginIsolated;
  let n = 1;
  if (mt) {
    // the fastest build this browser compiles and this machine runs exactly
    let build = "browseml-mt-relaxed.wasm", wasmBytes = null, module = null;
    for (const f of relaxedRefused ? ["browseml-mt.wasm"] : ["browseml-mt-relaxed.wasm", "browseml-mt.wasm"]) {
      try { wasmBytes = await (await fetch(new URL("./" + f, import.meta.url))).arrayBuffer(); module = await WebAssembly.compile(wasmBytes); build = f; break; }
      catch (e) { postMessage({ type: "log", level: 1, text: `${f}: ${e.message || e} — trying the next build` }); }
    }
    if (!module) throw new Error("no threaded build of browseML compiles in this browser");
    builtWith = build;
    const lim = importedMemory(wasmBytes);
    if (!lim || !lim.shared) throw new Error("browseml-mt.wasm does not import a shared memory");
    memory = new WebAssembly.Memory({ initial: lim.initial, maximum: lim.maximum, shared: true });
    n = threads;
    // the pool's workers first, all ready before the engine starts: a waiting thread cannot start a worker
    const idle = await Promise.all(Array.from({ length: n - 1 }, () => new Promise((ok, bad) => {
      const t = new Worker(new URL("./browseml-thread.js", import.meta.url), { type: "module" });
      t.onmessage = (e) => {
        if (e.data.type === "ready") ok(t);
        else if (e.data.type === "log") postMessage(e.data);
        else if (e.data.type === "exit" && e.data.error) postMessage({ type: "log", level: 0, text: `a thread stopped: ${e.data.error}` });
      };
      t.onerror = (e) => bad(new Error(e.message || "a thread could not start"));
      t.postMessage({ type: "init", module, memory });
    })));
    pool = idle.slice();  // every thread of this engine, to end them if it is refused
    let tid = 0;
    w = wasi({ files, env: { BANKML_CACHE_RAM: "0", BANKML_THREADS: String(n) }, write: log });
    ({ exports: x } = await WebAssembly.instantiate(module, {
      ...w.imports, env: { memory }, browseml,
      wasi: { "thread-spawn": (arg) => { const t = idle.shift(); if (!t) return -1; t.postMessage({ type: "start", tid: ++tid, arg }); return tid; } },
    }));
  } else {
    w = wasi({ files, env: { BANKML_CACHE_RAM: "0", BANKML_THREADS: "1" }, write: log });
    const { instance } = await WebAssembly.instantiateStreaming(fetch(new URL("./browseml.wasm", import.meta.url)), { ...w.imports, browseml });
    x = instance.exports;
    memory = x.memory;
  }
  w.bind(memory);
  const rc = x.browseml_open(...put(`/models/${name}`), ...put(fork), ctx || 4096);
  if (rc !== 0 && builtWith === "browseml-mt-relaxed.wasm" && /relaxed_madd is not fused/.test(out())) {
    // this machine's relaxed multiply-add is not fused, so that build would not be exact: start again with the plain one
    postMessage({ type: "log", level: 1, text: "relaxed SIMD is not fused here: using browseml-mt.wasm (exact, slower)" });
    relaxedRefused = true; x = null;
    pool.forEach((t) => t.terminate()); pool = [];  // the refused engine's threads and their memory go with it
    return open({ name, bytes: files[name].buffer, fork, threads, ctx });
  }
  w.release(name);  // the engine holds the model in its own memory now; the downloaded copy can go
  postMessage({ type: "opened", rc, out: out(), threads: n, memory: memory.buffer.byteLength, build: builtWith });
}

onmessage = async (e) => {
  const m = e.data;
  try {
    if (m.type === "open") await open(m);
    else if (m.type === "chat") {
      if (!x) throw new Error("no model is open");
      const [p, len] = put(JSON.stringify(m.request));
      const rc = x.browseml_chat(p, len);
      x.browseml_free(p, len);
      postMessage({ type: "done", rc, out: out(), memory: memory.buffer.byteLength });
    }
  } catch (err) {
    // a trap (out of memory, a panic) ends this engine; the page says so and can load it again
    postMessage({ type: m.type === "open" ? "opened" : "done", rc: -99, out: String(err && err.message || err) });
    x = null;
  }
};