wstp-node 0.7.3 → 1.0.0

package/README.md

@@ -496,13 +496,36 @@ immediately with `"Session is closed"`.
 
 ---
 
-### `isOpen` / `isDialogOpen`
+### `isOpen` / `isDialogOpen` / `kernelState`
 
 ```ts
 session.isOpen:       boolean  // true while the link is open and the kernel is running
 session.isDialogOpen: boolean  // true while inside a Dialog[] subsession
+session.kernelState:  string   // multi-dimensional state snapshot
 ```
 
+`kernelState` returns a space-separated `dimension=value` string covering five
+independent state dimensions that can be active in parallel:
+
+| Dimension  | Values                                | Description |
+|------------|---------------------------------------|-------------|
+| `activity` | `Idle`, `Eval`, `SubIdle`, `WhenIdle` | Main job the kernel is doing |
+| `dialog`   | `None`, `UserDialog`, `DynDialog`     | Dialog subsession type |
+| `sub`      | `None`, `DynExpr`, `SubBusy`          | Sub-work inside a dialog |
+| `abort`    | `None`, `Aborting`                    | Abort in progress |
+| `link`     | `Alive`, `Dead`                       | WSTP link health |
+
+Example:
+```ts
+console.log(session.kernelState);
+// "activity=Eval dialog=DynDialog sub=DynExpr abort=None link=Alive"
+```
+
+Every transition is logged via `setDiagHandler` with a `[State:<dim>]` category
+tag (e.g. `[State:activity] Idle -> Eval (MaybeStartNext:eval)`).  Internal
+safeguards use these dimensions to prevent dangerous operations — e.g. blocking
+`WSInterruptMessage` when the link is dead or an abort is already in progress.
+
 ---
 
 ### Dynamic eval API

package/index.d.ts

@@ -295,6 +295,28 @@ export class WstpSession {
      */
     readonly kernelPid: number;
 
+    /**
+     * Multi-dimensional kernel state snapshot as a human-readable string.
+     *
+     * Returns a space-separated list of `dimension=value` pairs covering
+     * five independent state dimensions:
+     *
+     * | Dimension  | Values                                        |
+     * |------------|-----------------------------------------------|
+     * | `activity` | `Idle`, `Eval`, `SubIdle`, `WhenIdle`          |
+     * | `dialog`   | `None`, `UserDialog`, `DynDialog`              |
+     * | `sub`      | `None`, `DynExpr`, `SubBusy`                   |
+     * | `abort`    | `None`, `Aborting`                             |
+     * | `link`     | `Alive`, `Dead`                                |
+     *
+     * Example: `"activity=Eval dialog=DynDialog sub=DynExpr abort=None link=Alive"`
+     *
+     * Dimensions are independent — e.g. `activity=Eval` and `dialog=DynDialog`
+     * can be active simultaneously.  Every transition is logged via `setDiagHandler`
+     * with the `[State:<dim>]` category tag.
+     */
+    readonly kernelState: string;
+
     // ── Dynamic eval API ────────────────────────────────────────────────────
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wstp-node",
-  "version": "0.7.3",
+  "version": "1.0.0",
   "description": "Native Node.js addon for Wolfram/Mathematica WSTP — kernel sessions with evaluation queue, streaming Print/messages, Dialog subsessions, and side-channel WstpReader",
   "main": "build/Release/wstp.node",
   "types": "index.d.ts",

package/src/addon.cc

@@ -1,5 +1,5 @@
 // =============================================================================
-// wstp-backend/src/addon.cc   (v0.7.2 — thin entry point after refactor)
+// wstp-backend/src/addon.cc   (v1.0.0 — thin entry point after refactor)
 //
 // This file is intentionally minimal.  All implementation lives in the
 // other source files listed in binding.gyp:
@@ -47,7 +47,7 @@ Napi::Object InitModule(Napi::Env env, Napi::Object exports) {
     WstpReader::Init(env, exports);
     exports.Set("setDiagHandler",
         Napi::Function::New(env, SetDiagHandler, "setDiagHandler"));
-    exports.Set("version", Napi::String::New(env, "0.7.2"));
+    exports.Set("version", Napi::String::New(env, "1.0.0"));
     return exports;
 }