@tellegen/engine 0.1.1 → 0.3.0

package/README.md

@@ -1,16 +1,61 @@
 # @tellegen/engine
 
-Browser package for tellegen case ingestion, wasm solves, Study lifecycle calls, previews, commits, and sensitivity queries.
+Parses cases, runs WebAssembly solves, and exposes `Study` preview, commit, and
+sensitivity calls in browsers.
 
 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";
+import {
+  browserWasmTransport,
+  createStudy,
+  ingestJsonDrop,
+  solveModule,
+} from "@tellegen/engine";
 ```
 
 The wasm files are resolved relative to the package module. Host apps must serve
 package asset files from `node_modules`.
 
+## Browser Ingestion
+
+Case and JSON entry points accept the original bytes:
+
+```ts
+import { ingestCase, ingestJsonDrop } from "@tellegen/engine";
+
+const bytes = new Uint8Array(await file.arrayBuffer());
+const casePayload = await ingestCase(bytes, "raw");
+const jsonPayload = await ingestJsonDrop(bytes);
+```
+
+Every solvable ingest payload includes `module_json`, a generation-2 PowerIO
+IR module. Pass that value to `createStudy`, `solveModule`, and geographic
+transforms. The engine does not expose a second network JSON boundary.
+
+`ingestJsonDrop(bytes)` classifies and parses JSON in one call. Its
+`IngestedJsonDrop` result is discriminated by `kind`: PowerIO modules have a
+`null` format; transmission and distribution results carry the selected
+format; `ambiguous` and `unknown` results have a `null` payload. Historical
+bare model JSON is now `unknown`; regenerate it as `pio-ir` from source data.
+
+Every API that accepts a byte buffer rejects inputs larger than
+`MAX_ENGINE_INPUT_BYTES` (128 MiB) before worker dispatch.
+
+## Migrating To 0.2
+
+- Pass `Uint8Array` to `ingestCase`. For an existing string, use
+  `new TextEncoder().encode(text)`.
+- Replace `classifyJson(text)` with `await classifyJson(bytes)`. It now returns
+  `{ kind, format }` instead of a kind string.
+- If migrating code that imported `isStudyPackageText` from `@tellegen/svelte`,
+  use `await ingestJsonDrop(bytes)`. A stored document reports `kind: "module"`;
+  its payload determines whether it contains a supported balanced or
+  multiconductor value.
+- Update `JsonDropKind` handling: `bmopf` and `pmd` are now
+  `kind: "distribution"` with a `format`; `not-json` is `unknown`; and
+  `transmission` and `ambiguous` are additional outcomes.
+
 ## 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`.
@@ -46,8 +91,7 @@ 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.
+Svelte package. It releases through Changesets with the other npm packages. 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/generated/contracts.d.ts

@@ -1,10 +1,10 @@
-export declare const CONTRACT_VERSION: "0.1.1";
-export declare const CONTRACT_SOURCE_SHA256: "d17b92b8b23874c858ccb26b1740f253c95d7cfd78d9511c847b57c2f6eae05e";
+export declare const CONTRACT_VERSION: "0.3.0";
+export declare const CONTRACT_SOURCE_SHA256: "9728ba356f32e4174214292aa200f079d40ddad33282e2955e8e1def71c03c68";
 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 BrowserFormulation = Extract<FormulationId, 'dcopf' | 'acpf' | 'acopf' | 'socwr'>;
 export type Power = 'Active' | 'Reactive';
 export type End = 'From' | 'To';
 export type VoltageKind = 'Magnitude' | 'Angle' | 'Squared' | 'ProductReal' | 'ProductImag';
