@miadi/stateloom-web 0.2.0 → 0.2.2

package/server/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@miadi/stateloom-web-source",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@miadi/stateloom-web-source",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "dependencies": {
         "@miadi/stateloom-canvas": "file:../bridge-canvas",
         "@miadi/stateloom-client": "file:../bridge-client",

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/stateloom-web-source",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": true,
   "//": [
     "This is the designer's SOURCE and is never published — hence private: true.",

package/server/src/components/PropertiesPanel.tsx

@@ -116,6 +116,16 @@ export default function PropertiesPanel() {
             onChange={(e) => updateState(selection.id!, { description: e.target.value || undefined })}
           />
         </label>
+        {/* Prompt: what an agent is asked to resolve while the machine is in this state. */}
+        <label className="block">
+          <span className="text-xs text-gray-500">Prompt for the agent in this state</span>
+          <textarea
+            className="w-full bg-gray-800 border border-gray-700 rounded px-2 py-1 text-xs text-gray-200 h-20"
+            placeholder="What the agent resolves here, and how it opens…"
+            value={state.prompt ?? ""}
+            onChange={(e) => updateState(selection.id!, { prompt: e.target.value || undefined })}
+          />
+        </label>
         {/* Notes: what was said about this state, kept in the document for whoever opens it next. */}
         <label className="block">
           <span className="text-xs text-gray-500">Notes</span>

package/server/src/components/erd/ErdWorkspace.tsx

@@ -52,6 +52,7 @@ import {
   type LayoutBox,
   type StateMachineDefinition,
   type Viewport,
+  normalizeNotes,
 } from "@miadi/stateloom-protocol";
 import BoardBoundary from "@/components/BoardBoundary";
 import DocSwitcher from "@/components/DocSwitcher";
@@ -124,7 +125,7 @@ async function siblingMachines(docPath: string): Promise<Machine[]> {
     try {
       const body = await (await fetch(`/api/file${docQuery(path)}`, { cache: "no-store" })).json();
       const parsed = JSON.parse(body.content ?? "null");
-      const def = parsed?.stateMachine ?? parsed?.StateMachine ?? parsed;
+      const def = normalizeNotes(parsed?.stateMachine ?? parsed?.StateMachine ?? parsed);
       if (def?.state) machines.push({ path, def });
     } catch {
       // An unreadable sibling is skipped; it is not this document's problem.
@@ -186,7 +187,7 @@ export default function ErdWorkspace() {
       const path: string = body.path ?? "";
       let loaded: EntityRelationshipDefinition | null = null;
       try {
-        const parsed = body.content ? JSON.parse(body.content) : null;
+        const parsed = body.content ? normalizeNotes(JSON.parse(body.content)) : null;
         if (isErdDefinition(parsed)) loaded = { ...parsed, relationships: parsed.relationships ?? [] };
       } catch {
         // Falls through to the unreadable-document message below.

package/server/src/components/sequence/SequenceWorkspace.tsx

@@ -58,6 +58,7 @@ import {
   type SqdMessage,
   type StateMachineDefinition,
   type Viewport,
+  normalizeNotes,
 } from "@miadi/stateloom-protocol";
 import DocSwitcher from "@/components/DocSwitcher";
 import IssueIcon from "@/components/IssueIcon";
@@ -141,7 +142,7 @@ export default function SequenceWorkspace() {
       const path: string = body.path ?? "";
       let loaded: SequenceDefinition | null = null;
       try {
-        const parsed = body.content ? JSON.parse(body.content) : null;
+        const parsed = body.content ? normalizeNotes(JSON.parse(body.content)) : null;
         if (isSequenceDefinition(parsed)) loaded = parsed;
       } catch {
         // Falls through to the message below.

package/server/src/lib/systemLoad.ts

@@ -24,6 +24,7 @@ import {
   type StateMachineDefinition,
   type SystemDefinition,
   type SystemReconcile,
+  normalizeNotes,
 } from "@miadi/stateloom-protocol";
 import { createBridgeClient } from "@miadi/stateloom-client";
 import { docQuery } from "./docParam";
@@ -94,7 +95,7 @@ export async function loadSystem(systemPath: string): Promise<LoadedSystem> {
   if (!read.exists || !read.content) return { ...empty, error: `${systemPath} does not exist` };
   let def: SystemDefinition | null = null;
   try {
-    const parsed = JSON.parse(read.content);
+    const parsed = normalizeNotes(JSON.parse(read.content));
     if (isSystemDefinition(parsed)) def = parsed;
   } catch {
     // Reported below.
@@ -119,9 +120,9 @@ export async function loadSystem(systemPath: string): Promise<LoadedSystem> {
           const parsed = JSON.parse(doc.content);
           if (kind === "machine" && parsed && (parsed.stateMachine || parsed.StateMachine)) {
             wrapped[m.path] = true;
-            return { path: m.path, kind, def: parsed.stateMachine ?? parsed.StateMachine };
+            return { path: m.path, kind, def: normalizeNotes(parsed.stateMachine ?? parsed.StateMachine) };
           }
-          return { path: m.path, kind, def: parsed };
+          return { path: m.path, kind, def: normalizeNotes(parsed) };
         } catch (e) {
           return { path: m.path, kind, def: null, error: `not JSON: ${e instanceof Error ? e.message : String(e)}` };
         }

package/server/src/store/useDesignerStore.ts

@@ -1,5 +1,5 @@
 import { create } from "zustand";
-import { applyPatchOps } from "@miadi/stateloom-protocol";
+import { applyPatchOps, normalizeNotes } from "@miadi/stateloom-protocol";
 import type { PatchOp, Presence } from "@miadi/stateloom-protocol";
 import { autoLayout as deriveLayout, IDENTITY_VIEWPORT } from "@miadi/stateloom-react";
 import type { Viewport } from "@miadi/stateloom-react";
@@ -350,6 +350,13 @@ function autoLayout(def: StateMachineDefinition, existing: DesignerLayout): Desi
 
 const MAX_UNDO = 50;
 
+/**
+ * Whether the document on disk was written bare (no `stateMachine` wrapper).
+ * Module state, not store state: it says how to write the file back, nothing
+ * the interface shows.
+ */
+let bareShape = false;
+
 export const useDesignerStore = create<DesignerState>((set, get) => ({
   definition: createEmptyDefinition(),
   layout: autoLayout(createEmptyDefinition(), createDefaultLayout()),
@@ -667,7 +674,8 @@ export const useDesignerStore = create<DesignerState>((set, get) => ({
   loadFromJson: (json, fileName) => {
     try {
       const parsed = JSON.parse(json);
-      const def: StateMachineDefinition = parsed.stateMachine ?? parsed.StateMachine ?? parsed;
+      const def: StateMachineDefinition = normalizeNotes(parsed.stateMachine ?? parsed.StateMachine ?? parsed);
+      bareShape = !!parsed && typeof parsed === "object" && "state" in parsed && !("stateMachine" in parsed) && !("StateMachine" in parsed);
       const layout = autoLayout(def, createDefaultLayout());
       const rootName = def.state?.name ?? "Root";
       set({
@@ -689,13 +697,15 @@ export const useDesignerStore = create<DesignerState>((set, get) => ({
 
   exportJson: () => {
     const { definition } = get();
-    return JSON.stringify({ stateMachine: definition }, null, 2);
+    // A file that was written bare stays bare, so a save is a small diff.
+    return JSON.stringify(bareShape ? definition : { stateMachine: definition }, null, 2);
   },
 
   applyRemote: (json, mtime, fileName) => {
     try {
       const parsed = JSON.parse(json);
-      const def: StateMachineDefinition = parsed.stateMachine ?? parsed.StateMachine ?? parsed;
+      const def: StateMachineDefinition = normalizeNotes(parsed.stateMachine ?? parsed.StateMachine ?? parsed);
+      bareShape = !!parsed && typeof parsed === "object" && "state" in parsed && !("stateMachine" in parsed) && !("StateMachine" in parsed);
       const layout = autoLayout(def, get().layout);
       const rootName = def.state?.name ?? "Root";
 

package/server/src/types/definition.ts

@@ -101,6 +101,8 @@ export interface StateDef {
   description?: string;
   /** Working notes about this state: the conversation about it, where `description` says what it is. */
   notes?: string;
+  /** What an agent is asked to resolve while the machine is in this state. Ignored by engines and codegen. */
+  prompt?: string;
   onEntry?: { actions: ActionDef[] };
   onExit?: { actions: ActionDef[] };
   transitions?: TransitionDef[];

package/server/stateloom-web.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.2.0",
-  "designer": "0.2.0",
+  "package": "0.2.2",
+  "designer": "0.2.2",
   "next": "16.1.6"
 }