@mauriciobenjamin700/ort-vision-sdk-web 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,74 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-09-13
+
+### Fixed
+
+- **A model exported with `half=True` now runs (#50).** Every task built its
+  feed as `Float32Array` and nothing read the element type the graph declares,
+  so a half-precision export loaded fine and threw on the first `predict()`:
+  `Unexpected input data type. Actual: (tensor(float)) , expected:
+  (tensor(float16))`. FP16 halves the artifact — 5.11 MB against 10.11 MB on a
+  detector, 10.41 against 20.78 on a classifier — which in a browser is the
+  difference between the page opening and not.
+
+  The declared type now comes out of the model file itself, in the same pass
+  the SDK already makes for `names`: `session.inputMetadata` is `undefined` on
+  `onnxruntime-web` 1.20.1, so the session cannot answer this. `OrtSession`
+  exposes it as `inputDtype`/`inputDtypes`, and `run()` converts any float32
+  feed whose input declares `float16` — one boundary, rather than the fourteen
+  `toFloat32Tensor` call sites the tasks are built from. Preprocessing stays in
+  `Float32Array` on purpose: `(value / 255 - mean) / std` in half precision
+  loses exactly the small differences normalization exists to preserve.
+
+  Outputs are widened back before decoding. Float16 resolves to 0.5 px around
+  coordinate 640 and 1.0 px around 1280, so decoding boxes in that type would
+  quantise every coordinate before NMS and the scale-back to original-image
+  pixels ever ran.
+
+- **A browser without `Float16Array` is refused at `create()`, not at the first
+  frame.** ORT requires a real `Float16Array` for a half tensor — the same bits
+  in a `Uint16Array` are rejected — and not every browser has one. Loading a
+  half-precision model there now fails immediately with a message naming the
+  inputs and the missing global, instead of throwing from inside preprocessing
+  one frame later.
+
+### Added
+
+- **`readModelInputTypes`, `tensorTypeFor`, `asFloat32Array`,
+  `hasFloat16Array`** and the `DEFAULT_TENSOR_TYPE` constant, for callers
+  driving `OrtSession` directly. `asFloat32Array` is the one to reach for when
+  reading a raw output: it passes a `Float32Array` through and widens anything
+  else.
+
+
+## [0.8.1] - 2026-09-04
+
+### Performance
+
+- **`Probs.top5` selects five classes instead of ordering a thousand.** `_topK`
+  allocated one index per class, sorted the whole array with a JS comparator,
+  then kept five entries and discarded the rest — and `top5` and `top5conf` are
+  separate getters over the same selection, so a caller reading both paid for it
+  twice, once per frame in a camera loop.
+
+  Partial selection keeps `k` slots ordered by insertion and scans the vector
+  once: O(n·k), no allocation beyond the result. Measured on 1000 classes over
+  2000 iterations, 134.5 µs became 1.5 µs for identical output. Each `k` is now
+  computed once per instance and cached, which is what makes reading both
+  getters cost one selection rather than two — the arrays handed back are the
+  cached ones, so treat them as read-only.
+
+  Ties still keep the lower class index first, matching the stable sort this
+  replaced and therefore the Python SDK's `np.argsort(-data, kind="stable")`.
+  `test/results.test.ts` pins that against the old full sort as an oracle over
+  40 random vectors of integer-valued probabilities — integers so ties are
+  common rather than theoretical.
+
+  Web-only by design: the Python side sorts in C inside numpy, where this cost
+  does not arise.
+
 ## [0.8.0] - 2026-09-04
 
 ### Changed
@@ -620,7 +688,9 @@ console.log(r.boxes.xyxy, r.boxes.cls, r.boxes.conf, r.names);
 - Execution-provider resolution defaulting to `["webgpu", "wasm"]`.
 - Public types mirroring the Python SDK: `BoundingBox`, `ClassProbability`, `ClassificationResult`, `DetectionResult`, `RGBImage`.
 
-[Unreleased]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.8.0...HEAD
+[Unreleased]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.9.0...HEAD
+[0.9.0]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.8.1...web-v0.9.0
+[0.8.1]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.8.0...web-v0.8.1
 [0.8.0]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.7.1...web-v0.8.0
 [0.7.1]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.7.0...web-v0.7.1
 [0.7.0]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.6.1...web-v0.7.0

package/dist/core/dtypes.d.ts

@@ -0,0 +1,81 @@
+/**
+ * What element type the graph declares, and what typed array that means.
+ *
+ * A model exported with `half=True` declares its input as `float16`, and ONNX
+ * Runtime refuses a float32 feed against it:
+ *
+ * ```text
+ * Unexpected input data type. Actual: (tensor(float)) , expected: (tensor(float16))
+ * ```
+ *
+ * The session opens without complaint, so the failure lands on the caller's
+ * first `predict()` rather than on `create()`. Preprocessing stays in
+ * `Float32Array` because that is where the normalization arithmetic belongs —
+ * `(value / 255 - mean) / std` in half precision loses exactly the small
+ * differences normalization exists to preserve — and the conversion happens
+ * once, at the feed boundary.
+ *
+ * Outputs travel the other way. Float16 carries 11 bits of mantissa, so at
+ * pixel scale its neighbouring values are 0.5 apart around coordinate 640 and
+ * 1.0 apart around 1280: decoding boxes in that type quantises every coordinate
+ * before NMS and the scale-back to original-image pixels ever run. {@link
+ * asFloat32Array} widens a half-precision output before the decoders touch it.
+ *
+ * `Float16Array` is what ORT requires for a half tensor — a `Uint16Array` of
+ * the same bits is rejected — and it is not in every browser yet, so
+ * {@link hasFloat16Array} exists to refuse at session creation instead of on
+ * the first frame.
+ */
+/** The element type every task preprocesses to, and the fallback when unknown. */
+export declare const DEFAULT_TENSOR_TYPE = "float32";
+/**
+ * The structural surface of `Float16Array` this module needs.
+ *
+ * Declared here rather than pulled from `lib.es2025`: the package targets
+ * ES2022 so it builds for consumers on older TypeScript, and the only thing
+ * needed is "an array-like of numbers ORT recognises as half precision".
+ */
+export interface Float16ArrayLike {
+    readonly length: number;
+    readonly buffer: ArrayBufferLike;
+    [index: number]: number;
+}
+/**
+ * Whether this environment can build a half-precision tensor at all.
+ *
+ * @returns `true` when the runtime exposes `Float16Array`. ORT rejects any
+ *   other typed array for a `float16` tensor, so a `false` here means half
+ *   precision is unreachable in this browser no matter what the model declares.
+ */
+export declare function hasFloat16Array(): boolean;
+/**
+ * Name the tensor type an ONNX element type maps to.
+ *
+ * @param elemType A `TensorProto.DataType` value read off the graph.
+ * @returns The ORT tensor type name, or `"float32"` for anything unrecognised —
+ *   which is what every task produces anyway, so an unknown type surfaces as
+ *   ORT's own type error against the real graph rather than as a lookup miss.
+ */
+export declare function tensorTypeFor(elemType: number | undefined): string;
+/**
+ * Convert a preprocessed float32 buffer to the type a feed must carry.
+ *
+ * @param data The preprocessed planar buffer.
+ * @param tensorType The tensor type the input declares, from
+ *   {@link tensorTypeFor}.
+ * @returns `data` itself for a float32 input, or a `Float16Array` holding the
+ *   same values for a half-precision one.
+ * @throws {RangeError} If half precision is asked for and the runtime has no
+ *   `Float16Array`. Callers convert this into a `ModelLoadError` at session
+ *   creation, so it never reaches a `predict()`.
+ */
+export declare function toFeedData(data: Float32Array, tensorType: string): Float32Array | Float16ArrayLike;
+/**
+ * Widen a model output to `Float32Array`, without copying when it already is.
+ *
+ * @param data A tensor's `data`, as ORT returned it.
+ * @returns The same values as a `Float32Array`. A float32 output is passed
+ *   through untouched; anything else is copied once.
+ */
+export declare function asFloat32Array(data: unknown): Float32Array;
+//# sourceMappingURL=dtypes.d.ts.map

package/dist/core/dtypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtypes.d.ts","sourceRoot":"","sources":["../../src/core/dtypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAkBH,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAQD;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,gBAAgB,CAQlG;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAG1D"}

package/dist/core/dtypes.js

@@ -0,0 +1,102 @@
+/**
+ * What element type the graph declares, and what typed array that means.
+ *
+ * A model exported with `half=True` declares its input as `float16`, and ONNX
+ * Runtime refuses a float32 feed against it:
+ *
+ * ```text
+ * Unexpected input data type. Actual: (tensor(float)) , expected: (tensor(float16))
+ * ```
+ *
+ * The session opens without complaint, so the failure lands on the caller's
+ * first `predict()` rather than on `create()`. Preprocessing stays in
+ * `Float32Array` because that is where the normalization arithmetic belongs —
+ * `(value / 255 - mean) / std` in half precision loses exactly the small
+ * differences normalization exists to preserve — and the conversion happens
+ * once, at the feed boundary.
+ *
+ * Outputs travel the other way. Float16 carries 11 bits of mantissa, so at
+ * pixel scale its neighbouring values are 0.5 apart around coordinate 640 and
+ * 1.0 apart around 1280: decoding boxes in that type quantises every coordinate
+ * before NMS and the scale-back to original-image pixels ever run. {@link
+ * asFloat32Array} widens a half-precision output before the decoders touch it.
+ *
+ * `Float16Array` is what ORT requires for a half tensor — a `Uint16Array` of
+ * the same bits is rejected — and it is not in every browser yet, so
+ * {@link hasFloat16Array} exists to refuse at session creation instead of on
+ * the first frame.
+ */
+/** ONNX `TensorProto.DataType` values this SDK can name. */
+const ELEM_TYPE_TO_TENSOR_TYPE = {
+    1: "float32",
+    2: "uint8",
+    3: "int8",
+    4: "uint16",
+    5: "int16",
+    6: "int32",
+    7: "int64",
+    9: "bool",
+    10: "float16",
+    11: "float64",
+    12: "uint32",
+    13: "uint64",
+};
+/** The element type every task preprocesses to, and the fallback when unknown. */
+export const DEFAULT_TENSOR_TYPE = "float32";
+const FLOAT16_ARRAY = globalThis.Float16Array;
+/**
+ * Whether this environment can build a half-precision tensor at all.
+ *
+ * @returns `true` when the runtime exposes `Float16Array`. ORT rejects any
+ *   other typed array for a `float16` tensor, so a `false` here means half
+ *   precision is unreachable in this browser no matter what the model declares.
+ */
+export function hasFloat16Array() {
+    return FLOAT16_ARRAY !== undefined;
+}
+/**
+ * Name the tensor type an ONNX element type maps to.
+ *
+ * @param elemType A `TensorProto.DataType` value read off the graph.
+ * @returns The ORT tensor type name, or `"float32"` for anything unrecognised —
+ *   which is what every task produces anyway, so an unknown type surfaces as
+ *   ORT's own type error against the real graph rather than as a lookup miss.
+ */
+export function tensorTypeFor(elemType) {
+    if (elemType === undefined)
+        return DEFAULT_TENSOR_TYPE;
+    return ELEM_TYPE_TO_TENSOR_TYPE[elemType] ?? DEFAULT_TENSOR_TYPE;
+}
+/**
+ * Convert a preprocessed float32 buffer to the type a feed must carry.
+ *
+ * @param data The preprocessed planar buffer.
+ * @param tensorType The tensor type the input declares, from
+ *   {@link tensorTypeFor}.
+ * @returns `data` itself for a float32 input, or a `Float16Array` holding the
+ *   same values for a half-precision one.
+ * @throws {RangeError} If half precision is asked for and the runtime has no
+ *   `Float16Array`. Callers convert this into a `ModelLoadError` at session
+ *   creation, so it never reaches a `predict()`.
+ */
+export function toFeedData(data, tensorType) {
+    if (tensorType !== "float16")
+        return data;
+    if (FLOAT16_ARRAY === undefined) {
+        throw new RangeError("This model declares a float16 input, but this environment has no Float16Array.");
+    }
+    return new FLOAT16_ARRAY(data);
+}
+/**
+ * Widen a model output to `Float32Array`, without copying when it already is.
+ *
+ * @param data A tensor's `data`, as ORT returned it.
+ * @returns The same values as a `Float32Array`. A float32 output is passed
+ *   through untouched; anything else is copied once.
+ */
+export function asFloat32Array(data) {
+    if (data instanceof Float32Array)
+        return data;
+    return Float32Array.from(data);
+}
+//# sourceMappingURL=dtypes.js.map

package/dist/core/dtypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtypes.js","sourceRoot":"","sources":["../../src/core/dtypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,4DAA4D;AAC5D,MAAM,wBAAwB,GAAqC;IACjE,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,MAAM;IACT,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAmB7C,MAAM,aAAa,GAAI,UAAyD,CAAC,YAAY,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAA4B;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IACvD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,UAAkB;IAC/D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAClB,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,IAAI,YAAY,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAyB,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/metadata.d.ts

@@ -22,6 +22,21 @@
  *   cannot be walked.
  */
 export declare function readModelMetadata(model: Uint8Array | ArrayBufferLike): Readonly<Record<string, string>>;
+/**
+ * Read the element type each graph input declares.
+ *
+ * `onnxruntime-web` does not expose this. `session.inputMetadata` is
+ * `undefined` on 1.20.1 — the same version where `declaredShapesFrom` comes
+ * back empty — so the declared types have to come from the file, which the SDK
+ * already downloads and walks for {@link readModelMetadata}. Same bytes, one
+ * more pass, no extra request.
+ *
+ * @param model The `.onnx` file contents.
+ * @returns Input name → `TensorProto.DataType` value. An empty object when the
+ *   file carries no readable graph, which every caller treats as "assume
+ *   float32" — the behaviour before any of this existed.
+ */
+export declare function readModelInputTypes(model: Uint8Array | ArrayBufferLike): Readonly<Record<string, number>>;
 /**
  * Read the class names an export baked into the model metadata.
  *

package/dist/core/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyIH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,GAAG,eAAe,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBlC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACrD,SAAS,MAAM,EAAE,GAAG,IAAI,CAE1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CA6BhF"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyJH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,GAAG,eAAe,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBlC;AA2FD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,GAAG,eAAe,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACrD,SAAS,MAAM,EAAE,GAAG,IAAI,CAE1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CA6BhF"}

package/dist/core/metadata.js

@@ -15,6 +15,17 @@
  */
 /** Field number of `metadata_props` in `ModelProto` (repeated StringStringEntryProto). */
 const MODEL_METADATA_PROPS_FIELD = 14;
+/** Field number of `graph` in `ModelProto` (GraphProto). */
+const MODEL_GRAPH_FIELD = 7;
+/** Field number of `input` in `GraphProto` (repeated ValueInfoProto). */
+const GRAPH_INPUT_FIELD = 11;
+/** Field numbers of `name` and `type` in `ValueInfoProto`. */
+const VALUE_INFO_NAME_FIELD = 1;
+const VALUE_INFO_TYPE_FIELD = 2;
+/** Field number of `tensor_type` in `TypeProto` (TypeProto.Tensor). */
+const TYPE_TENSOR_FIELD = 1;
+/** Field number of `elem_type` in `TypeProto.Tensor` (a `TensorProto.DataType`). */
+const TENSOR_ELEM_TYPE_FIELD = 1;
 /** Field numbers of `key` and `value` in `StringStringEntryProto`. */
 const ENTRY_KEY_FIELD = 1;
 const ENTRY_VALUE_FIELD = 2;
@@ -168,6 +179,150 @@ export function readModelMetadata(model) {
     }
     return metadata;
 }
