@mailwoman/neural-web 0.1.0

package/README.md

@@ -0,0 +1,66 @@
+# @mailwoman/neural-web
+
+Browser-side mailwoman neural runtime — drop-in for [`@mailwoman/neural`](https://www.npmjs.com/package/@mailwoman/neural) when targeting a static-asset deploy. Pairs the existing SentencePiece tokenizer + BIO decoder with an [`onnxruntime-web`](https://www.npmjs.com/package/onnxruntime-web) inference path (WebGPU primary, WASM SIMD fallback).
+
+Path B of the demo plan — see [sister-software/mailwoman#98](https://github.com/sister-software/mailwoman/issues/98).
+
+## Status
+
+**v0.1.0 — scaffold + end-to-end smoke test.** `WebOnnxRunner` implements the `NeuralRunner` interface and is composable into `NeuralAddressClassifier` exactly like `OnnxRunner` from `@mailwoman/neural`. Test suite runs the real `@mailwoman/neural-weights-en-us` model through the WASM execution provider in Node — WebGPU is the production-time fast path but isn't testable in Node.
+
+## Quick start
+
+```ts
+import { loadNeuralClassifierFromUrls } from "@mailwoman/neural-web"
+
+const classifier = await loadNeuralClassifierFromUrls({
+	modelUrl: "/static/mailwoman/model.onnx",
+	tokenizerUrl: "/static/mailwoman/tokenizer.model",
+	runner: {
+		// Optional. If your bundler doesn't put ort .wasm files in the default location,
+		// point this at where you serve them.
+		wasmPathsRoot: "/static/ort/",
+	},
+})
+
+const tree = await classifier.parse("123 Main St, Springfield, IL 62704")
+console.log(tree.roots)
+```
+
+For lower-level control, use `WebOnnxRunner` directly:
+
+```ts
+import { WebOnnxRunner, MailwomanTokenizer, NeuralAddressClassifier } from "@mailwoman/neural-web"
+
+const runner = await WebOnnxRunner.fromUrl("/static/mailwoman/model.onnx", { useWebGpu: true })
+const tokenizer = await MailwomanTokenizer.loadFromBase64(/* base64 of tokenizer.model */)
+const classifier = new NeuralAddressClassifier({ tokenizer, runner })
+```
+
+## Execution provider strategy
+
+`WebOnnxRunner` attempts WebGPU first (10× faster than WASM on supported devices — Chromium 113+, Safari Tech Preview, hardware-dependent). If the WebGPU probe fails (no adapter, browser doesn't expose it, etc.), it transparently falls back to the WASM execution provider. Set `useWebGpu: false` to skip the probe entirely — useful in test environments where the failure path adds latency.
+
+## Bundling
+
+This package ships compiled TypeScript only. The `onnxruntime-web` runtime ships its own `.wasm` assets — your bundler needs to serve them. The package's defaults point at a CDN; production deploys typically self-host:
+
+```ts
+import { loadNeuralClassifierFromUrls } from "@mailwoman/neural-web"
+
+// Copy node_modules/onnxruntime-web/dist/*.wasm into your /public dir during build,
+// then point the runner at them:
+const classifier = await loadNeuralClassifierFromUrls({
+	modelUrl: "/static/mailwoman/model.onnx",
+	tokenizerUrl: "/static/mailwoman/tokenizer.model",
+	runner: { wasmPathsRoot: "/ort-wasm/" },
+})
+```
+
+## Why not extend `@mailwoman/neural` directly?
+
+`@mailwoman/neural` depends on `onnxruntime-node`, which ships native binaries and breaks in a browser bundle. The classifier surface itself is runtime-agnostic — it only needs a `NeuralRunner` (a structural interface with `infer(ids): Promise<InferResult>`). Splitting the runner lets both implementations co-exist without forcing browser bundlers to dead-code-eliminate native code.
+
+## License
+
+AGPL-3.0-only.

package/out/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export { defaultGazetteerLexiconUrl, loadNeuralClassifierFromUrls, type LoadFromUrlsOpts } from "./loader.js";
+export { DEFAULT_FIXED_SEQ_LEN, WebOnnxRunner, type WebOnnxRunnerOpts } from "./web-onnx-runner.js";
+export { MailwomanTokenizer, NeuralAddressClassifier, type NeuralAddressClassifierConfig, type NeuralRunner, } from "@mailwoman/neural/browser";
+export type { InferResult } from "@mailwoman/neural/browser";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7G,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAKnG,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,KAAK,YAAY,GACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA"}

package/out/index.js

@@ -0,0 +1,12 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export { defaultGazetteerLexiconUrl, loadNeuralClassifierFromUrls } from "./loader.js";
+export { DEFAULT_FIXED_SEQ_LEN, WebOnnxRunner } from "./web-onnx-runner.js";
+// Re-export the public neural surface so callers don't need both packages on the typed path.
+// Pull from the browser-safe entry — the default entry would drag onnxruntime-node + node:fs
+// into the bundle graph via classifier.ts's transitive imports.
+export { MailwomanTokenizer, NeuralAddressClassifier, } from "@mailwoman/neural/browser";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAyB,MAAM,aAAa,CAAA;AAC7G,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAA;AAEnG,6FAA6F;AAC7F,6FAA6F;AAC7F,gEAAgE;AAChE,OAAO,EACN,kBAAkB,EAClB,uBAAuB,GAGvB,MAAM,2BAA2B,CAAA"}

package/out/loader.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Browser-side loader that pairs the existing `MailwomanTokenizer` (whose `loadFromBase64` path is
+ *   already browser-safe — it doesn't touch Node fs) with a fresh `WebOnnxRunner`, and returns a
+ *   ready-to-use `NeuralAddressClassifier`.
+ *
+ *   V1 strategy: fetch both `model.onnx` and `tokenizer.model` over HTTP from caller-provided URLs
+ *   (typically pointing at the same static-asset bundle that ships the resolver's slim WOF DB). The
+ *   neural weights package `@mailwoman/neural-weights-en-us` is the canonical source of those two
+ *   files; for a static deploy, copy them into the public bundle and pass the resulting URLs.
+ */
+import { NeuralAddressClassifier, type NeuralAddressClassifierConfig } from "@mailwoman/neural/browser";
+import { type WebOnnxRunnerDiagnostics, type WebOnnxRunnerOpts } from "./web-onnx-runner.js";
+export type { WebOnnxRunnerDiagnostics };
+export interface LoadResult {
+    classifier: NeuralAddressClassifier;
+    diagnostics: WebOnnxRunnerDiagnostics | null;
+    /**
+     * Labels actually applied to the classifier. `null` when no model-card was provided or its
+     * `labels` field was missing — the classifier fell back to its built-in default (Stage 2).
+     */
+    labels: readonly string[] | null;
+    /**
+     * The parsed postcode-anchor lookup (postcode → posterior + centroid), when anchor binaries were
+     * loaded. Exposed so consumers (the demo's anchor-centroid map fallback) can reuse the SAME
+     * artifact the model channel feeds from — WOF ships placeholder (0,0) for ~22% of US postcodes;
+     * this lookup has a real centroid for every covered ZIP.
+     */
+    postcodeAnchorLookup?: import("@mailwoman/neural").AnchorLookup;
+}
+export interface LoadFromUrlsOpts {
+    /** URL to the ONNX model file (e.g. `/static/mailwoman/model.onnx`). */
+    modelUrl: string;
+    /** URL to the SentencePiece tokenizer model (e.g. `/static/mailwoman/tokenizer.model`). */
+    tokenizerUrl: string;
+    /**
+     * URL to `model-card.json`. When provided, its `labels` field is threaded into the classifier so
+     * post-Stage-2 bundles (33-label Stage 3 and beyond) decode correctly. Skip for legacy bundles
+     * whose cards predate the `labels` field — the loader falls back to the built-in Stage 2
+     * default.
+     *
+     * Required for any v0.6.x+ bundle: without it the classifier builds a 21×21 transition mask while
+     * the model emits 33 logits and viterbi crashes with "Cannot read properties of undefined".
+     */
+    modelCardUrl?: string;
+    /** Runner options (WebGPU toggle, fixed sequence length, WASM path override). */
+    runner?: WebOnnxRunnerOpts;
+    /**
+     * URLs to one or more PCB1 postcode binaries (`postcode-<cc>.bin`). For anchor-trained models
+     * (#239/#240) these are decoded + merged into the postcode→anchor lookup the classifier feeds at
+     * inference, so the demo runs the model with the anchor on. Pass the locales the model handles
+     * (e.g. US + DE). Omit for plain models — the runner then feeds the anchor-off identity.
+     */
+    postcodeBinaryUrls?: readonly string[];
+    /**
+     * URL to the gazetteer-anchor lexicon JSON (`anchor-lexicon-v1.json`, #464 — the in-repo source
+     * is `data/gazetteer/anchor-lexicon-v1.json`). Gazetteer-trained models (v4.2.0+, whose ONNX
+     * declares the `gazetteer_features`/`gazetteer_confidence` inputs) REQUIRE this clue at
+     * inference: running them on the zero-filled fallback is the measured train/inference mismatch
+     * that wrecks segmentation ("the zero-fill trap", CONTRIBUTING_MODEL_WORK.mdx eval invariants).
+     *
+     * Defaults to `anchor-lexicon-v1.json` next to `modelUrl`. A fetch miss (404 etc.) does NOT throw
+     * — older bundles never shipped the file — but if the loaded model turns out to be
+     * gazetteer-trained the loader logs a loud `console.error` naming the missing file and the model
+     * runs gazetteer-off (structurally valid, quality-degraded). Pass `null` to skip the fetch
+     * entirely.
+     */
+    gazetteerLexiconUrl?: string | null;
+    /**
+     * Channel choreography (#464, v0.9.13 postcode fix): zero the gazetteer clue on pieces adjacent
+     * to a postcode-anchor hit. Defaults to TRUE — it pairs with the train-time half on every
+     * gazetteer-trained bundle (v4.2.0+) and is inert when either channel is absent.
+     */
+    suppressGazetteerNearPostcode?: boolean;
+    /**
+     * Address-system conventions mode (#511 Tier A, v4.3.0+). Defaults to `"auto"` (read the model's
+     * locale head when exported; inert on bundles without `locale_logits`). Pass a `SystemCode` to
+     * pin, or `null` to disable.
+     */
+    addressSystemConventions?: NeuralAddressClassifierConfig["addressSystemConventions"] | null;
+    /**
+     * Span bridge (v4.4.0 declared behavior): merge same-tag spans split at intra-token punctuation
+     * ("P.O. Box"). Defaults to TRUE per the v4.4.0 ship config (model-card.json: po_box 60.4
+     * without, 89.1 with). Pass false to disable for pre-bridge bundles where gate parity matters.
+     */
+    bridgePunctuationGaps?: boolean;
+    /** Optional fetch override. Defaults to `globalThis.fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Default location of the gazetteer-anchor lexicon: `anchor-lexicon-v1.json` as a sibling of the
+ * model file. Matches how release bundles lay out their version directory (model.onnx,
+ * tokenizer.model, model-card.json, postcode-*.bin, anchor-lexicon-v1.json side by side).
+ */
+export declare function defaultGazetteerLexiconUrl(modelUrl: string): string;
+/**
+ * Convenience factory: fetch model + tokenizer, build the runner, return a classifier. The
+ * tokenizer is loaded via the existing `loadFromBase64` path so this file shares zero Node-only
+ * code with `@mailwoman/neural/classifier`'s `loadFromWeights`.
+ *
+ * The classifier is constructed with the v4.4.0 ship config by default (gazetteer lexicon +
+ * postcode anchor when their assets resolve, `suppressGazetteerNearPostcode: true`,
+ * `addressSystemConventions: "auto"`, `bridgePunctuationGaps: true`) — every knob is inert on
+ * bundles that predate the corresponding channel, so older versions keep decoding unchanged.
+ */
+export declare function loadNeuralClassifierFromUrls(opts: LoadFromUrlsOpts): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/out/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIN,uBAAuB,EACvB,KAAK,6BAA6B,EAGlC,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAiB,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE3G,YAAY,EAAE,wBAAwB,EAAE,CAAA;AAExC,MAAM,WAAW,UAAU;IAC1B,UAAU,EAAE,uBAAuB,CAAA;IACnC,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC5C;;;OAGG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,mBAAmB,EAAE,YAAY,CAAA;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAChC,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;;;OAIG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAA;IACvC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,6BAA6B,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAA;IAC3F;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACxB;AA6BD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8C9F"}

package/out/loader.js

@@ -0,0 +1,199 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Browser-side loader that pairs the existing `MailwomanTokenizer` (whose `loadFromBase64` path is
+ *   already browser-safe — it doesn't touch Node fs) with a fresh `WebOnnxRunner`, and returns a
+ *   ready-to-use `NeuralAddressClassifier`.
+ *
+ *   V1 strategy: fetch both `model.onnx` and `tokenizer.model` over HTTP from caller-provided URLs
+ *   (typically pointing at the same static-asset bundle that ships the resolver's slim WOF DB). The
+ *   neural weights package `@mailwoman/neural-weights-en-us` is the canonical source of those two
+ *   files; for a static deploy, copy them into the public bundle and pass the resulting URLs.
+ */
+import { MailwomanTokenizer, NeuralAddressClassifier, parseGazetteerLexicon, PostcodeBinaryResolver, } from "@mailwoman/neural/browser";
+import { WebOnnxRunner } from "./web-onnx-runner.js";
+/** Merge per-binary anchor lookups: union the country posteriors per postcode, mean the centroids. */
+function mergeAnchorLookups(lookups) {
+    if (lookups.length === 1)
+        return lookups[0];
+    const merged = new Map();
+    for (const lookup of lookups) {
+        for (const [postcode, entry] of lookup) {
+            const existing = merged.get(postcode);
+            if (!existing) {
+                merged.set(postcode, { posterior: { ...entry.posterior }, lat: entry.lat, lon: entry.lon });
+                continue;
+            }
+            for (const country of Object.keys(entry.posterior))
+                existing.posterior[country] = 1;
+            // Average a real centroid in; ignore (0,0) placeholders.
+            if (entry.lat !== 0 || entry.lon !== 0) {
+                if (existing.lat === 0 && existing.lon === 0) {
+                    existing.lat = entry.lat;
+                    existing.lon = entry.lon;
+                }
+                else {
+                    existing.lat = (existing.lat + entry.lat) / 2;
+                    existing.lon = (existing.lon + entry.lon) / 2;
+                }
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Default location of the gazetteer-anchor lexicon: `anchor-lexicon-v1.json` as a sibling of the
+ * model file. Matches how release bundles lay out their version directory (model.onnx,
+ * tokenizer.model, model-card.json, postcode-*.bin, anchor-lexicon-v1.json side by side).
+ */
+export function defaultGazetteerLexiconUrl(modelUrl) {
+    // Swap the final path segment — string surgery rather than `new URL()` so relative model URLs
+    // ("/static/mailwoman/model.onnx") stay relative.
+    return modelUrl.replace(/[^/]*$/, "anchor-lexicon-v1.json");
+}
+/**
+ * Convenience factory: fetch model + tokenizer, build the runner, return a classifier. The
+ * tokenizer is loaded via the existing `loadFromBase64` path so this file shares zero Node-only
+ * code with `@mailwoman/neural/classifier`'s `loadFromWeights`.
+ *
+ * The classifier is constructed with the v4.4.0 ship config by default (gazetteer lexicon +
+ * postcode anchor when their assets resolve, `suppressGazetteerNearPostcode: true`,
+ * `addressSystemConventions: "auto"`, `bridgePunctuationGaps: true`) — every knob is inert on
+ * bundles that predate the corresponding channel, so older versions keep decoding unchanged.
+ */
+export async function loadNeuralClassifierFromUrls(opts) {
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error("no fetch implementation available — pass fetchImpl in non-fetch environments");
+    }
+    const gazetteerLexiconUrl = opts.gazetteerLexiconUrl === null ? null : (opts.gazetteerLexiconUrl ?? defaultGazetteerLexiconUrl(opts.modelUrl));
+    const [modelBytes, tokenizerBytes, labels, gazetteerLexicon] = await Promise.all([
+        fetchBytes(opts.modelUrl, fetchImpl),
+        fetchBytes(opts.tokenizerUrl, fetchImpl),
+        opts.modelCardUrl ? fetchLabelsFromModelCard(opts.modelCardUrl, fetchImpl) : Promise.resolve(null),
+        gazetteerLexiconUrl ? fetchGazetteerLexicon(gazetteerLexiconUrl, fetchImpl) : Promise.resolve(null),
+    ]);
+    const [tokenizer, runner, postcodeAnchorLookup] = await Promise.all([
+        MailwomanTokenizer.loadFromBase64(toBase64(tokenizerBytes)),
+        WebOnnxRunner.fromBytes(modelBytes, opts.runner),
+        opts.postcodeBinaryUrls?.length
+            ? Promise.all(opts.postcodeBinaryUrls.map(async (url) => new PostcodeBinaryResolver(await fetchBytes(url, fetchImpl)).toAnchorLookup())).then(mergeAnchorLookups)
+            : Promise.resolve(undefined),
+    ]);
+    const conventions = opts.addressSystemConventions === null ? undefined : (opts.addressSystemConventions ?? "auto");
+    const classifier = new NeuralAddressClassifier({
+        tokenizer,
+        runner,
+        ...(labels ? { labels } : {}),
+        ...(postcodeAnchorLookup ? { postcodeAnchorLookup } : {}),
+        ...(gazetteerLexicon ? { gazetteerLexicon } : {}),
+        suppressGazetteerNearPostcode: opts.suppressGazetteerNearPostcode ?? true,
+        ...(conventions ? { addressSystemConventions: conventions } : {}),
+        bridgePunctuationGaps: opts.bridgePunctuationGaps ?? true,
+    });
+    await runner.infer([0]);
+    warnOnUnfedTrainedChannels(runner, {
+        gazetteerLexicon,
+        gazetteerLexiconUrl,
+        postcodeAnchorLookup,
+    });
+    return { classifier, diagnostics: runner.diagnostics, labels };
+}
+/**
+ * Loud degrade (#464): the warmup `infer([0])` above forced session creation, so the graph's
+ * declared inputs are now known. A gazetteer/anchor-TRAINED model running on the zero-filled
+ * fallback is a measured failure mode (train/inference mismatch — "the zero-fill trap"), not a
+ * quality-neutral default; without this check the only symptom would be silently degraded parses.
+ * (Pre-fix, the symptom was worse still: ORT's cryptic `input 'gazetteer_features' is missing in
+ * 'feeds'`.) The loader still returns a working classifier — structural fallback, loud console.
+ */
+function warnOnUnfedTrainedChannels(runner, fed) {
+    const inputNames = runner.inputNames;
+    if (!inputNames)
+        return;
+    if (inputNames.includes("gazetteer_features") && !fed.gazetteerLexicon) {
+        console.error("[mailwoman/neural-web] This model is gazetteer-anchor-trained (its ONNX declares `gazetteer_features`) " +
+            "but no gazetteer lexicon was loaded" +
+            (fed.gazetteerLexiconUrl
+                ? ` — \`anchor-lexicon-v1.json\` could not be fetched from ${fed.gazetteerLexiconUrl}. ` +
+                    "Upload the lexicon next to model.onnx, or pass `gazetteerLexiconUrl` explicitly."
+                : " — `gazetteerLexiconUrl` was explicitly disabled (null). ") +
+            " Running with zero-filled gazetteer clues: parses will be degraded (train/inference mismatch).");
+    }
+    if (inputNames.includes("anchor_features") && !fed.postcodeAnchorLookup) {
+        console.error("[mailwoman/neural-web] This model is postcode-anchor-trained (its ONNX declares `anchor_features`) " +
+            "but no `postcodeBinaryUrls` were provided (postcode-<cc>.bin). " +
+            "Running with zero-filled anchor features: the anchor-off identity, degraded vs the ship config.");
+    }
+}
+/**
+ * Fetch + parse `anchor-lexicon-v1.json`. A missing file (404 or network failure) returns null —
+ * the caller decides whether that matters (it does iff the model declares the gazetteer inputs; see
+ * `warnOnUnfedTrainedChannels`). A PRESENT-but-malformed lexicon throws loudly via
+ * `parseGazetteerLexicon`'s validation — never silently zero-fill off bad data.
+ */
+async function fetchGazetteerLexicon(url, fetchImpl) {
+    let res;
+    try {
+        res = await fetchImpl(url);
+    }
+    catch {
+        return null;
+    }
+    if (!res.ok)
+        return null;
+    return parseGazetteerLexicon((await res.json()));
+}
+/**
+ * Browser-side analogue of `weights.readLabelsFromModelCard`. Same shape contract: returns the
+ * `labels` array only when the card has a non-empty string array, throws on a present-but-malformed
+ * field, returns `null` when the field is simply absent (legacy pre-v0.4.0 card).
+ *
+ * A 404 on the model-card itself is treated as "no card provided" — we tolerate older bundles that
+ * shipped without one and let the classifier fall back to its compile-time default.
+ */
+async function fetchLabelsFromModelCard(url, fetchImpl) {
+    const res = await fetchImpl(url);
+    if (!res.ok) {
+        if (res.status === 404)
+            return null;
+        throw new Error(`fetch ${url} failed: ${res.status} ${res.statusText}`);
+    }
+    const parsed = (await res.json());
+    const labels = parsed.labels;
+    if (labels === undefined)
+        return null;
+    if (!Array.isArray(labels) || labels.length === 0 || !labels.every((l) => typeof l === "string")) {
+        throw new Error(`model-card at ${url} has a malformed \`labels\` field — ` +
+            `expected a non-empty array of strings, got ${JSON.stringify(labels)}.`);
+    }
+    return Object.freeze(labels.slice());
+}
+async function fetchBytes(url, fetchImpl) {
+    const res = await fetchImpl(url);
+    if (!res.ok)
+        throw new Error(`fetch ${url} failed: ${res.status} ${res.statusText}`);
+    return new Uint8Array(await res.arrayBuffer());
+}
+/**
+ * Base64-encode a Uint8Array. Browsers + Node 18+ both have `btoa(String.fromCharCode(...))` but
+ * String.fromCharCode chokes on long arrays (call-stack overflow on a few MB of bytes). The chunked
+ * loop avoids that — kept here rather than imported because both browser and Node need it and
+ * adding a dep for ~5 lines is silly.
+ */
+function toBase64(bytes) {
+    const chunkSize = 0x8000;
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += chunkSize) {
+        const chunk = bytes.subarray(i, i + chunkSize);
+        binary += String.fromCharCode(...chunk);
+    }
+    if (typeof btoa === "function")
+        return btoa(binary);
+    // Node: Buffer is the lower-friction path; the lazy import keeps the file from pulling in
+    // node:buffer when bundlers are statically analyzing browser entries.
+    return Buffer.from(binary, "binary").toString("base64");
+}
+//# sourceMappingURL=loader.js.map

package/out/loader.js.map

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

package/out/web-onnx-runner.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Browser ONNX inference wrapper. Implements the same `NeuralRunner` contract `@mailwoman/neural`'s
+ *   classifier consumes, but backed by `onnxruntime-web` (WASM + optional WebGPU) instead of
+ *   `onnxruntime-node`.
+ *
+ *   Execution provider strategy:
+ *
+ *   - Try WebGPU first when `useWebGpu !== false`. ~10× faster than WASM on supported devices, but
+ *       availability depends on browser (Chromium 113+, Safari Tech Preview) AND hardware. The
+ *       runtime surfaces a clean error when WebGPU is unavailable, so the constructor falls back to
+ *       WASM automatically.
+ *   - WASM (SIMD when available) is the universal fallback. ~2× slower than WebGPU on the same model
+ *       but works everywhere onnxruntime-web does — including in Node, which is how the test
+ *       harness exercises this file.
+ *
+ *   Tensor shape + I/O contract matches `OnnxRunner` exactly: fixed-length int64 inputs, padded with
+ *   zeros + attention_mask, output is a `logits` tensor of shape `[batch, seq, num_labels]`. See
+ *   `@mailwoman/neural/onnx-runner` for the full export contract this file mirrors.
+ */
+import { type InferResult, type NeuralRunner } from "@mailwoman/neural/browser";
+export interface WebOnnxRunnerOpts {
+    /**
+     * Try the WebGPU execution provider first. Defaults to true. Set false to skip the WebGPU probe —
+     * useful in test environments where WebGPU isn't available and the probe failure adds latency.
+     */
+    useWebGpu?: boolean;
+    /**
+     * Fixed sequence length the model expects. Matches `OnnxRunner.DEFAULT_FIXED_SEQ_LEN` (128) by
+     * default. Re-quantized models can override.
+     */
+    fixedSeqLen?: number;
+    /**
+     * Optional override for where onnxruntime-web should load its `.wasm` assets from. Defaults to
+     * the package's CDN paths; bundlers usually want to point this at a self-hosted copy.
+     *
+     * Example: `setWasmPaths("/static/ort/")` and put the .wasm files at /static/ort/.
+     */
+    wasmPathsRoot?: string;
+}
+export declare const DEFAULT_FIXED_SEQ_LEN = 128;
+export interface WebOnnxRunnerDiagnostics {
+    backend: "webgpu" | "wasm";
+    modelBytes: number;
+}
+export declare class WebOnnxRunner implements NeuralRunner {
+    #private;
+    private readonly modelBytes;
+    private readonly opts;
+    readonly fixedSeqLen: number;
+    diagnostics: WebOnnxRunnerDiagnostics | null;
+    private constructor();
+    /** Construct from already-fetched model bytes. */
+    static fromBytes(modelBytes: Uint8Array, opts?: WebOnnxRunnerOpts): Promise<WebOnnxRunner>;
+    /** Fetch the model from a URL and construct. */
+    static fromUrl(modelUrl: string, opts?: WebOnnxRunnerOpts): Promise<WebOnnxRunner>;
+    /**
+     * Names of the inputs the loaded ONNX graph declares. `null` until the session has been created
+     * (first `infer()` call). Lets callers (e.g. the neural-web loader) detect
+     * anchor/gazetteer-trained models and warn loudly when the corresponding feature source wasn't
+     * provided — running such a model on the zero-filled fallback is the measured train/inference
+     * mismatch ("the zero-fill trap"), not a quality-neutral degrade.
+     */
+    get inputNames(): readonly string[] | null;
+    infer(tokenIds: number[], anchor?: {
+        features: ReadonlyArray<ReadonlyArray<number>>;
+        confidence: ReadonlyArray<number>;
+    }, gazetteer?: {
+        features: ReadonlyArray<ReadonlyArray<number>>;
+        confidence: ReadonlyArray<number>;
+    }): Promise<InferResult>;
+}
+//# sourceMappingURL=web-onnx-runner.d.ts.map

package/out/web-onnx-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-onnx-runner.d.ts","sourceRoot":"","sources":["../web-onnx-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAGN,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,MAAM,2BAA2B,CAAA;AAGlC,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAUxC,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,aAAc,YAAW,YAAY;;IAOhD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPtB,SAAgB,WAAW,EAAE,MAAM,CAAA;IAC5B,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAO;IAI1D,OAAO;IAOP,kDAAkD;WACrC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpG,gDAAgD;WACnC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqC5F;;;;;;OAMG;IACH,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,GAAG,IAAI,CAEzC;IAEK,KAAK,CACV,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,EAC9F,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,GAC/F,OAAO,CAAC,WAAW,CAAC;CAoFvB"}

package/out/web-onnx-runner.js

@@ -0,0 +1,188 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Browser ONNX inference wrapper. Implements the same `NeuralRunner` contract `@mailwoman/neural`'s
+ *   classifier consumes, but backed by `onnxruntime-web` (WASM + optional WebGPU) instead of
+ *   `onnxruntime-node`.
+ *
+ *   Execution provider strategy:
+ *
+ *   - Try WebGPU first when `useWebGpu !== false`. ~10× faster than WASM on supported devices, but
+ *       availability depends on browser (Chromium 113+, Safari Tech Preview) AND hardware. The
+ *       runtime surfaces a clean error when WebGPU is unavailable, so the constructor falls back to
+ *       WASM automatically.
+ *   - WASM (SIMD when available) is the universal fallback. ~2× slower than WebGPU on the same model
+ *       but works everywhere onnxruntime-web does — including in Node, which is how the test
+ *       harness exercises this file.
+ *
+ *   Tensor shape + I/O contract matches `OnnxRunner` exactly: fixed-length int64 inputs, padded with
+ *   zeros + attention_mask, output is a `logits` tensor of shape `[batch, seq, num_labels]`. See
+ *   `@mailwoman/neural/onnx-runner` for the full export contract this file mirrors.
+ */
+import { ANCHOR_FEATURE_DIM, GAZETTEER_FEATURE_DIM, } from "@mailwoman/neural/browser";
+import * as ort from "onnxruntime-web/webgpu";
+export const DEFAULT_FIXED_SEQ_LEN = 128;
+/** Apply `wasmPathsRoot` once at module init. Safe to call multiple times. */
+function configureWasmPaths(root) {
+    if (!root)
+        return;
+    // onnxruntime-web ships this on `ort.env.wasm`. We assign directly rather than calling
+    // `setWasmPaths` so it works across the slightly different shapes the typings have had.
+    ort.env.wasm.wasmPaths = root;
+}
+export class WebOnnxRunner {
+    modelBytes;
+    opts;
+    fixedSeqLen;
+    diagnostics = null;
+    #session = null;
+    #loadPromise = null;
+    constructor(modelBytes, opts) {
+        this.modelBytes = modelBytes;
+        this.opts = opts;
+        this.fixedSeqLen = opts.fixedSeqLen ?? DEFAULT_FIXED_SEQ_LEN;
+    }
+    /** Construct from already-fetched model bytes. */
+    static async fromBytes(modelBytes, opts = {}) {
+        configureWasmPaths(opts.wasmPathsRoot);
+        const runner = new WebOnnxRunner(modelBytes, opts);
+        return runner;
+    }
+    /** Fetch the model from a URL and construct. */
+    static async fromUrl(modelUrl, opts = {}) {
+        const res = await fetch(modelUrl);
+        if (!res.ok)
+            throw new Error(`fetch ${modelUrl} failed: ${res.status} ${res.statusText}`);
+        const bytes = new Uint8Array(await res.arrayBuffer());
+        return WebOnnxRunner.fromBytes(bytes, opts);
+    }
+    async #ensureSession() {
+        if (this.#session)
+            return this.#session;
+        if (!this.#loadPromise) {
+            this.#loadPromise = (async () => {
+                const wantWebGpu = this.opts.useWebGpu !== false;
+                if (wantWebGpu) {
+                    try {
+                        const session = await ort.InferenceSession.create(this.modelBytes, {
+                            executionProviders: ["webgpu", "wasm"],
+                            graphOptimizationLevel: "all",
+                        });
+                        this.#session = session;
+                        this.diagnostics = { backend: "webgpu", modelBytes: this.modelBytes.byteLength };
+                        return session;
+                    }
+                    catch {
+                        // WebGPU probe failed — fall through to WASM
+                    }
+                }
+                const session = await ort.InferenceSession.create(this.modelBytes, {
+                    executionProviders: ["wasm"],
+                    graphOptimizationLevel: "all",
+                });
+                this.#session = session;
+                this.diagnostics = { backend: "wasm", modelBytes: this.modelBytes.byteLength };
+                return session;
+            })();
+        }
+        return this.#loadPromise;
+    }
+    /**
+     * Names of the inputs the loaded ONNX graph declares. `null` until the session has been created
+     * (first `infer()` call). Lets callers (e.g. the neural-web loader) detect
+     * anchor/gazetteer-trained models and warn loudly when the corresponding feature source wasn't
+     * provided — running such a model on the zero-filled fallback is the measured train/inference
+     * mismatch ("the zero-fill trap"), not a quality-neutral degrade.
+     */
+    get inputNames() {
+        return this.#session?.inputNames ?? null;
+    }
+    async infer(tokenIds, anchor, gazetteer) {
+        const session = await this.#ensureSession();
+        const seqLen = Math.min(tokenIds.length, this.fixedSeqLen);
+        const padded = new BigInt64Array(this.fixedSeqLen);
+        const mask = new BigInt64Array(this.fixedSeqLen);
+        for (let i = 0; i < seqLen; i++) {
+            padded[i] = BigInt(tokenIds[i]);
+            mask[i] = 1n;
+        }
+        const feeds = {
+            input_ids: new ort.Tensor("int64", padded, [1, this.fixedSeqLen]),
+            attention_mask: new ort.Tensor("int64", mask, [1, this.fixedSeqLen]),
+        };
+        // Anchor channel (#239/#240) — mirror of the node OnnxRunner. Feed the per-piece anchor when the
+        // caller supplies it; otherwise, for anchor-trained models (whose ONNX declares the inputs as
+        // mandatory), feed zeros — the confidence=0 identity / anchor-off path. Without this the session
+        // throws on the missing required inputs.
+        if (anchor) {
+            const dim = anchor.features[0]?.length ?? 0;
+            const af = new Float32Array(this.fixedSeqLen * dim);
+            const ac = new Float32Array(this.fixedSeqLen);
+            for (let i = 0; i < seqLen; i++) {
+                ac[i] = anchor.confidence[i] ?? 0;
+                const row = anchor.features[i];
+                if (row)
+                    for (let d = 0; d < dim; d++)
+                        af[i * dim + d] = row[d] ?? 0;
+            }
+            feeds.anchor_features = new ort.Tensor("float32", af, [1, this.fixedSeqLen, dim]);
+            feeds.anchor_confidence = new ort.Tensor("float32", ac, [1, this.fixedSeqLen]);
+        }
+        else if (session.inputNames.includes("anchor_features")) {
+            feeds.anchor_features = new ort.Tensor("float32", new Float32Array(this.fixedSeqLen * ANCHOR_FEATURE_DIM), [
+                1,
+                this.fixedSeqLen,
+                ANCHOR_FEATURE_DIM,
+            ]);
+            feeds.anchor_confidence = new ort.Tensor("float32", new Float32Array(this.fixedSeqLen), [1, this.fixedSeqLen]);
+        }
+        // Gazetteer-anchor channel (#464) — mirror of the node OnnxRunner. Feed the per-piece clue when
+        // the caller supplies it AND the graph declares the inputs; for gazetteer-trained models with no
+        // clue data, feed zeros (the confidence=0 identity — a structural fallback only; see the loader's
+        // loud warning) so the session doesn't throw `input 'gazetteer_features' is missing in 'feeds'`.
+        if (gazetteer && session.inputNames.includes("gazetteer_features")) {
+            const dim = gazetteer.features[0]?.length ?? 0;
+            const gf = new Float32Array(this.fixedSeqLen * dim);
+            const gc = new Float32Array(this.fixedSeqLen);
+            for (let i = 0; i < seqLen; i++) {
+                gc[i] = gazetteer.confidence[i] ?? 0;
+                const row = gazetteer.features[i];
+                if (row)
+                    for (let d = 0; d < dim; d++)
+                        gf[i * dim + d] = row[d] ?? 0;
+            }
+            feeds.gazetteer_features = new ort.Tensor("float32", gf, [1, this.fixedSeqLen, dim]);
+            feeds.gazetteer_confidence = new ort.Tensor("float32", gc, [1, this.fixedSeqLen]);
+        }
+        else if (session.inputNames.includes("gazetteer_features")) {
+            feeds.gazetteer_features = new ort.Tensor("float32", new Float32Array(this.fixedSeqLen * GAZETTEER_FEATURE_DIM), [
+                1,
+                this.fixedSeqLen,
+                GAZETTEER_FEATURE_DIM,
+            ]);
+            feeds.gazetteer_confidence = new ort.Tensor("float32", new Float32Array(this.fixedSeqLen), [1, this.fixedSeqLen]);
+        }
+        const output = await session.run(feeds);
+        const logitsTensor = output["logits"];
+        if (!logitsTensor)
+            throw new Error("ONNX model did not return a `logits` output");
+        const data = logitsTensor.data;
+        const [, , numLabels] = logitsTensor.dims;
+        const logits = [];
+        for (let t = 0; t < seqLen; t++) {
+            const row = new Array(numLabels);
+            const base = t * numLabels;
+            for (let l = 0; l < numLabels; l++)
+                row[l] = data[base + l];
+            logits.push(row);
+        }
+        // Locale head (#511 Tier A): present on v1.1.0+ exports (shipped v4.3.0+), absent before.
+        // Mirrors the node OnnxRunner — `addressSystemConventions: "auto"` depends on this surfacing.
+        const localeTensor = output["locale_logits"];
+        const localeLogits = localeTensor ? Array.from(localeTensor.data) : undefined;
+        return { logits, numLabels, ...(localeLogits ? { localeLogits } : {}) };
+    }
+}
+//# sourceMappingURL=web-onnx-runner.js.map

package/out/web-onnx-runner.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mailwoman/neural-web",
+  "version": "0.1.0",
+  "description": "Browser-side mailwoman neural runtime. Pairs the existing tokenizer + decoder with an onnxruntime-web inference path (WebGPU primary, WASM SIMD fallback). Drop-in for @mailwoman/neural when targeting a static-asset deploy (Phase B of the demo plan).",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "neural-web"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./out/index.js"
+  },
+  "dependencies": {
+    "@mailwoman/core": "4.14.0",
+    "@mailwoman/neural": "4.14.0",
+    "onnxruntime-web": "1.25.0-dev.20260327-722743c0e2"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}