@@ -60,15 +60,10 @@ 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;
@@ -104,6 +99,7 @@ export interface BranchFlow {
     qt?: number;
 }
 export interface GenDispatch {
+    bus?: number;
     gen: number;
     pg: number;
     qg?: number;
@@ -148,8 +144,13 @@ export interface ProblemCaps {
 }
 export interface NetworkBus {
     id: number;
-    /** powerio row uid; always present on an ingested case, absent on older payloads. */
-    uid?: string;
+    name?: string | null;
+    area?: number;
+    zone?: number;
+    /** PowerIO row uid when the source carries one; older payloads omit the field. */
+    uid?: string | null;
+    /** False for a display-only row synthesized by analysis lowering. */
+    editable?: boolean;
     lon: number;
     lat: number;
     demand_mw: number;
@@ -157,8 +158,10 @@ export interface NetworkBus {
 }
 export interface NetworkBranch {
     id: number;
-    /** powerio row uid; always present on an ingested case, absent on older payloads. */
-    uid?: string;
+    /** PowerIO row uid when the source carries one; older payloads omit the field. */
+    uid?: string | null;
+    /** False for a display-only row synthesized by analysis lowering. */
+    editable?: boolean;
     from: number;
     to: number;
     rate_mw: number;
@@ -166,6 +169,8 @@ export interface NetworkBranch {
     path: [number, number][];
 }
 export interface Network {
+    coordinate_space?: 'geographic' | 'diagram';
+    model_details?: import('./study-contracts.js').ModelDetails | null;
     id: string;
     name: string;
     base_mva: number;
@@ -174,10 +179,14 @@ export interface Network {
     branches: NetworkBranch[];
 }
 export interface Solution {
-    objective: number;
-    lmp: {
+    objective: number | null;
+    prices: {
         bus: number;
-        usd_per_mwh: number;
+        value: number;
+    }[];
+    vm?: {
+        bus: number;
+        value: number;
     }[];
     va: {
         bus: number;
@@ -194,6 +203,7 @@ export interface Solution {
     }[];
     dispatch: {
         gen: number;
+        bus?: number;
         mw: number;
     }[];
 }
@@ -201,9 +211,9 @@ export interface SensitivityColumn {
     case: string;
     operand: string;
     parameter: string;
-    /** The selected source bus, for a bus-axis parameter column (∂LMP/∂d). */
+    /** The selected source bus, for a bus-axis price parameter column. */
     bus?: number;
-    /** The selected source branch, for a branch-axis parameter column (∂LMP/∂fmax). */
+    /** The selected source branch, for a branch-axis price parameter column. */
     branch?: number;
     units: string;
     values: {
@@ -212,10 +222,18 @@ export interface SensitivityColumn {
     }[];
 }
 export interface CaseSummary {
+    /** Configured cases remain listed when loading or solving fails. */
+    unavailable_reason?: string | null;
     id: string;
     name: string;
+    /** Canonical typed PowerIO bus rows. */
     n_bus: number;
+    /** Canonical typed PowerIO branch rows. */
     n_branch: number;
+    /** Rendered buses after analysis lowering; absent on older servers. */
+    n_analysis_bus?: number;
+    /** Rendered branches after analysis lowering; absent on older servers. */
+    n_analysis_branch?: number;
     n_gen: number;
 }
 /** Keys are element keys: the original numeric id, or the powerio row uid

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

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

package/dist/generated/contracts.js

@@ -1,8 +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.1";
-export const CONTRACT_SOURCE_SHA256 = "d17b92b8b23874c858ccb26b1740f253c95d7cfd78d9511c847b57c2f6eae05e";
+// Rust source sha256: 9728ba356f32e4174214292aa200f079d40ddad33282e2955e8e1def71c03c68
+export const CONTRACT_VERSION = "0.3.0";
+export const CONTRACT_SOURCE_SHA256 = "9728ba356f32e4174214292aa200f079d40ddad33282e2955e8e1def71c03c68";
 export const FORMULATION_IDS = ["dcpf", "dcopf", "acpf", "socwr", "acopf"];
 export const SOLVE_STATUSES = ["optimal", "feasible"];
 //# sourceMappingURL=contracts.js.map

package/dist/generated/study-contracts.d.ts

@@ -0,0 +1,426 @@
+export type ArtifactKind = "powerio_ir" | "geo_layer" | "evidence";
+export type Bound = "Min" | "Max";
+export type BranchFlow = {
+    "branch": number;
+    "loading": number;
+    "pf": number;
+    "pt"?: number | null;
+    "qf"?: number | null;
+    "qt"?: number | null;
+    "uid"?: string | null;
+};
+export type BranchScalar = {
+    "branch": number;
+    "value": number;
+};
+export type BusInjection = {
+    "bus": number;
+    "p": number;
+    "q": number;
+    "uid"?: string | null;
+};
+export type BusScalar = {
+    "bus": number;
+    "uid"?: string | null;
+    "value": number;
+};
+export type Camera = {
+    "bearing": number;
+    "center": Array<number>;
+    "pitch": number;
+    "zoom": number;
+};
+export type ColMeta = {
+    "element": ElementId;
+    "index": number;
+    "parameter": Parameter;
+};
+export type Comparison = {
+    "goal"?: string | null;
+    "improvement"?: number | null;
+    "left": string;
+    "left_value"?: number | null;
+    "left_view"?: (SolveResponse) | (null);
+    "right": string;
+    "right_value"?: number | null;
+    "right_view"?: (SolveResponse) | (null);
+};
+export type CostApproximation = {
+    "bus": number;
+    "generator": number;
+    "max_breakpoint_error": number;
+    "model_cost": GenCost;
+    "rms_breakpoint_error": number;
+    "source_cost": GenCost;
+};
+export type CostPreparation = "exact" | "convex_quadratic_fit";
+export type CostTerm = "Quadratic" | "Linear";
+export type CreateDisplay = {
+    "camera"?: (Camera) | (null);
+    "case_id": string;
+    "diagram_camera"?: (DiagramCamera) | (null);
+    "geo_layer": string;
+    "layers"?: Array<string>;
+};
+export type CreateStudy = {
+    "base_input"?: string | null;
+    "decisions"?: (DecisionSpace) | (null);
+    "display"?: (CreateDisplay) | (null);
+    "formulation": "dcopf" | "acpf" | "socwr";
+    "id": string;
+    "input": string;
+    "interpretation"?: string;
+    "model_details"?: (ModelDetails) | (null);
+    "objective"?: (StudyObjective) | (null);
+    "request"?: string;
+    "solution"?: string | null;
+    "success_value"?: number | null;
+    "title": string;
+    "view"?: (SolveResponse) | (null);
+};
+export type DecisionKind = "retain" | "reject" | "recommend" | "apply";
+export type DecisionRecord = {
+    "choice": DecisionKind;
+    "evidence": Array<string>;
+    "experiment": string;
+    "rationale": string;
+    "state"?: string | null;
+};
+export type DecisionSpace = {
+    "demand"?: (DemandConstraint) | (null);
+    "max_changed_elements": number;
+    "total_budget": number;
+    "variables": Array<DecisionVariable>;
+};
+export type DecisionVariable = {
+    "budget_weight": number;
+    "element": ElementKey;
+    "id": string;
+    "increment": number;
+    "intervention": Intervention;
+    "lower": number;
+    "upper": number;
+};
+export type DemandAdjustment = {
+    "bus": ElementKey;
+    "delta_mw": number;
+};
+export type DemandChange = {
+    "base_mw": number;
+    "bus": ElementKey;
+    "delta_mw": number;
+    "demand_mw": number;
+};
+export type DemandConstraint = ({
+    "increase_mw": number;
+    "kind": "placement";
+}) | ({
+    "kind": "redistribution";
+});
+export type DiagramCamera = {
+    "center": Array<number>;
+    "scale": number;
+};
+export type DisplayContext = {
+    "camera"?: (Camera) | (null);
+    "case_id": string;
+    "diagram_camera"?: (DiagramCamera) | (null);
+    "geography": string;
+    "layers"?: Array<string>;
+};
+export type ElementId = ({
+    "Bus": number;
+}) | ({
+    "Branch": number;
+}) | ({
+    "Generator": number;
+});
+export type ElementKey = (number) | (string);
+export type End = "From" | "To";
+export type ExperimentKind = "inspection" | "sensitivity" | "planning" | "counterfactual" | "challenge" | "historical_import";
+export type ExperimentRecord = {
+    "assessed_recommendation"?: string | null;
+    "evidence": Array<string>;
+    "goal"?: string | null;
+    "kind": ExperimentKind;
+    "rationale": string;
+    "result_states": Array<string>;
+    "solve_count": number;
+    "start_state"?: string | null;
+    "termination": string;
+    "trials": Array<TrialRecord>;
+};
+export type ExperimentSummary = {
+    "goal"?: string | null;
+    "id": string;
+    "kind": ExperimentKind;
+    "rationale": string;
+    "result_states": Array<string>;
+    "solve_count": number;
+    "start_state"?: string | null;
+    "termination": string;
+    "trial_count": number;
+};
+export type GB = "Conductance" | "Susceptance";
+export type GenCost = {
+    "coeffs": Array<number>;
+    "model": number;
+    "ncost": number;
+    "shutdown": number;
+    "startup": number;
+};
+export type GenDispatch = {
+    "bus"?: number | null;
+    "gen": number;
+    "pg": number;
+    "qg"?: number | null;
+};
+export type GoalRevision = {
+    "anchor_state": string;
+    "decisions": DecisionSpace;
+    "interpretation": string;
+    "objective": StudyObjective;
+    "parent"?: string | null;
+    "request": string;
+    "success_value"?: number | null;
+};
+export type Intervention = "branch_rating" | "active_demand";
+export type Iterations = (Array<SolveIteration>) | ({
+    "count": number;
+    "residual": number;
+});
+export type ModelDetails = {
+    "approximations": Array<CostApproximation>;
+    "method": CostPreparation;
+    "model": string;
+    "quantity": string;
+    "source": string;
+    "units": string;
+};
+export type ObservableWeight = {
+    "element": ElementKey;
+    "weight": number;
+};
+export type Operand = ({
+    "Price": Power;
+}) | ({
+    "Dispatch": Power;
+}) | ({
+    "Flow": {
+        "end": End;
+        "power": Power;
+    };
+}) | ({
+    "Voltage": VoltageKind;
+});
+export type Parameter = ({
+    "Demand": Power;
+}) | ({
+    "Cost": CostTerm;
+}) | ("LineLimit") | ({
+    "SeriesAdmittance": GB;
+}) | ({
+    "ShuntAdmittance": GB;
+}) | ({
+    "VoltageBound": Bound;
+}) | ({
+    "GenBound": {
+        "bound": Bound;
+        "power": Power;
+    };
+}) | ({
+    "Transformer": TapKind;
+}) | ("Switching");
+export type Power = "Active" | "Reactive";
+export type Problem = ("dcpf") | ("dcopf") | ("acpf") | ("socwr") | ("acopf");
+export type RowMeta = {
+    "element": ElementId;
+    "index": number;
+    "operand": Operand;
+};
+export type SearchOptions = {
+    "beam_width": number;
+    "max_iterations": number;
+    "max_solves": number;
+    "min_improvement": number;
+};
+export type SensitivityMatrix = {
+    "cols": Array<ColMeta>;
+    "rows": Array<RowMeta>;
+    "units": string;
+    "values": Array<Array<number>>;
+};
+export type SolveIteration = {
+    "inf_du": number;
+    "inf_pr": number;
+    "iter": number;
+    "objective": number;
+};
+export type SolveResponse = {
+    "dispatch"?: Array<GenDispatch> | null;
+    "flows"?: Array<BranchFlow> | null;
+    "formulation": Problem;
+    "injections"?: Array<BusInjection> | null;
+    "iterations"?: (Iterations) | (null);
+    "lmp"?: Array<BusScalar> | null;
+    "lmp_q"?: Array<BusScalar> | null;
+    "objective"?: number | null;
+    "sensitivities"?: Array<SensitivityMatrix>;
+    "status": SolveStatus;
+    "va"?: Array<BusScalar> | null;
+    "vm"?: Array<BusScalar> | null;
+    "w"?: Array<BusScalar> | null;
+    "wi"?: Array<BranchScalar> | null;
+    "wr"?: Array<BranchScalar> | null;
+};
+export type SolveStatus = ("optimal") | ("feasible");
+export type StateNode = {
+    "formulation": Problem;
+    "input": string;
+    "label": string;
+    "parent"?: string | null;
+    "solution"?: string | null;
+    "view"?: string | null;
+};
+export type StudyArtifact = {
+    "kind": ArtifactKind;
+    "text": string;
+};
+export type StudyBundle = {
+    "artifacts": {
+        [key: string]: StudyArtifact;
+    };
+    "document": StudyDocument;
+};
+export type StudyDocument = {
+    "active_goal"?: string | null;
+    "applied_state"?: string | null;
+    "base_input"?: string | null;
+    "decisions": {
+        [key: string]: DecisionRecord;
+    };
+    "display"?: (DisplayContext) | (null);
+    "experiment_order": Array<string>;
+    "experiments": {
+        [key: string]: ExperimentRecord;
+    };
+    "goals": {
+        [key: string]: GoalRevision;
+    };
+    "id": string;
+    "inspected_state"?: string | null;
+    "model_details"?: (ModelDetails) | (null);
+    "recommended_state"?: string | null;
+    "revision": number;
+    "schema": string;
+    "states": {
+        [key: string]: StateNode;
+    };
+    "title": string;
+    "version": number;
+};
+export type StudyObjective = ({
+    "kind": "weighted_observable";
+    "operand": Operand;
+    "weights": Array<ObservableWeight>;
+}) | ({
+    "kind": "sum";
+    "terms": Array<StudyObjective>;
+}) | ({
+    "expression": StudyObjective;
+    "factor": number;
+    "kind": "scale";
+}) | ({
+    "expression": StudyObjective;
+    "kind": "squared_target";
+    "target": number;
+}) | ({
+    "decision": string;
+    "kind": "intervention_penalty";
+    "linear": number;
+    "quadratic": number;
+});
+export type StudyOperation = ({
+    "kind": "inspect";
+    "state": string;
+}) | ({
+    "kind": "branch";
+    "rationale": string;
+    "state": string;
+}) | ({
+    "goal": GoalRevision;
+    "kind": "revise_goal";
+}) | ({
+    "goal"?: string | null;
+    "kind": "compare";
+    "left": string;
+    "right": string;
+}) | ({
+    "goal": string;
+    "kind": "propose";
+    "options": SearchOptions;
+    "rationale": string;
+    "state": string;
+}) | ({
+    "changes": Array<DemandAdjustment>;
+    "constrain_to_goal"?: boolean;
+    "goal"?: string | null;
+    "kind": "edit_demand";
+    "rationale": string;
+    "state": string;
+}) | ({
+    "goal"?: string | null;
+    "kind": "restore_base";
+    "rationale": string;
+    "state": string;
+}) | ({
+    "assessed_recommendation"?: string | null;
+    "evidence": unknown;
+    "goal"?: string | null;
+    "kind": "record_evidence";
+    "rationale": string;
+    "sensitivity": boolean;
+    "state": string;
+}) | ({
+    "base_state": string;
+    "goal"?: string | null;
+    "kind": "apply";
+    "proposal": string;
+    "state": string;
+});
+export type StudyOperationResult = {
+    "comparison"?: (Comparison) | (null);
+    "demand_changes"?: Array<DemandChange> | null;
+    "experiment"?: string | null;
+    "inspected_view"?: (SolveResponse) | (null);
+    "summary": StudySummary;
+};
+export type StudyRequest = {
+    "expected_revision": number;
+    "operation": StudyOperation;
+};
+export type StudySummary = {
+    "active_goal"?: [string, GoalRevision] | null;
+    "applied_state"?: string | null;
+    "experiment_count": number;
+    "id": string;
+    "inspected_state"?: string | null;
+    "recent_experiments": Array<ExperimentSummary>;
+    "recommended_state"?: string | null;
+    "revision": number;
+    "state_count": number;
+    "title": string;
+    "unavailable_historical_states": number;
+};
+export type TapKind = "Ratio" | "PhaseShift";
+export type TrialRecord = {
+    "accepted": boolean;
+    "changes": Array<number>;
+    "evidence": Array<string>;
+    "exact_value"?: number | null;
+    "failure"?: string | null;
+    "predicted_value"?: number | null;
+    "state"?: string | null;
+};
+export type VoltageKind = "Magnitude" | "Angle" | "Squared" | "ProductReal" | "ProductImag";
+//# sourceMappingURL=study-contracts.d.ts.map