+/**
+ * Read the element type of a `TypeProto.Tensor` message.
+ *
+ * @param bytes The whole model buffer.
+ * @param start Offset of the message's first byte.
+ * @param end Offset one past its last byte.
+ * @returns The `TensorProto.DataType` value, or `null` when the message
+ *   carries none or cannot be walked.
+ */
+function readTensorElemType(bytes, start, end) {
+    const cursor = { bytes, end, pos: start };
+    while (cursor.pos < cursor.end) {
+        const tag = readVarint(cursor);
+        if (tag === null)
+            return null;
+        const field = tag >>> 3;
+        const wireType = tag & 0x07;
+        if (field === TENSOR_ELEM_TYPE_FIELD && wireType === WIRE_VARINT) {
+            return readVarint(cursor);
+        }
+        if (!skipField(cursor, wireType))
+            return null;
+    }
+    return null;
+}
+/**
+ * Read the element type out of a `TypeProto`, which wraps the tensor type.
+ *
+ * @param bytes The whole model buffer.
+ * @param start Offset of the message's first byte.
+ * @param end Offset one past its last byte.
+ * @returns The `TensorProto.DataType` value, or `null` for a non-tensor type
+ *   (sequence, map, optional) or an unreadable message.
+ */
+function readTypeElemType(bytes, start, end) {
+    const cursor = { bytes, end, pos: start };
+    while (cursor.pos < cursor.end) {
+        const tag = readVarint(cursor);
+        if (tag === null)
+            return null;
+        const field = tag >>> 3;
+        const wireType = tag & 0x07;
+        if (field === TYPE_TENSOR_FIELD && wireType === WIRE_LENGTH_DELIMITED) {
+            const range = readLengthDelimited(cursor);
+            if (range === null)
+                return null;
+            return readTensorElemType(bytes, range.start, range.end);
+        }
+        if (!skipField(cursor, wireType))
+            return null;
+    }
+    return null;
+}
+/**
+ * Read one `ValueInfoProto` into a name/element-type pair.
+ *
+ * @param bytes The whole model buffer.
+ * @param start Offset of the message's first byte.
+ * @param end Offset one past its last byte.
+ * @returns The pair, or `null` when either half is missing or unreadable.
+ */
+function readValueInfo(bytes, start, end) {
+    const cursor = { bytes, end, pos: start };
+    let name = null;
+    let elemType = null;
+    while (cursor.pos < cursor.end) {
+        const tag = readVarint(cursor);
+        if (tag === null)
+            return null;
+        const field = tag >>> 3;
+        const wireType = tag & 0x07;
+        if (wireType === WIRE_LENGTH_DELIMITED) {
+            const range = readLengthDelimited(cursor);
+            if (range === null)
+                return null;
+            if (field === VALUE_INFO_NAME_FIELD) {
+                name = new TextDecoder("utf-8", { fatal: false }).decode(bytes.subarray(range.start, range.end));
+            }
+            else if (field === VALUE_INFO_TYPE_FIELD) {
+                elemType = readTypeElemType(bytes, range.start, range.end);
+            }
+            continue;
+        }
+        if (!skipField(cursor, wireType))
+            return null;
+    }
+    if (name === null || elemType === null)
+        return null;
+    return [name, elemType];
+}
+/**
+ * Read the element type each graph input declares.
+ *
+ * `onnxruntime-web` does not expose this. `session.inputMetadata` is
+ * `undefined` on 1.20.1 — the same version where `declaredShapesFrom` comes
+ * back empty — so the declared types have to come from the file, which the SDK
+ * already downloads and walks for {@link readModelMetadata}. Same bytes, one
+ * more pass, no extra request.
+ *
+ * @param model The `.onnx` file contents.
+ * @returns Input name → `TensorProto.DataType` value. An empty object when the
+ *   file carries no readable graph, which every caller treats as "assume
+ *   float32" — the behaviour before any of this existed.
+ */
+export function readModelInputTypes(model) {
+    const bytes = model instanceof Uint8Array ? model : new Uint8Array(model);
+    const cursor = { bytes, end: bytes.length, pos: 0 };
+    const types = {};
+    while (cursor.pos < cursor.end) {
+        const tag = readVarint(cursor);
+        if (tag === null)
+            break;
+        const field = tag >>> 3;
+        const wireType = tag & 0x07;
+        if (field === MODEL_GRAPH_FIELD && wireType === WIRE_LENGTH_DELIMITED) {
+            const graph = readLengthDelimited(cursor);
+            if (graph === null)
+                break;
+            const inner = { bytes, end: graph.end, pos: graph.start };
+            while (inner.pos < inner.end) {
+                const innerTag = readVarint(inner);
+                if (innerTag === null)
+                    break;
+                const innerField = innerTag >>> 3;
+                const innerWire = innerTag & 0x07;
+                if (innerField === GRAPH_INPUT_FIELD && innerWire === WIRE_LENGTH_DELIMITED) {
+                    const range = readLengthDelimited(inner);
+                    if (range === null)
+                        break;
+                    const info = readValueInfo(bytes, range.start, range.end);
+                    if (info)
+                        types[info[0]] = info[1];
+                    continue;
+                }
+                if (!skipField(inner, innerWire))
+                    break;
+            }
+            continue;
+        }
+        if (!skipField(cursor, wireType))
+            break;
+    }
+    return types;
+}
 /**
  * Read the class names an export baked into the model metadata.
  *

package/dist/core/metadata.js.map

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

package/dist/core/session.d.ts

@@ -69,6 +69,15 @@ export declare class OrtSession {
      * `webgpu` on a device without it runs on WASM and is told nothing.
      */
     readonly requestedProviders: readonly string[];
