runmat 0.6.1-dev.1 → 0.6.2-dev.0

package/dist/pkg-web/runmat_wasm_web.d.ts

@@ -1,6 +1,68 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Rust-owned application encryption/replay state for a browser WebSocket or
+ * WebTransport host. JavaScript transports the returned opaque bytes without
+ * receiving the run key or implementing protocol crypto.
+ */
+export class BrowserEncryptedFrameSession {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    open(encoded: Uint8Array): Uint8Array;
+    seal(frame_kind: number, plaintext: Uint8Array): Uint8Array;
+}
+
+export class BrowserExecutionRecipient {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(fingerprint: string, valid_after_unix_millis: bigint, valid_before_unix_millis: bigint);
+    open(artifact: any): Uint8Array;
+    openRunKey(envelope: any, expected_run_identity: string, expected_key_epoch: number): BrowserRunKey;
+    seal(context: any, plaintext: Uint8Array): any;
+    readonly recipient: any;
+}
+
+/**
+ * Browser-side authority for the content-blind two-stage submission.
+ *
+ * Network requests remain a small TypeScript host responsibility. Rust owns
+ * the run key, exact endpoint recipient, encryption contexts, and canonical
+ * ciphertext bytes so browser and native submissions cannot drift.
+ */
+export class BrowserRemoteSubmission {
+    free(): void;
+    [Symbol.dispose](): void;
+    createFrameSession(session_id: Uint8Array, direction: string, key_epoch: number): BrowserEncryptedFrameSession;
+    decryptObject(purpose: string, ciphertext: Uint8Array): Uint8Array;
+    encryptObject(purpose: string, plaintext: Uint8Array, task_identity: string | null | undefined, attempt_identity: string | null | undefined, chunk_index: bigint, key_epoch: number): Uint8Array;
+    constructor(run_identity: string, verified_endpoint: any);
+    sealRunKeyEnvelope(key_epoch: number): Uint8Array;
+    /**
+     * Seal this submission's content key to an organization recovery
+     * recipient returned by the public Server policy API.
+     */
+    sealRunKeyForRecipient(recipient: any, key_epoch: number): Uint8Array;
+    readonly directQuicEndpoints: any;
+    readonly endpointFingerprint: string;
+}
+
+/**
+ * Browser-owned content key for one remote run. JavaScript can use it to
+ * encrypt/decrypt objects and create recipient envelopes, but cannot extract
+ * the raw key bytes.
+ */
+export class BrowserRunKey {
+    free(): void;
+    [Symbol.dispose](): void;
+    createFrameSession(run_identity: string, session_id: Uint8Array, direction: string, key_epoch: number): BrowserEncryptedFrameSession;
+    constructor();
+    open(object: any): Uint8Array;
+    seal(context: any, plaintext: Uint8Array): any;
+    sealForRecipient(recipient: any, run_identity: string, key_epoch: number): any;
+}
+
 export class RunMatWasm {
     private constructor();
     free(): void;
@@ -8,10 +70,23 @@ export class RunMatWasm {
     applyFeaStudyDocumentOperation(operation: string, path: string, source: string | null | undefined, input: any): any;
     cancelExecution(): void;
     checkFeaStudy(path: string): Promise<any>;
+    clearProjectHandoff(): void;
     clearWorkspace(): void;
+    /**
+     * Return semantic discovery for the exact caller-frozen run snapshot.
+     * The Core session verifies it against the installed project handoff
+     * before static analysis; no browser filesystem rediscovery occurs.
+     */
+    discoverTests(value: any): any;
     dispose(): void;
     disposeGeometryPreview(figure_handle?: number | null, geometry_scene_handle?: number | null): void;
     executeRequest(request_value: any): Promise<any>;
+    /**
+     * Execute one exact planned test in this session. Browser worker adapters
+     * use this narrow endpoint; scheduling remains in the portable Rust
+     * coordinator.
+     */
+    executeTestAttempt(input: any): Promise<any>;
     exportFigureScene(handle: number, scene_budget_bytes?: number | null): Promise<Uint8Array | undefined>;
     exportGeometryScene(handle: number): Uint8Array | undefined;
     exportWorkspaceState(include_variables?: string | null): Promise<Uint8Array | undefined>;
@@ -24,10 +99,18 @@ export class RunMatWasm {
     importGeometryScene(scene: Uint8Array): number | undefined;
     importWorkspaceState(state: Uint8Array): boolean;
     inspectDataFile(path: string): Promise<any>;
+    installProjectHandoff(value: any): any;
     materializeDataFileVariable(path: string, array: string, options: any): Promise<any>;
     materializeVariable(selector: any, options: any): Promise<any>;
     memoryUsage(): any;
+    packageCacheSnapshot(): Promise<any>;
+    /**
+     * Discover and construct the selected immutable plan through the same
+     * Core authority used by native hosts.
+     */
+    prepareTests(snapshot: any, selector: any): any;
     previewGeometry(path: string, budget_value: any): Promise<any>;
+    projectRevision(): any;
     resetSession(): void;
     runFeaStudy(path: string, artifact_root?: string | null): Promise<any>;
     setFsProvider(bindings: any): void;
@@ -42,6 +125,10 @@ export class RunMatWasm {
 
 export function bindSurfaceToFigure(surface_id: number, handle: number): void;
 
+export function buildExecutionBundle(project_handoff: any, recipe: any, executable_bytes: Uint8Array): Promise<Uint8Array>;
+
+export function buildGitSnapshot(repository: string, subdir: string, value: any): any;
+
 export function clearFigure(handle: any): number;
 
 export function closeFigure(handle: any): number;
@@ -54,22 +141,64 @@ export function currentAxesInfo(): any;
 
 export function currentFigureHandle(): number;
 
+export function decodePackageLock(input: string): any;
+
 export function destroyPlotSurface(surface_id: number): void;
 
+export function encodePackageLock(value: any): string;
+
+export function executeProgramArtifact(request: any): Promise<any>;
+
+/**
+ * Build the exact browser WebSocket subprotocol list for an authenticated
+ * relay capability returned by the admission endpoint.
+ */
+export function executionRelayProtocols(ticket: string): any;
+
 export function fitPlotSurfaceExtents(surface_id: number): void;
 
+export function freezeTestSnapshot(value: any): any;
+
 export function getPlotSurfaceCameraState(surface_id: number): any;
 
 export function handlePlotSurfaceEvent(surface_id: number, event: any): void;
 
+export function handoffFromFrozenProject(value: any): any;
+
 export function initRunMat(options: any): Promise<RunMatWasm>;
 
+/**
+ * Verify and materialize an exact execution bundle into the active browser
+ * filesystem provider, returning the existing frozen-project handoff rebased
+ * to those bytes. Browser worker hosts should use an ephemeral provider and
+ * dispose it with the worker.
+ */
+export function materializeExecutionBundle(archive: Uint8Array): Promise<any>;
+
+export function migrateLegacyRunmatConfig(source: string, format: string): any;
+
+export function migrateLegacyRunmatConfigInto(legacy_source: string, destination_source: string, format: string): any;
+
 export function newFigureHandle(): number;
 
 export function onFigureEvent(callback: any): void;
 
+export function packageCacheAcquireLease(provider: any, request: any): Promise<any>;
+
+export function packageCacheGc(provider: any, target_bytes: bigint, retain_recent_ms: bigint): Promise<any>;
+
+export function packageCacheReleaseLease(provider: any, value: any): Promise<void>;
+
+export function packageCacheRenewLease(provider: any, value: any, ttl_ms: bigint): Promise<any>;
+
+export function packageCacheStatus(provider: any): Promise<any>;
+
+export function patchRunmatConfig(source: string, format: string, patch: any): string;
+
 export function pickGeometrySceneRegion(surface_id: number, x: number, y: number): any;
 
+export function planGitAcquisition(value: any): any;
+
 export function plotRendererReady(): boolean;
 
 export function presentFigureOnSurface(surface_id: number, handle: number): void;
@@ -78,6 +207,12 @@ export function presentGeometrySceneOnSurface(surface_id: number, handle: number
 
 export function presentSurface(surface_id: number): void;
 
+export function projectHandoff(source_path: string): Promise<any>;
+
+export function projectRevision(source_path: string): Promise<any>;
+
+export function projectTestLayout(value: any): any;
+
 export function renderCurrentFigureScene(handle: number): void;
 
 export function renderFigureImage(handle: any, width?: number | null, height?: number | null, textmark?: string | null): Promise<Uint8Array>;
@@ -94,6 +229,24 @@ export function resetPlotSurfaceCamera(surface_id: number): void;
 
 export function resizePlotSurface(surface_id: number, width: number, height: number, pixels_per_point: number): void;
 
+export function resolveProject(request: any, provider: any, filesystem: any): Promise<any>;
+
+export function resolveRunmatConfig(source: string, format: string): any;
+
+/**
+ * Run a complete immutable test plan through the portable Rust coordinator.
+ * JavaScript owns only worker construction, transport, termination, and host
+ * storage; it does not implement scheduling or lifecycle policy.
+ */
+export function runTests(input: any, backend: any): Promise<any>;
+
+/**
+ * Run tests and project each canonical coordinator event to JavaScript as it
+ * occurs. The callback is a projection only; scheduling, lifecycle, results,
+ * and report construction remain owned by the portable coordinator.
+ */
+export function runTestsWithEvents(input: any, backend: any, observer: any): Promise<any>;
+
 export function selectFigure(handle: number): void;
 
 export function setGeometryScenePresentation(surface_id: number, presentation: any): void;
@@ -120,18 +273,31 @@ export function unsubscribeStdout(id: number): void;
 
 export function unsubscribeTraceEvents(id: number): void;
 
+export function validateGitSnapshot(value: any): any;
+
+export function validateProjectHandoff(value: any): any;
+
+/**
+ * Verify signed Server admission evidence under browser-local trust policy and
+ * return the exact HPKE recipient accepted for the run.
+ */
+export function verifyExecutionEndpointIdentity(evidence: any, policy: any): any;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly initRunMat: (a: any) => any;
-    readonly subscribeStdout: (a: any) => [number, number, number];
-    readonly unsubscribeStdout: (a: number) => void;
-    readonly subscribeRuntimeLog: (a: any) => [number, number, number];
-    readonly setLogFilter: (a: number, b: number) => [number, number];
-    readonly unsubscribeRuntimeLog: (a: number) => void;
-    readonly subscribeTraceEvents: (a: any) => [number, number, number];
-    readonly unsubscribeTraceEvents: (a: number) => void;
+    readonly verifyExecutionEndpointIdentity: (a: any, b: any) => [number, number, number];
+    readonly executionRelayProtocols: (a: number, b: number) => [number, number, number];
+    readonly __wbg_browserremotesubmission_free: (a: number, b: number) => void;
+    readonly browserremotesubmission_new: (a: number, b: number, c: any) => [number, number, number];
+    readonly browserremotesubmission_endpointFingerprint: (a: number) => [number, number];
+    readonly browserremotesubmission_directQuicEndpoints: (a: number) => [number, number, number];
+    readonly browserremotesubmission_sealRunKeyEnvelope: (a: number, b: number) => [number, number, number, number];
+    readonly browserremotesubmission_sealRunKeyForRecipient: (a: number, b: any, c: number) => [number, number, number, number];
+    readonly browserremotesubmission_encryptObject: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint, k: number) => [number, number, number, number];
+    readonly browserremotesubmission_decryptObject: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly browserremotesubmission_createFrameSession: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly renderCurrentFigureScene: (a: number) => [number, number];
     readonly createPlotSurface: (a: any) => any;
     readonly resizePlotSurface: (a: number, b: number, c: number, d: number) => [number, number];
@@ -161,6 +327,7 @@ export interface InitOutput {
     readonly plotRendererReady: () => number;
     readonly onFigureEvent: (a: any) => [number, number];
     readonly __wbg_runmatwasm_free: (a: number, b: number) => void;
+    readonly runmatwasm_packageCacheSnapshot: (a: number) => any;
     readonly runmatwasm_executeRequest: (a: number, b: any) => any;
     readonly runmatwasm_previewGeometry: (a: number, b: number, c: number, d: any) => any;
     readonly runmatwasm_disposeGeometryPreview: (a: number, b: number, c: number) => [number, number];
@@ -170,6 +337,11 @@ export interface InitOutput {
     readonly runmatwasm_runFeaStudy: (a: number, b: number, c: number, d: number, e: number) => any;
     readonly runmatwasm_feaField: (a: number, b: number, c: number, d: number, e: number, f: any) => [number, number, number];
     readonly runmatwasm_resetSession: (a: number) => [number, number];
+    readonly runmatwasm_installProjectHandoff: (a: number, b: any) => [number, number, number];
+    readonly runmatwasm_clearProjectHandoff: (a: number) => [number, number];
+    readonly runmatwasm_projectRevision: (a: number) => [number, number, number];
+    readonly runmatwasm_discoverTests: (a: number, b: any) => [number, number, number];
+    readonly runmatwasm_prepareTests: (a: number, b: any, c: any) => [number, number, number];
     readonly runmatwasm_cancelExecution: (a: number) => void;
     readonly runmatwasm_setLanguageCompat: (a: number, b: number, c: number) => void;
     readonly runmatwasm_setInputHandler: (a: number, b: any) => [number, number];
@@ -194,15 +366,65 @@ export interface InitOutput {
     readonly runmatwasm_memoryUsage: (a: number) => [number, number, number];
     readonly runmatwasm_setFsProvider: (a: number, b: any) => [number, number];
     readonly runmatwasm_dispose: (a: number) => void;
+    readonly subscribeStdout: (a: any) => [number, number, number];
+    readonly unsubscribeStdout: (a: number) => void;
+    readonly subscribeRuntimeLog: (a: any) => [number, number, number];
+    readonly setLogFilter: (a: number, b: number) => [number, number];
+    readonly unsubscribeRuntimeLog: (a: number) => void;
+    readonly subscribeTraceEvents: (a: any) => [number, number, number];
+    readonly unsubscribeTraceEvents: (a: number) => void;
     readonly newFigureHandle: () => number;
     readonly currentFigureHandle: () => number;
     readonly selectFigure: (a: number) => void;
     readonly destroyPlotSurface: (a: number) => void;
+    readonly executeProgramArtifact: (a: any) => any;
+    readonly projectTestLayout: (a: any) => [number, number, number];
+    readonly freezeTestSnapshot: (a: any) => [number, number, number];
+    readonly runTests: (a: any, b: any) => any;
+    readonly runTestsWithEvents: (a: any, b: any, c: any) => any;
+    readonly runmatwasm_executeTestAttempt: (a: number, b: any) => any;
+    readonly packageCacheAcquireLease: (a: any, b: any) => any;
+    readonly packageCacheRenewLease: (a: any, b: any, c: bigint) => any;
+    readonly packageCacheReleaseLease: (a: any, b: any) => any;
+    readonly packageCacheStatus: (a: any) => any;
+    readonly packageCacheGc: (a: any, b: bigint, c: bigint) => any;
+    readonly decodePackageLock: (a: number, b: number) => [number, number, number];
+    readonly encodePackageLock: (a: any) => [number, number, number, number];
+    readonly planGitAcquisition: (a: any) => [number, number, number];
+    readonly buildGitSnapshot: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly validateGitSnapshot: (a: any) => [number, number, number];
+    readonly resolveProject: (a: any, b: any, c: any) => any;
+    readonly projectHandoff: (a: number, b: number) => any;
+    readonly projectRevision: (a: number, b: number) => any;
+    readonly validateProjectHandoff: (a: any) => [number, number, number];
+    readonly handoffFromFrozenProject: (a: any) => [number, number, number];
+    readonly resolveRunmatConfig: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly patchRunmatConfig: (a: number, b: number, c: number, d: number, e: any) => [number, number, number, number];
+    readonly migrateLegacyRunmatConfig: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly migrateLegacyRunmatConfigInto: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly __wbg_browserexecutionrecipient_free: (a: number, b: number) => void;
+    readonly browserexecutionrecipient_new: (a: number, b: number, c: bigint, d: bigint) => [number, number, number];
+    readonly browserexecutionrecipient_recipient: (a: number) => [number, number, number];
+    readonly browserexecutionrecipient_seal: (a: number, b: any, c: number, d: number) => [number, number, number];
+    readonly browserexecutionrecipient_open: (a: number, b: any) => [number, number, number, number];
+    readonly browserexecutionrecipient_openRunKey: (a: number, b: any, c: number, d: number, e: number) => [number, number, number];
+    readonly __wbg_browserrunkey_free: (a: number, b: number) => void;
+    readonly browserrunkey_new: () => [number, number, number];
+    readonly browserrunkey_sealForRecipient: (a: number, b: any, c: number, d: number, e: number) => [number, number, number];
+    readonly browserrunkey_seal: (a: number, b: any, c: number, d: number) => [number, number, number];
+    readonly browserrunkey_open: (a: number, b: any) => [number, number, number, number];
+    readonly browserrunkey_createFrameSession: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly __wbg_browserencryptedframesession_free: (a: number, b: number) => void;
+    readonly browserencryptedframesession_seal: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly browserencryptedframesession_open: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly buildExecutionBundle: (a: any, b: any, c: number, d: number) => any;
+    readonly materializeExecutionBundle: (a: number, b: number) => any;
+    readonly initRunMat: (a: any) => any;
     readonly wasm_bindgen__convert__closures_____invoke__h0fd58337c3bb7841: (a: number, b: number, c: any) => [number, number];
     readonly wasm_bindgen__convert__closures_____invoke__h554464018ada0f86: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hb871e9c5faa9fe3a: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__ha4d91ca97578936f: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hb871e9c5faa9fe3a_3: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h6e5155eec27884fe: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hfc24b3905a218ecf: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h6e5155eec27884fe_3: (a: number, b: number, c: any) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;