nirs4all 0.2.10 → 0.2.12

package/README.md

@@ -26,10 +26,12 @@ preserves explicit methods-backed modes (`mirror`, `constant`, `nearest`,
 `wrap`, `interp`) plus `cval` in the serialized preprocessing chain.
 
 Custom app hosts can inspect `capabilityManifest()`, `controllerCapabilities`,
-and `runtimeSurfaces` before rendering graph nodes or selecting a runtime. The
-manifest schema is `nirs4all-core.capabilities.v1`; it exposes the stable V1
-controller IDs for Kennard-Stone, SNV, Savitzky-Golay, PLS regression, and the
-portable methods pipeline, with parameter lists matching the executable parser.
+`runtimeSurfaces`, and `runtimeContracts` before rendering graph nodes or
+selecting a runtime. The manifest schema is `nirs4all-core.capabilities.v1`; it
+exposes the stable V1 controller IDs for Kennard-Stone, SNV, Savitzky-Golay,
+PLS regression, and the portable methods pipeline, with parameter lists
+matching the executable parser. `runtimeContracts` also makes explicit that
+standalone serialized-model prediction is currently a WASM-only contract.
 
 For a browser-only custom host, pair this package with `nirs4all-ui`: keep
 runtime loading and portable execution in `nirs4all`, and consume shared React

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nirs4all",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Portable nirs4all aggregate binding for JavaScript and WASM",
   "type": "module",
   "exports": {

package/src/index.d.ts

@@ -19,6 +19,14 @@ export interface PipelineDefinition {
 export type RuntimeSurface = 'python' | 'r' | 'javascript_wasm' | 'rust' | 'matlab_octave';
 export type CapabilityLevel = 'metadata' | 'plan' | 'execute-local' | 'execute-remote' | 'parity-validated';
 
+export interface RuntimeContract {
+  surface: RuntimeSurface;
+  pipelineExecution: CapabilityLevel;
+  pipelineEntrypoint: string;
+  serializedModelPredict: boolean;
+  predictEntrypoint: string | null;
+}
+
 export interface ControllerCapability {
   id: string;
   kind: 'splitter' | 'transform' | 'model' | 'pipeline';
@@ -39,6 +47,7 @@ export interface CapabilityManifest {
   schema: 'nirs4all-core.capabilities.v1';
   aggregate: 'nirs4all-core';
   runtimeSurfaces: readonly RuntimeSurface[];
+  runtimeContracts: readonly RuntimeContract[];
   portableOperatorClasses: readonly string[];
   controllers: readonly ControllerCapability[];
 }
@@ -96,6 +105,7 @@ export interface PortablePredictionResult {
 export const upstreams: readonly Upstream[];
 export const portableOperatorClasses: readonly string[];
 export const runtimeSurfaces: readonly RuntimeSurface[];
+export const runtimeContracts: readonly RuntimeContract[];
 export const controllerCapabilities: readonly ControllerCapability[];
 export function capabilityManifest(): CapabilityManifest;
 

package/src/index.js

@@ -53,6 +53,44 @@ export const runtimeSurfaces = Object.freeze([
   'matlab_octave',
 ]);
 
+export const runtimeContracts = Object.freeze([
+  Object.freeze({
+    surface: 'python',
+    pipelineExecution: 'parity-validated',
+    pipelineEntrypoint: 'run_portable_pipeline',
+    serializedModelPredict: false,
+    predictEntrypoint: null,
+  }),
+  Object.freeze({
+    surface: 'r',
+    pipelineExecution: 'parity-validated',
+    pipelineEntrypoint: 'nirs4all_run_portable_pipeline',
+    serializedModelPredict: false,
+    predictEntrypoint: null,
+  }),
+  Object.freeze({
+    surface: 'javascript_wasm',
+    pipelineExecution: 'parity-validated',
+    pipelineEntrypoint: 'runPortablePipeline',
+    serializedModelPredict: true,
+    predictEntrypoint: 'predictPortablePipeline',
+  }),
+  Object.freeze({
+    surface: 'rust',
+    pipelineExecution: 'parity-validated',
+    pipelineEntrypoint: 'run_portable_pipeline_with_library',
+    serializedModelPredict: false,
+    predictEntrypoint: null,
+  }),
+  Object.freeze({
+    surface: 'matlab_octave',
+    pipelineExecution: 'parity-validated',
+    pipelineEntrypoint: 'runPortablePipeline',
+    serializedModelPredict: false,
+    predictEntrypoint: null,
+  }),
+]);
+
 const parityRuntime = Object.freeze(Object.fromEntries(
   runtimeSurfaces.map((surface) => [surface, 'parity-validated']),
 ));
@@ -154,6 +192,7 @@ export function capabilityManifest() {
     schema: 'nirs4all-core.capabilities.v1',
     aggregate: 'nirs4all-core',
     runtimeSurfaces,
+    runtimeContracts,
     portableOperatorClasses,
     controllers: controllerCapabilities,
   });