+    /**
+     * Tensor type each input declares, keyed by input name.
+     *
+     * Read from the model file, not from the session: `inputMetadata` is
+     * `undefined` on `onnxruntime-web` 1.20.1. Empty when the bytes were never
+     * in hand — a URL loaded with `readMetadata: false` — in which case every
+     * feed is built as float32, the behaviour before this existed.
+     */
+    private readonly _inputTypes;
     private constructor();
     /**
      * Load an ONNX model into an ORT inference session.
@@ -89,6 +98,16 @@ export declare class OrtSession {
      * @throws {@link ModelLoadError} if the model cannot be loaded.
      */
     static create(model: ModelSource, options?: OrtSessionOptions): Promise<OrtSession>;
+    /**
+     * Tensor type each input declares, in declaration order.
+     *
+     * `"float32"` for a normal export, `"float16"` for one exported with
+     * `half=True`. ORT matches a feed's type against this exactly, so the tasks
+     * read it and convert at the feed boundary.
+     */
+    get inputDtypes(): readonly string[];
+    /** Tensor type the first input declares. */
+    get inputDtype(): string;
     /** Names of the model's inputs, in declaration order. */
     get inputNames(): readonly string[];
     /** Name of the first (and usually only) input. */
@@ -149,5 +168,20 @@ export declare class OrtSession {
      * @throws {@link InferenceError} if ORT raises any error during execution.
      */
     run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>>;
+    /**
+     * Rebuild any feed whose type does not match what its input declares.
+     *
+     * ORT matches feed types against the graph exactly: a float32 tensor against
+     * a `half=True` export fails the run with `Unexpected input data type`. Every
+     * preprocessing path in this SDK produces `Float32Array`, on purpose — the
+     * normalization arithmetic belongs in single precision — so the conversion
+     * happens here, once, at the only boundary all of them pass through. A feed
+     * that already carries the declared type is handed on untouched, so a caller
+     * building its own half tensor pays nothing.
+     *
+     * @param feeds The tensors to run with.
+     * @returns The same mapping, with mismatched float32 feeds converted.
+     */
+    private _asDeclaredTypes;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,YAAY,CAAC;AAIpE,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;AA+ChE,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,cAAc,CAAC;IAC9D;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AA4BD;;;;;;GAMG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB;;;;;;;;;;;;;;;;OAgBG;aACa,SAAS,EAAE,SAAS,MAAM,EAAE;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;;OAKG;aACa,kBAAkB,EAAE,SAAS,MAAM,EAAE;IA3BvD,OAAO;IA8BP;;;;;;;;;;;;;;;;;OAiBG;WACU,MAAM,CACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC;IAuCtB,yDAAyD;IACzD,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAElC;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,CAMtB;IAED,0DAA0D;IAC1D,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAEnC;IAED;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,SAAS,aAAa,EAAE,CAM1C;IAED;;;;OAIG;IACH,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,SAAS,aAAa,EAAE,CAM3C;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,aAAa,CAE/B;IAED;;;;;;;OAOG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE/C;IAED;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,wEAAwE;IACxE,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAE9B;IAED;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAWvC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAU5C,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,YAAY,CAAC;AAIpE,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;AA+ChE,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,cAAc,CAAC;IAC9D;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAqED;;;;;;GAMG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB;;;;;;;;;;;;;;;;OAgBG;aACa,SAAS,EAAE,SAAS,MAAM,EAAE;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;;OAKG;aACa,kBAAkB,EAAE,SAAS,MAAM,EAAE;IACrD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW;IApC9B,OAAO;IAuCP;;;;;;;;;;;;;;;;;OAiBG;WACU,MAAM,CACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC;IA0CtB;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAEnC;IAED,4CAA4C;IAC5C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,yDAAyD;IACzD,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAElC;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,CAMtB;IAED,0DAA0D;IAC1D,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAEnC;IAED;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,SAAS,aAAa,EAAE,CAM1C;IAED;;;;OAIG;IACH,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,SAAS,aAAa,EAAE,CAM3C;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,aAAa,CAE/B;IAED;;;;;;;OAOG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE/C;IAED;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,wEAAwE;IACxE,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAE9B;IAED;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAYtC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;CAmBzB"}