@tellegen/engine 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Samuel Talkington and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @tellegen/engine
+
+Browser package for tellegen case ingestion, wasm solves, Study lifecycle calls, previews, commits, and sensitivity queries.
+
+The package has no SvelteKit dependency. Host apps import the top level package and use either the direct functions or the `browserWasmTransport` facade:
+
+```ts
+import { browserWasmTransport, createStudy, solveJson } from "@tellegen/engine";
+```
+
+The wasm files are resolved relative to the package module. Host apps must serve
+package asset files from `node_modules`.
+
+## Contracts
+
+The public contract version is `CONTRACT_VERSION`, which matches the package version. `CONTRACT_SOURCE_SHA256` records the `crates/tellegen/src/api.rs` content used to generate `src/generated/contracts.ts`.
+
+Run the generator after Rust API changes:
+
+```sh
+npm run contracts
+```
+
+CI runs `npm run build:engine` from the repository root, and that runs
+`contracts:check`. A stale generated contract fails the build.
+
+Breaking contract changes:
+
+- Removing or renaming exported request or response fields.
+- Changing field units, enum tags, formulation ids, solve status tags, or sensitivity operand/parameter shapes.
+- Tightening a field from optional to required.
+
+Nonbreaking changes:
+
+- Adding optional fields.
+- Adding new formulation ids, solve statuses, operands, or parameters when existing values keep their meaning.
+
+## Release
+
+Build and inspect the package from the repository root:
+
+```sh
+npm ci
+npm run wasm
+npm run build:engine
+npm run pack:engine
+```
+
+The first framework release publishes this package and `@tellegen/svelte`.
+`@tellegen/engine` is the lower level browser package for custom UIs and for the
+Svelte package. The hosted demo under `apps/web` is private and consumes
+`@tellegen/svelte` through the same workspace file dependency used by the local
+examples.

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/** Error helpers shared by the main-thread loader and the worker entry. Kept
+ * separate from module.ts so the worker bundle never touches the dynamic
+ * import there: the worker must stay a single chunk (Vite's default worker
+ * format cannot code-split). */
+export declare function errorText(e: unknown): string;
+export declare function isPermanentWasmLoadFailure(message: string): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;gCAGgC;AAEhC,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAanE"}

package/dist/errors.js

@@ -0,0 +1,20 @@
+/** Error helpers shared by the main-thread loader and the worker entry. Kept
+ * separate from module.ts so the worker bundle never touches the dynamic
+ * import there: the worker must stay a single chunk (Vite's default worker
+ * format cannot code-split). */
+export function errorText(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+export function isPermanentWasmLoadFailure(message) {
+    // Latch only genuine browser-capability failures the engine module can
+    // never recover from in this browser: no WebAssembly, or an opcode the
+    // engine rejects. Transient fetch or
+    // instantiate failures (offline, 503, aborted navigation) routinely carry
+    // the .wasm URL or "Failed to fetch" in their message, so keying on the bare
+    // word "wasm"/"compile" wrongly disables the engine for the whole session.
+    // Those stay retryable.
+    if (/Failed to fetch|NetworkError|load failed|aborted|ERR_/i.test(message))
+        return false;
+    return /CompileError|LinkError|invalid opcode|unsupported|relaxed|WebAssembly is not defined/i.test(message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;gCAGgC;AAEhC,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,uEAAuE;IACvE,uEAAuE;IACvE,qCAAqC;IACrC,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,wBAAwB;IACxB,IAAI,wDAAwD,CAAC,IAAI,CAAC,OAAO,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,OAAO,uFAAuF,CAAC,IAAI,CACjG,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/generated/contracts.d.ts

@@ -0,0 +1,225 @@
+export declare const CONTRACT_VERSION: "0.1.0";
+export declare const CONTRACT_SOURCE_SHA256: "d17b92b8b23874c858ccb26b1740f253c95d7cfd78d9511c847b57c2f6eae05e";
+export declare const FORMULATION_IDS: readonly ["dcpf", "dcopf", "acpf", "socwr", "acopf"];
+export type FormulationId = (typeof FORMULATION_IDS)[number];
+export declare const SOLVE_STATUSES: readonly ["optimal", "feasible"];
+export type SolveStatus = (typeof SOLVE_STATUSES)[number];
+export type BrowserFormulation = Extract<FormulationId, 'dcopf' | 'acopf' | 'socwr'>;
+export type Power = 'Active' | 'Reactive';
+export type End = 'From' | 'To';
+export type VoltageKind = 'Magnitude' | 'Angle' | 'Squared' | 'ProductReal' | 'ProductImag';
+export type CostTerm = 'Quadratic' | 'Linear';
+export type GB = 'Conductance' | 'Susceptance';
+export type Bound = 'Min' | 'Max';
+export type TapKind = 'Ratio' | 'PhaseShift';
+export type Mode = 'Forward' | 'Adjoint' | 'Auto';
+export type Operand = {
+    Price: Power;
+} | {
+    Dispatch: Power;
+} | {
+    Flow: {
+        power: Power;
+        end: End;
+    };
+} | {
+    Voltage: VoltageKind;
+};
+export type Parameter = {
+    Demand: Power;
+} | {
+    Cost: CostTerm;
+} | 'LineLimit' | {
+    SeriesAdmittance: GB;
+} | {
+    ShuntAdmittance: GB;
+} | {
+    VoltageBound: Bound;
+} | {
+    GenBound: {
+        power: Power;
+        bound: Bound;
+    };
+} | {
+    Transformer: TapKind;
+} | 'Switching';
+export type ElementId = {
+    Bus: number;
+} | {
+    Branch: number;
+} | {
+    Generator: number;
+};
+export interface SensRequest {
+    operand: Operand;
+    parameter: Parameter;
+    indices?: number[] | null;
+    mode?: Mode;
+}
+export interface Edits {
+    deltas?: DemandDeltas;
+    rates?: BranchRatingDeltas;
+}
+export interface SolveOptions {
+    shed?: boolean;
+    warm_start?: boolean;
+}
+export interface SolveRequest {
+    formulation?: FormulationId;
+    edits?: Edits;
+    sensitivities?: SensRequest[];
+    options?: SolveOptions;
+}
+export interface SolveIteration {
+    iter: number;
+    objective: number;
+    inf_pr: number;
+    inf_du: number;
+}
+export type NewtonIterations = {
+    count: number;
+    residual: number;
+};
+export type Iterations = SolveIteration[] | NewtonIterations;
+export interface BusScalar {
+    bus: number;
+    /** powerio row uid, present when the solved network carried uids. */
+    uid?: string;
+    value: number;
+}
+export interface BusInjection {
+    bus: number;
+    uid?: string;
+    p: number;
+    q: number;
+}
+export interface BranchFlow {
+    branch: number;
+    /** powerio row uid, present when the solved network carried uids. */
+    uid?: string;
+    pf: number;
+    loading: number;
+    qf?: number;
+    pt?: number;
+    qt?: number;
+}
+export interface GenDispatch {
+    gen: number;
+    pg: number;
+    qg?: number;
+}
+export interface RowMeta {
+    operand: Operand;
+    element: ElementId;
+    index: number;
+}
+export interface ColMeta {
+    parameter: Parameter;
+    element: ElementId;
+    index: number;
+}
+export interface SensitivityMatrix {
+    values: number[][];
+    rows: RowMeta[];
+    cols: ColMeta[];
+    units: string;
+}
+export interface SolveResponse {
+    formulation: FormulationId;
+    status: SolveStatus;
+    objective?: number;
+    iterations?: Iterations;
+    lmp?: BusScalar[];
+    lmp_q?: BusScalar[];
+    vm?: BusScalar[];
+    va?: BusScalar[];
+    w?: BusScalar[];
+    injections?: BusInjection[];
+    flows?: BranchFlow[];
+    dispatch?: GenDispatch[];
+    sensitivities?: SensitivityMatrix[];
+}
+export interface ProblemCaps {
+    formulation: FormulationId;
+    available: boolean;
+    blocks: string[];
+    operands?: Operand[];
+    parameters?: Parameter[];
+}
+export interface NetworkBus {
+    id: number;
+    /** powerio row uid; always present on an ingested case, absent on older payloads. */
+    uid?: string;
+    lon: number;
+    lat: number;
+    demand_mw: number;
+    gen_mw: number;
+}
+export interface NetworkBranch {
+    id: number;
+    /** powerio row uid; always present on an ingested case, absent on older payloads. */
+    uid?: string;
+    from: number;
+    to: number;
+    rate_mw: number;
+    status: number;
+    path: [number, number][];
+}
+export interface Network {
+    id: string;
+    name: string;
+    base_mva: number;
+    synthetic_coords: boolean;
+    buses: NetworkBus[];
+    branches: NetworkBranch[];
+}
+export interface Solution {
+    objective: number;
+    lmp: {
+        bus: number;
+        usd_per_mwh: number;
+    }[];
+    va: {
+        bus: number;
+        value: number;
+    }[];
+    w: {
+        bus: number;
+        value: number;
+    }[];
+    flows: {
+        branch: number;
+        mw: number;
+        loading: number;
+    }[];
+    dispatch: {
+        gen: number;
+        mw: number;
+    }[];
+}
+export interface SensitivityColumn {
+    case: string;
+    operand: string;
+    parameter: string;
+    /** The selected source bus, for a bus-axis parameter column (∂LMP/∂d). */
+    bus?: number;
+    /** The selected source branch, for a branch-axis parameter column (∂LMP/∂fmax). */
+    branch?: number;
+    units: string;
+    values: {
+        bus: number;
+        value: number;
+    }[];
+}
+export interface CaseSummary {
+    id: string;
+    name: string;
+    n_bus: number;
+    n_branch: number;
+    n_gen: number;
+}
+/** Keys are element keys: the original numeric id, or the powerio row uid
+ * string (e.g. "buses:1") when the case carries uids. */
+export type DemandDeltas = Record<number | string, number>;
+export type BranchRatingDeltas = Record<number | string, number>;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/generated/contracts.d.ts.map

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

package/dist/generated/contracts.js

@@ -0,0 +1,8 @@
+// Generated by packages/engine/scripts/generate-contracts.mjs.
+// Rust source: crates/tellegen/src/api.rs
+// Rust source sha256: d17b92b8b23874c858ccb26b1740f253c95d7cfd78d9511c847b57c2f6eae05e
+export const CONTRACT_VERSION = "0.1.0";
+export const CONTRACT_SOURCE_SHA256 = "d17b92b8b23874c858ccb26b1740f253c95d7cfd78d9511c847b57c2f6eae05e";
+export const FORMULATION_IDS = ["dcpf", "dcopf", "acpf", "socwr", "acopf"];
+export const SOLVE_STATUSES = ["optimal", "feasible"];
+//# sourceMappingURL=contracts.js.map

package/dist/generated/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/generated/contracts.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0CAA0C;AAC1C,uFAAuF;AAEvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,kEAA2E,CAAC;AAElH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,EAAC,OAAO,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAC,UAAU,CAAU,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,13 @@
+/** Where engine requests execute. The worker host is the default in browsers:
+ * the wasm instance lives in a dedicated module worker, so a multi-second
+ * solve never blocks the page. The direct host runs the same requests on the
+ * calling thread; it serves environments without workers (SSR, Node) and is
+ * the replay target when the worker errors before its first response — the
+ * failure mode of a browser that cannot run module workers. */
+import { type EngineRequest } from "./protocol.js";
+export interface EngineHost {
+    call(req: EngineRequest): Promise<string | null>;
+}
+export declare const directHost: EngineHost;
+export declare function engineHost(): EngineHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;+DAK+D;AAG/D,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClD;AAID,eAAO,MAAM,UAAU,EAAE,UAIxB,CAAC;AAwEF,wBAAgB,UAAU,IAAI,UAAU,CAGvC"}

package/dist/host.js

@@ -0,0 +1,95 @@
+/** Where engine requests execute. The worker host is the default in browsers:
+ * the wasm instance lives in a dedicated module worker, so a multi-second
+ * solve never blocks the page. The direct host runs the same requests on the
+ * calling thread; it serves environments without workers (SSR, Node) and is
+ * the replay target when the worker errors before its first response — the
+ * failure mode of a browser that cannot run module workers. */
+import { engineModule } from "./module.js";
+import { runRequest, } from "./protocol.js";
+const directStudies = new Map();
+export const directHost = {
+    async call(req) {
+        return runRequest(await engineModule(), directStudies, req);
+    },
+};
+class WorkerHost {
+    #worker;
+    #seq = 0;
+    #pending = new Map();
+    #answered = false;
+    /** Set once the worker is unusable: with a forward host when it never
+     * answered (requests reroute there), without one when it crashed mid
+     * session (requests reject; the next engineHost() spawns a fresh worker). */
+    #failed = null;
+    constructor(worker) {
+        this.#worker = worker;
+        worker.onmessage = (ev) => {
+            this.#answered = true;
+            const pending = this.#pending.get(ev.data.id);
+            if (!pending)
+                return;
+            this.#pending.delete(ev.data.id);
+            if (ev.data.ok)
+                pending.resolve(ev.data.value);
+            else
+                pending.reject(new Error(ev.data.error));
+        };
+        worker.onerror = () => this.#fail(new Error("engine worker failed"));
+        worker.onmessageerror = () => this.#fail(new Error("engine worker message failed"));
+    }
+    #fail(error) {
+        if (this.#failed)
+            return;
+        const pending = [...this.#pending.values()];
+        this.#pending.clear();
+        this.#worker.terminate();
+        if (!this.#answered) {
+            // The worker never started (module workers unsupported, script blocked):
+            // everything moves to the main thread, including the pending requests —
+            // their study handles stay valid because the caller allocated them.
+            this.#failed = { forward: directHost, error };
+            if (activeHost === this)
+                activeHost = directHost;
+            for (const p of pending)
+                directHost.call(p.req).then(p.resolve, p.reject);
+            return;
+        }
+        // A crash mid session loses the worker's studies; callers see their next
+        // call fail, drop the study handle, and rebuild against a fresh worker.
+        this.#failed = { forward: null, error };
+        if (activeHost === this)
+            activeHost = null;
+        for (const p of pending)
+            p.reject(error);
+    }
+    call(req) {
+        const failed = this.#failed;
+        if (failed) {
+            return failed.forward
+                ? failed.forward.call(req)
+                : Promise.reject(failed.error);
+        }
+        return new Promise((resolve, reject) => {
+            const id = ++this.#seq;
+            this.#pending.set(id, { req, resolve, reject });
+            const msg = { ...req, id };
+            this.#worker.postMessage(msg);
+        });
+    }
+}
+let activeHost = null;
+export function engineHost() {
+    activeHost ??= createHost();
+    return activeHost;
+}
+function createHost() {
+    if (typeof Worker === "undefined")
+        return directHost;
+    try {
+        return new WorkerHost(new Worker(new URL("./worker.js", import.meta.url), { type: "module" }));
+    }
+    catch {
+        return directHost;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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