@rainbow-robotics/plugin-ui 1.3.7 → 1.3.8-dev.0

package/dist/host-ui.d.ts

@@ -1,5 +1,19 @@
 import { ReactElement } from "react";
+/** One step of a program tree a plugin hands to the host Program page. */
+export interface PluginProgramStep {
+    /** Muscat command name, e.g. "MoveJ", "Point", "Wait", "Repeat", "Condition". */
+    command: string;
+    args?: Record<string, unknown>;
+    summary?: string;
+    children?: PluginProgramStep[];
+}
 export interface PluginUIServices {
+    /** Replaces the loaded program's main step tree (unsaved edit; the user saves). */
+    program: {
+        setSteps: (steps: PluginProgramStep[]) => Promise<void>;
+        /** Command catalog of the loaded robot (names, default args, nesting rules). */
+        getCatalog: () => Promise<unknown[]>;
+    };
     alert: (params: {
         title?: string;
         message: string;

package/dist/host-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-ui.d.ts","sourceRoot":"","sources":["../src/host-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,MAAM,EAAE;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE;YACX,GAAG,EAAE,MAAM,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC;SACZ,CAAC;KACH,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,MAAM,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE;YACX,GAAG,EAAE,MAAM,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC;SACZ,CAAC;KACH,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,MAAM,EAAE;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;QAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;KACtB,KAAK,IAAI,CAAC;CACZ;AAID,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAE5D;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,gBAAgB,CAOlD;AAED,8CAA8C;AAC9C,wBAAgB,KAAK,CACnB,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CACrB,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,sGAAsG;AACtG,wBAAgB,MAAM,CACpB,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAChD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AAED,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE5E"}
+{"version":3,"file":"host-ui.d.ts","sourceRoot":"","sources":["../src/host-ui.ts"],"names":[],"mappings":"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"}

package/dist/host-ui.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/host-ui.ts"],
-  "sourcesContent": ["import { ReactElement } from \"react\";\n\nexport interface PluginUIServices {\n  alert: (params: {\n    title?: string;\n    message: string;\n    buttonText?: string;\n  }) => Promise<void>;\n  confirm: (params: {\n    title?: string;\n    message: string;\n    buttonText?: {\n      yes: string;\n      no: string;\n    };\n  }) => Promise<boolean>;\n  prompt: (params: {\n    title?: string;\n    message: string;\n    value?: string;\n    placeholder?: string;\n    buttonText?: {\n      yes: string;\n      no: string;\n    };\n  }) => Promise<string | undefined>;\n  toast: (params: {\n    title?: string;\n    message: string | ReactElement;\n    type?: \"info\" | \"danger\" | \"warning\" | \"caution\" | \"success\";\n    actionLabel?: string;\n    handleActionClick?: () => void;\n    closeOnActionClick?: boolean;\n    duration?: number;\n    onClose?: () => void;\n  }) => void;\n}\n\nlet services: PluginUIServices | null = null;\n\n/** Called by the host when it mounts a plugin. */\nexport function setHostServices(next: PluginUIServices): void {\n  services = next;\n}\n\n/** Read the injected services, throwing a clear error if the host forgot. */\nexport function getHostServices(): PluginUIServices {\n  if (!services) {\n    throw new Error(\n      \"[plugin-ui] services not set \u2014 the plugin must be mounted by a Muscat host.\",\n    );\n  }\n  return services;\n}\n\n/** Open a host alert dialog from a plugin. */\nexport function alert(\n  params: Parameters<PluginUIServices[\"alert\"]>[0],\n): Promise<void> {\n  return getHostServices().alert(params);\n}\n\n/** Open a host confirm dialog from a plugin. Resolves true/false. */\nexport function confirm(\n  params: Parameters<PluginUIServices[\"confirm\"]>[0],\n): Promise<boolean> {\n  return getHostServices().confirm(params);\n}\n\n/** Open a host prompt dialog from a plugin. Resolves the entered value, or undefined if cancelled. */\nexport function prompt(\n  params: Parameters<PluginUIServices[\"prompt\"]>[0],\n): Promise<string | undefined> {\n  return getHostServices().prompt(params);\n}\n\n/** Show a host toast from a plugin. */\nexport function toast(params: Parameters<PluginUIServices[\"toast\"]>[0]): void {\n  getHostServices().toast(params);\n}\n"],
-  "mappings": "AAsCA,IAAI,WAAoC;AAGjC,SAAS,gBAAgB,MAA8B;AAC5D,aAAW;AACb;AAGO,SAAS,kBAAoC;AAClD,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,MACd,QACe;AACf,SAAO,gBAAgB,EAAE,MAAM,MAAM;AACvC;AAGO,SAAS,QACd,QACkB;AAClB,SAAO,gBAAgB,EAAE,QAAQ,MAAM;AACzC;AAGO,SAAS,OACd,QAC6B;AAC7B,SAAO,gBAAgB,EAAE,OAAO,MAAM;AACxC;AAGO,SAAS,MAAM,QAAwD;AAC5E,kBAAgB,EAAE,MAAM,MAAM;AAChC;",
+  "sourcesContent": ["import { ReactElement } from \"react\";\n\n/** One step of a program tree a plugin hands to the host Program page. */\nexport interface PluginProgramStep {\n  /** Muscat command name, e.g. \"MoveJ\", \"Point\", \"Wait\", \"Repeat\", \"Condition\". */\n  command: string;\n  args?: Record<string, unknown>;\n  summary?: string;\n  children?: PluginProgramStep[];\n}\n\nexport interface PluginUIServices {\n  /** Replaces the loaded program's main step tree (unsaved edit; the user saves). */\n  program: {\n    setSteps: (steps: PluginProgramStep[]) => Promise<void>;\n    /** Command catalog of the loaded robot (names, default args, nesting rules). */\n    getCatalog: () => Promise<unknown[]>;\n  };\n  alert: (params: {\n    title?: string;\n    message: string;\n    buttonText?: string;\n  }) => Promise<void>;\n  confirm: (params: {\n    title?: string;\n    message: string;\n    buttonText?: {\n      yes: string;\n      no: string;\n    };\n  }) => Promise<boolean>;\n  prompt: (params: {\n    title?: string;\n    message: string;\n    value?: string;\n    placeholder?: string;\n    buttonText?: {\n      yes: string;\n      no: string;\n    };\n  }) => Promise<string | undefined>;\n  toast: (params: {\n    title?: string;\n    message: string | ReactElement;\n    type?: \"info\" | \"danger\" | \"warning\" | \"caution\" | \"success\";\n    actionLabel?: string;\n    handleActionClick?: () => void;\n    closeOnActionClick?: boolean;\n    duration?: number;\n    onClose?: () => void;\n  }) => void;\n}\n\nlet services: PluginUIServices | null = null;\n\n/** Called by the host when it mounts a plugin. */\nexport function setHostServices(next: PluginUIServices): void {\n  services = next;\n}\n\n/** Read the injected services, throwing a clear error if the host forgot. */\nexport function getHostServices(): PluginUIServices {\n  if (!services) {\n    throw new Error(\n      \"[plugin-ui] services not set \u2014 the plugin must be mounted by a Muscat host.\",\n    );\n  }\n  return services;\n}\n\n/** Open a host alert dialog from a plugin. */\nexport function alert(\n  params: Parameters<PluginUIServices[\"alert\"]>[0],\n): Promise<void> {\n  return getHostServices().alert(params);\n}\n\n/** Open a host confirm dialog from a plugin. Resolves true/false. */\nexport function confirm(\n  params: Parameters<PluginUIServices[\"confirm\"]>[0],\n): Promise<boolean> {\n  return getHostServices().confirm(params);\n}\n\n/** Open a host prompt dialog from a plugin. Resolves the entered value, or undefined if cancelled. */\nexport function prompt(\n  params: Parameters<PluginUIServices[\"prompt\"]>[0],\n): Promise<string | undefined> {\n  return getHostServices().prompt(params);\n}\n\n/** Show a host toast from a plugin. */\nexport function toast(params: Parameters<PluginUIServices[\"toast\"]>[0]): void {\n  getHostServices().toast(params);\n}\n"],
+  "mappings": "AAqDA,IAAI,WAAoC;AAGjC,SAAS,gBAAgB,MAA8B;AAC5D,aAAW;AACb;AAGO,SAAS,kBAAoC;AAClD,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,MACd,QACe;AACf,SAAO,gBAAgB,EAAE,MAAM,MAAM;AACvC;AAGO,SAAS,QACd,QACkB;AAClB,SAAO,gBAAgB,EAAE,QAAQ,MAAM;AACzC;AAGO,SAAS,OACd,QAC6B;AAC7B,SAAO,gBAAgB,EAAE,OAAO,MAAM;AACxC;AAGO,SAAS,MAAM,QAAwD;AAC5E,kBAAgB,EAAE,MAAM,MAAM;AAChC;",
   "names": []
 }

package/dist/pluginData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pluginData.d.ts","sourceRoot":"","sources":["../src/pluginData.tsx"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM;QAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,mEAAmE;IACnE,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACtE,0EAA0E;IAC1E,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,mDAAmD;IACnD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAID,wBAAgB,aAAa,IAAI,gBAAgB,CAMhD;AAoHD,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,KAA8B,EAC9B,QAAgD,GACjD,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,2CAqC5C"}
+{"version":3,"file":"pluginData.d.ts","sourceRoot":"","sources":["../src/pluginData.tsx"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM;QAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,mEAAmE;IACnE,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACtE,0EAA0E;IAC1E,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,mDAAmD;IACnD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAID,wBAAgB,aAAa,IAAI,gBAAgB,CAMhD;AAwHD,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,KAA8B,EAC9B,QAAgD,GACjD,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,2CAqC5C"}

package/dist/react.d.ts

@@ -65,7 +65,7 @@ interface RippleOption {
 declare const labelButtonSizes: readonly ["3xs", "2xs", "xs", "xs2", "sm", "md"];
 type LabelButtonSizeType = (typeof labelButtonSizes)[number];
 declare const labelButtonVariants: (props?: {
-    size?: "xs" | "xs2" | "sm" | "md" | "3xs" | "2xs";
+    size?: "3xs" | "2xs" | "xs" | "xs2" | "sm" | "md";
     variant?: "transparent" | "outlined" | "soft" | "solid" | "inverse" | "inverseSoft" | "brand" | "brandSoft" | "danger" | "dangerSoft" | "success" | "successSoft";
     disabled?: boolean;
 } & class_variance_authority_types.ClassProp) => string;
@@ -136,7 +136,7 @@ declare const RBLabelButton: React$1.ForwardRefExoticComponent<Omit<Omit<React$1
 declare const iconButtonSizes: readonly ["3xs", "2xs", "xs", "xs2", "sm", "md"];
 type IconButtonSizeType = (typeof iconButtonSizes)[number];
 declare const iconButtonVariants: (props?: {
-    size?: "xs" | "xs2" | "sm" | "md" | "3xs" | "2xs";
+    size?: "3xs" | "2xs" | "xs" | "xs2" | "sm" | "md";
     variant?: "circle" | "transparent" | "outlined" | "soft" | "solid" | "inverse" | "inverseSoft" | "brand";
     disabled?: boolean;
 } & class_variance_authority_types.ClassProp) => string;
@@ -293,7 +293,7 @@ declare function RBInlineLabelButton({ className, size, variant, type, leadingIc
 declare const accordionTypes: readonly ["fill", "transparent"];
 type AccordionType = (typeof accordionTypes)[number];
 declare const accordionVariants: (props?: {
-    type?: "fill" | "transparent";
+    type?: "transparent" | "fill";
 } & class_variance_authority_types.ClassProp) => string;
 type AccordionVariantProps = VariantProps<typeof accordionVariants>;
 
@@ -2326,7 +2326,7 @@ interface PropsType$5 {
 declare function RBSwitchField({ children, className, controlPlacement, description, descriptionClassName, invalid, label, labelClassName, size, type, }: PropsType$5): react_jsx_runtime.JSX.Element;
 
 declare const toggleRootVariants: (props?: {
-    size?: "sm" | "lg" | "default";
+    size?: "sm" | "default" | "lg";
     variant?: "default" | "outline";
 } & class_variance_authority_types.ClassProp) => string;
 type ToggleVariantProps = VariantProps<typeof toggleRootVariants>;
@@ -3546,7 +3546,21 @@ interface PropsType extends HTMLAttributes<HTMLElement> {
  */
 declare const VStack: React$1.ForwardRefExoticComponent<PropsType & React$1.RefAttributes<HTMLDivElement>>;
 
+/** One step of a program tree a plugin hands to the host Program page. */
+interface PluginProgramStep {
+    /** Muscat command name, e.g. "MoveJ", "Point", "Wait", "Repeat", "Condition". */
+    command: string;
+    args?: Record<string, unknown>;
+    summary?: string;
+    children?: PluginProgramStep[];
+}
 interface PluginUIServices {
+    /** Replaces the loaded program's main step tree (unsaved edit; the user saves). */
+    program: {
+        setSteps: (steps: PluginProgramStep[]) => Promise<void>;
+        /** Command catalog of the loaded robot (names, default args, nesting rules). */
+        getCatalog: () => Promise<unknown[]>;
+    };
     alert: (params: {
         title?: string;
         message: string;
@@ -3615,6 +3629,8 @@ interface RbSdk {
     confirm: PluginUIServices["confirm"];
     /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */
     prompt: PluginUIServices["prompt"];
+    /** Push a step tree into the host Program page as an unsaved edit. */
+    program: PluginUIServices["program"];
     /**
      * Host-provided initial data for this mount — e.g. the previously-saved
      * values when the host re-opens a form. `undefined` for a fresh mount.

package/dist/sdk.d.ts

@@ -28,6 +28,8 @@ export interface RbSdk {
     confirm: PluginUIServices["confirm"];
     /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */
     prompt: PluginUIServices["prompt"];
+    /** Push a step tree into the host Program page as an unsaved edit. */
+    program: PluginUIServices["program"];
     /**
      * Host-provided initial data for this mount — e.g. the previously-saved
      * values when the host re-opens a form. `undefined` for a fresh mount.

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,IAAI,UAAU,EAC1B,WAAW,IAAI,SAAS,EACzB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,wFAAwF;IACxF,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;IAElD;;;;OAIG;IACH,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,gFAAgF;QAChF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AAiDD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAKhE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,IAAI,UAAU,EAC1B,WAAW,IAAI,SAAS,EACzB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,wFAAwF;IACxF,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnC,sEAAsE;IACtE,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAErC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;IAElD;;;;OAIG;IACH,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,gFAAgF;QAChF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AA0DD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAKhE"}

package/dist/sdk.js

@@ -31,6 +31,15 @@ const noopSdk = {
     console.warn("[plugin-ui] rb.prompt called outside of a host context");
     return void 0;
   },
+  program: {
+    setSteps: async () => {
+      console.warn("[plugin-ui] rb.program called outside of a host context");
+    },
+    getCatalog: async () => {
+      console.warn("[plugin-ui] rb.program called outside of a host context");
+      return [];
+    }
+  },
   data: void 0,
   onSave: () => () => {
   },

package/dist/sdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/sdk.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin runtime SDK (`useRb()`).\n *\n * pub/sub/action/serve talk to the Zenoh router over WebSocket. Topics are\n * namespaced to {pluginId}/... ; a leading \"/\" makes the path absolute.\n * alert/confirm/prompt/toast delegate to the host.\n */\nimport { createContext, useContext, useEffect, useRef } from \"react\";\nimport type {\n  WsSubscriber as Subscriber,\n  WsQueryable as Queryable,\n} from \"./ws\";\n// Type-only import \u2014 no runtime coupling to host-ui.ts (which itself has no\n// dependency back on sdk.ts, so this stays one-directional).\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 {pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: PluginUIServices[\"toast\"];\n\n  /** Show a host alert dialog. */\n  alert: PluginUIServices[\"alert\"];\n  /** Show a host confirm dialog. Resolves true/false. */\n  confirm: PluginUIServices[\"confirm\"];\n  /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */\n  prompt: PluginUIServices[\"prompt\"];\n\n  /**\n   * Host-provided initial data for this mount \u2014 e.g. the previously-saved\n   * values when the host re-opens a form. `undefined` for a fresh mount.\n   * Prefer the `useRbFormData()` hook over reading this directly.\n   */\n  data?: unknown;\n\n  /**\n   * Register a getter the host calls (synchronously) to collect this plugin's\n   * save payload \u2014 e.g. when the host's Save button is clicked. The returned\n   * value must be JSON-serialisable (the host persists it). Returns an\n   * unregister fn. Prefer the `useRbSave()` hook.\n   */\n  onSave: (getPayload: () => unknown) => () => void;\n\n  /**\n   * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local\n   * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts\n   * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.\n   */\n  rosPeers: {\n    get: () => Promise<string[]>;\n    /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */\n    set: (peers: string[]) => Promise<string[]>;\n  };\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(\n    _topic?: string,\n    _handler?: (payload?: P) => R,\n  ) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (params) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", params);\n  },\n  alert: async (_) => {\n    console.warn(\"[plugin-ui] rb.alert called outside of a host context\");\n  },\n  confirm: async (_) => {\n    console.warn(\"[plugin-ui] rb.confirm called outside of a host context\");\n    return false;\n  },\n  prompt: async (_) => {\n    console.warn(\"[plugin-ui] rb.prompt called outside of a host context\");\n    return undefined;\n  },\n  data: undefined,\n  onSave: () => () => {},\n  rosPeers: {\n    get: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n    set: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n  },\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n\n/**\n * Read the host-provided initial data for this mount (e.g. previously-saved\n * form values). `undefined` for a fresh mount.\n *\n *   const saved = useRbFormData<MyArgs>();\n *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });\n */\nexport function useRbFormData<T = unknown>(): T | undefined {\n  return useRb().data as T | undefined;\n}\n\n/**\n * Register a getter the host calls to collect this plugin's save payload when\n * the host's Save is clicked. The latest `getPayload` is always used, so it can\n * close over current state. The returned value must be JSON-serialisable.\n *\n *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));\n */\nexport function useRbSave<T = unknown>(getPayload: () => T): void {\n  const rb = useRb();\n  const ref = useRef(getPayload);\n  ref.current = getPayload;\n  useEffect(() => rb.onSave(() => ref.current()), [rb]);\n}\n"],
-  "mappings": "AAQA,SAAS,eAAe,YAAY,WAAW,cAAc;AA6E7D,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OACL,QACA,aACG;AACH,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,WAAW;AACjB,YAAQ,KAAK,mCAAmC,MAAM;AAAA,EACxD;AAAA,EACA,OAAO,OAAO,MAAM;AAClB,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AAAA,EACA,SAAS,OAAO,MAAM;AACpB,YAAQ,KAAK,yDAAyD;AACtE,WAAO;AAAA,EACT;AAAA,EACA,QAAQ,OAAO,MAAM;AACnB,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,MAAM,MAAM;AAAA,EAAC;AAAA,EACrB,UAAU;AAAA,IACR,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;AASO,SAAS,gBAA4C;AAC1D,SAAO,MAAM,EAAE;AACjB;AASO,SAAS,UAAuB,YAA2B;AAChE,QAAM,KAAK,MAAM;AACjB,QAAM,MAAM,OAAO,UAAU;AAC7B,MAAI,UAAU;AACd,YAAU,MAAM,GAAG,OAAO,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin runtime SDK (`useRb()`).\n *\n * pub/sub/action/serve talk to the Zenoh router over WebSocket. Topics are\n * namespaced to {pluginId}/... ; a leading \"/\" makes the path absolute.\n * alert/confirm/prompt/toast delegate to the host.\n */\nimport { createContext, useContext, useEffect, useRef } from \"react\";\nimport type {\n  WsSubscriber as Subscriber,\n  WsQueryable as Queryable,\n} from \"./ws\";\n// Type-only import \u2014 no runtime coupling to host-ui.ts (which itself has no\n// dependency back on sdk.ts, so this stays one-directional).\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 {pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: PluginUIServices[\"toast\"];\n\n  /** Show a host alert dialog. */\n  alert: PluginUIServices[\"alert\"];\n  /** Show a host confirm dialog. Resolves true/false. */\n  confirm: PluginUIServices[\"confirm\"];\n  /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */\n  prompt: PluginUIServices[\"prompt\"];\n\n  /** Push a step tree into the host Program page as an unsaved edit. */\n  program: PluginUIServices[\"program\"];\n\n  /**\n   * Host-provided initial data for this mount \u2014 e.g. the previously-saved\n   * values when the host re-opens a form. `undefined` for a fresh mount.\n   * Prefer the `useRbFormData()` hook over reading this directly.\n   */\n  data?: unknown;\n\n  /**\n   * Register a getter the host calls (synchronously) to collect this plugin's\n   * save payload \u2014 e.g. when the host's Save button is clicked. The returned\n   * value must be JSON-serialisable (the host persists it). Returns an\n   * unregister fn. Prefer the `useRbSave()` hook.\n   */\n  onSave: (getPayload: () => unknown) => () => void;\n\n  /**\n   * PCs allowed to talk to this plugin's ROS 2 nodes. ROS discovery is robot-local\n   * (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST); Muscat keeps this list per plugin, starts\n   * the plugin with ROS_STATIC_PEERS set to it, and restarts the plugin when it changes.\n   */\n  rosPeers: {\n    get: () => Promise<string[]>;\n    /** Saves the list and restarts the plugin backend. Rejects on an invalid IP. */\n    set: (peers: string[]) => Promise<string[]>;\n  };\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(\n    _topic?: string,\n    _handler?: (payload?: P) => R,\n  ) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (params) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", params);\n  },\n  alert: async (_) => {\n    console.warn(\"[plugin-ui] rb.alert called outside of a host context\");\n  },\n  confirm: async (_) => {\n    console.warn(\"[plugin-ui] rb.confirm called outside of a host context\");\n    return false;\n  },\n  prompt: async (_) => {\n    console.warn(\"[plugin-ui] rb.prompt called outside of a host context\");\n    return undefined;\n  },\n  program: {\n    setSteps: async () => {\n      console.warn(\"[plugin-ui] rb.program called outside of a host context\");\n    },\n    getCatalog: async () => {\n      console.warn(\"[plugin-ui] rb.program called outside of a host context\");\n      return [];\n    },\n  },\n  data: undefined,\n  onSave: () => () => {},\n  rosPeers: {\n    get: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n    set: async () => {\n      console.warn(\"[plugin-ui] rb.rosPeers called outside of a host context\");\n      return [];\n    },\n  },\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n\n/**\n * Read the host-provided initial data for this mount (e.g. previously-saved\n * form values). `undefined` for a fresh mount.\n *\n *   const saved = useRbFormData<MyArgs>();\n *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });\n */\nexport function useRbFormData<T = unknown>(): T | undefined {\n  return useRb().data as T | undefined;\n}\n\n/**\n * Register a getter the host calls to collect this plugin's save payload when\n * the host's Save is clicked. The latest `getPayload` is always used, so it can\n * close over current state. The returned value must be JSON-serialisable.\n *\n *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));\n */\nexport function useRbSave<T = unknown>(getPayload: () => T): void {\n  const rb = useRb();\n  const ref = useRef(getPayload);\n  ref.current = getPayload;\n  useEffect(() => rb.onSave(() => ref.current()), [rb]);\n}\n"],
+  "mappings": "AAQA,SAAS,eAAe,YAAY,WAAW,cAAc;AAgF7D,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OACL,QACA,aACG;AACH,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,WAAW;AACjB,YAAQ,KAAK,mCAAmC,MAAM;AAAA,EACxD;AAAA,EACA,OAAO,OAAO,MAAM;AAClB,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AAAA,EACA,SAAS,OAAO,MAAM;AACpB,YAAQ,KAAK,yDAAyD;AACtE,WAAO;AAAA,EACT;AAAA,EACA,QAAQ,OAAO,MAAM;AACnB,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,SAAS;AAAA,IACP,UAAU,YAAY;AACpB,cAAQ,KAAK,yDAAyD;AAAA,IACxE;AAAA,IACA,YAAY,YAAY;AACtB,cAAQ,KAAK,yDAAyD;AACtE,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,MAAM,MAAM;AAAA,EAAC;AAAA,EACrB,UAAU;AAAA,IACR,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,YAAY;AACf,cAAQ,KAAK,0DAA0D;AACvE,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;AASO,SAAS,gBAA4C;AAC1D,SAAO,MAAM,EAAE;AACjB;AASO,SAAS,UAAuB,YAA2B;AAChE,QAAM,KAAK,MAAM;AACjB,QAAM,MAAM,OAAO,UAAU;AAC7B,MAAI,UAAU;AACd,YAAU,MAAM,GAAG,OAAO,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD;",
   "names": []
 }

package/dist/ws.d.ts

@@ -68,6 +68,10 @@ export declare function createLazyRbSdk(wsPromise: Promise<RbWs>, services: Plug
             no: string;
         };
     }) => Promise<string | undefined>;
+    program: {
+        setSteps: (steps: import("./host-ui").PluginProgramStep[]) => Promise<void>;
+        getCatalog: () => Promise<unknown[]>;
+    };
     data: unknown;
     onSave: (getPayload: () => unknown) => () => void;
     rosPeers: {

package/dist/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAMnC,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,OAAO;IAsCP,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC;IAsBlB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuChE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC;IAYvB,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,QAAQ,EAAE,gBAAgB,EAI1B,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACpD;iBAIoB,MAAM,WAAW,GAAG;iBAG9B,MAAM,WAEJ,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;oBAGX,MAAM,YAAY,GAAG;mBAGlC,MAAM,WAEJ,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG;;aArNtB,CAAC;;YAIE,CAAC;mBAGF,CAAC;yBAA+B,CAAC;0BAC7B,CAAC;gBAAuB,CAAC;eAAqB,CAAC;;;aApB1B,CAAA;;kBAC9B,CAAC;;;aACgB,CAAC;;kBAExB,CAAC;;;;;;aAEF,CAAD;;aAED,CAAC;mBAAyB,CAAC;kBAC3B,CAAA;;;;;;yBAsMuB,MAAM,OAAO,KAAK,MAAM,IAAI;;mBAqCnC,OAAO,CAAC,MAAM,EAAE,CAAC;qBACb,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC;;EAPlD"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAMnC,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,OAAO;IAsCP,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC;IAsBlB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuChE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC;IAYvB,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,QAAQ,EAAE,gBAAgB,EAI1B,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACpD;iBAIoB,MAAM,WAAW,GAAG;iBAG9B,MAAM,WAEJ,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;oBAGX,MAAM,YAAY,GAAG;mBAGlC,MAAM,WAEJ,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG;;aA9LH,CAAC;;YAE/B,CAAC;mBAEwC,CAAC;yBAA+B,CAAC;0BACrD,CAAA;gBAAwB,CAAA;eAAsB,CAAA;;;aArBrD,CAAC;;kBACjB,CAAF;;;aAAgE,CAAC;;kBAIpD,CAAC;;;;;;aAGV,CAAF;;aAC4B,CAAC;mBAElB,CAAC;kBAAwB,CAAC;;;;;;;;;;yBAiLb,MAAM,OAAO,KAAK,MAAM,IAAI;;mBAsCnC,OAAO,CAAC,MAAM,EAAE,CAAC;qBACb,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC;;EAPlD"}

package/dist/ws.js

@@ -136,6 +136,7 @@ function createLazyRbSdk(wsPromise, services, mount) {
     alert: services.alert,
     confirm: services.confirm,
     prompt: services.prompt,
+    program: services.program,
     data: mount?.data,
     onSave: mount?.onSave ?? (() => () => {
     }),

package/dist/ws.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/ws.ts"],
-  "sourcesContent": ["/**\n * Socket.IO communication client for plugin frontends.\n *\n * Topics are automatically namespaced to prevent cross-plugin collisions:\n *   \"sensor/data\"  \u2192  \"{pluginId}/sensor/data\"\n *   \"/broadcast/x\" \u2192  \"broadcast/x\"   (leading slash = absolute)\n *\n * Browser \u2190\u2192 Python backend protocol:\n *   browser emits : sub, unsub, pub, action (with ack), serve_reply\n *   server emits  : msg, serve_call\n */\nimport { io, type Socket } from \"socket.io-client\";\n// Type-only \u2014 no runtime coupling to host-ui.ts.\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport interface WsHandle {\n  undeclare(): void;\n}\n\nexport type WsSubscriber = WsHandle;\nexport type WsQueryable = WsHandle;\n\nfunction resolveTopic(pluginId: string, topic: string): string {\n  return topic.startsWith(\"/\") ? topic.slice(1) : `${pluginId}/${topic}`;\n}\n\nexport class RbWs {\n  private readonly _socket: Socket;\n  private readonly _pluginId: string;\n  private readonly _subHandlers = new Map<\n    string,\n    Set<(payload: unknown) => void>\n  >();\n  private readonly _serveHandlers = new Map<\n    string,\n    (payload?: unknown) => unknown | Promise<unknown>\n  >();\n\n  private constructor(socket: Socket, pluginId: string) {\n    this._socket = socket;\n    this._pluginId = pluginId;\n\n    // The gateway keeps subscriptions/serve registrations in memory \u2014 re-send them after\n    // a reconnect (e.g. the gateway restarted), or they silently stop working.\n    socket.io.on(\"reconnect\", () => {\n      for (const topic of this._subHandlers.keys()) socket.emit(\"sub\", { topic });\n      for (const topic of this._serveHandlers.keys()) socket.emit(\"serve_register\", { topic });\n    });\n\n    // Deliver incoming pub/sub messages to registered handlers\n    socket.on(\n      \"msg\",\n      ({ topic, payload }: { topic: string; payload: unknown }) => {\n        this._subHandlers.get(topic)?.forEach((h) => h(payload));\n      },\n    );\n\n    // Python calls a browser-side serve handler\n    socket.on(\n      \"serve_call\",\n      async ({\n        id,\n        topic,\n        payload,\n      }: {\n        id: string;\n        topic: string;\n        payload: unknown;\n      }) => {\n        const handler = this._serveHandlers.get(topic);\n        const result = handler ? await handler(payload) : undefined;\n        socket.emit(\"serve_reply\", { id, payload: result });\n      },\n    );\n  }\n\n  get pluginId(): string {\n    return this._pluginId;\n  }\n\n  static connect(url: string, pluginId: string): Promise<RbWs> {\n    return new Promise((resolve, reject) => {\n      const socket = io(url, { transports: [\"websocket\"] });\n      const onConnect = () => {\n        cleanup();\n        resolve(new RbWs(socket, pluginId));\n      };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        socket.off(\"connect\", onConnect);\n        socket.off(\"connect_error\", onError);\n      };\n      socket.once(\"connect\", onConnect);\n      socket.once(\"connect_error\", onError);\n    });\n  }\n\n  private _key(topic: string): string {\n    return resolveTopic(this._pluginId, topic);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async pub<P = any>(topic: string, payload: P): Promise<void> {\n    this._socket.emit(\"pub\", { topic: this._key(topic), payload });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async sub<P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ): Promise<WsSubscriber> {\n    const key = this._key(topic);\n    if (!this._subHandlers.has(key)) {\n      this._subHandlers.set(key, new Set());\n      this._socket.emit(\"sub\", { topic: key });\n    }\n    const h = handler as (payload: unknown) => void;\n    this._subHandlers.get(key)!.add(h);\n    return {\n      undeclare: () => {\n        const set = this._subHandlers.get(key);\n        if (!set) return;\n        set.delete(h);\n        if (set.size === 0) {\n          this._subHandlers.delete(key);\n          this._socket.emit(\"unsub\", { topic: key });\n        }\n      },\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async action<R = any, P = any>(topic: string, payload?: P): Promise<R> {\n    const key = this._key(topic);\n    return new Promise((resolve, reject) => {\n      this._socket\n        .timeout(10_000)\n        .emit(\n          \"action\",\n          { topic: key, payload },\n          (err: Error | null, result: R) => {\n            if (err) {\n              // socket.io ack timeout \u2014 the bridge itself never answered.\n              reject(new Error(`action \"${key}\": no ack from bridge (${err.message})`));\n            } else if (\n              result &&\n              typeof result === \"object\" &&\n              \"error\" in result &&\n              typeof result.error === \"string\"\n            ) {\n              // Backend handler returned an error payload \u2014 surface it verbatim.\n              reject(new Error(result.error));\n            } else if (result === undefined || result === null) {\n              // The bridge acked but with no payload: the backend handler is\n              // registered yet didn't reply in time (hung inside the handler,\n              // e.g. a blocked SDK call) or returned nothing. Distinct from a\n              // \"No handler registered\" error, which comes back as result.error.\n              reject(\n                new Error(\n                  `action \"${key}\": no reply from plugin backend \u2014 the handler was reached but didn't return in time (check the backend's stdout on the robot).`,\n                ),\n              );\n            } else {\n              resolve(result);\n            }\n          },\n        );\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async serve<P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ): Promise<WsQueryable> {\n    const key = this._key(topic);\n    this._serveHandlers.set(key, handler as (payload?: unknown) => unknown);\n    this._socket.emit(\"serve_register\", { topic: key });\n    return {\n      undeclare: () => {\n        this._serveHandlers.delete(key);\n        this._socket.emit(\"serve_unregister\", { topic: key });\n      },\n    };\n  }\n\n  close(): void {\n    this._socket.disconnect();\n  }\n}\n\n/**\n * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through\n * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` \u2014\n * so callers don't block their first render on the WebSocket handshake (there\n * may be no backend reachable yet). Shared by both host mount paths (see\n * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise\n * duplicate this wiring.\n */\nexport function createLazyRbSdk(\n  wsPromise: Promise<RbWs>,\n  services: PluginUIServices,\n  // Per-mount, host-provided (unlike `services`, which is a global singleton):\n  // initial `data` and the `onSave` registration the host reads back. Plain\n  // values/closures, so they cross the dev React-instance boundary safely.\n  mount?: {\n    data?: unknown;\n    onSave?: (getPayload: () => unknown) => () => void;\n  },\n) {\n  return {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    pub: async (topic: string, payload: any) =>\n      (await wsPromise).pub(topic, payload),\n    sub: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload: any) => void,\n    ) => (await wsPromise).sub(topic, handler),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    action: async (topic: string, payload?: any) =>\n      (await wsPromise).action(topic, payload),\n    serve: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload?: any) => any,\n    ) => (await wsPromise).serve(topic, handler),\n    toast: services.toast,\n    alert: services.alert,\n    confirm: services.confirm,\n    prompt: services.prompt,\n    data: mount?.data,\n    onSave: mount?.onSave ?? (() => () => {}),\n    rosPeers: rosPeersApi(async (op, payload) => {\n      const ws = await wsPromise;\n      return ws.action(`/muscat/plugin/${ws.pluginId}/ros_peers/${op}`, payload);\n    }),\n  };\n}\n\n// Answered by Muscat (common) on the robot and by `muscat-pk dev` locally.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction rosPeersApi(call: (op: \"get\" | \"set\", payload?: any) => Promise<any>) {\n  return {\n    get: async (): Promise<string[]> => (await call(\"get\"))?.peers ?? [],\n    set: async (peers: string[]): Promise<string[]> => {\n      const r = await call(\"set\", { peers });\n      if (!r?.ok) throw new Error(r?.error ?? \"rb.rosPeers.set failed\");\n      return r.peers;\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Socket.IO communication client for plugin frontends.\n *\n * Topics are automatically namespaced to prevent cross-plugin collisions:\n *   \"sensor/data\"  \u2192  \"{pluginId}/sensor/data\"\n *   \"/broadcast/x\" \u2192  \"broadcast/x\"   (leading slash = absolute)\n *\n * Browser \u2190\u2192 Python backend protocol:\n *   browser emits : sub, unsub, pub, action (with ack), serve_reply\n *   server emits  : msg, serve_call\n */\nimport { io, type Socket } from \"socket.io-client\";\n// Type-only \u2014 no runtime coupling to host-ui.ts.\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport interface WsHandle {\n  undeclare(): void;\n}\n\nexport type WsSubscriber = WsHandle;\nexport type WsQueryable = WsHandle;\n\nfunction resolveTopic(pluginId: string, topic: string): string {\n  return topic.startsWith(\"/\") ? topic.slice(1) : `${pluginId}/${topic}`;\n}\n\nexport class RbWs {\n  private readonly _socket: Socket;\n  private readonly _pluginId: string;\n  private readonly _subHandlers = new Map<\n    string,\n    Set<(payload: unknown) => void>\n  >();\n  private readonly _serveHandlers = new Map<\n    string,\n    (payload?: unknown) => unknown | Promise<unknown>\n  >();\n\n  private constructor(socket: Socket, pluginId: string) {\n    this._socket = socket;\n    this._pluginId = pluginId;\n\n    // The gateway keeps subscriptions/serve registrations in memory \u2014 re-send them after\n    // a reconnect (e.g. the gateway restarted), or they silently stop working.\n    socket.io.on(\"reconnect\", () => {\n      for (const topic of this._subHandlers.keys()) socket.emit(\"sub\", { topic });\n      for (const topic of this._serveHandlers.keys()) socket.emit(\"serve_register\", { topic });\n    });\n\n    // Deliver incoming pub/sub messages to registered handlers\n    socket.on(\n      \"msg\",\n      ({ topic, payload }: { topic: string; payload: unknown }) => {\n        this._subHandlers.get(topic)?.forEach((h) => h(payload));\n      },\n    );\n\n    // Python calls a browser-side serve handler\n    socket.on(\n      \"serve_call\",\n      async ({\n        id,\n        topic,\n        payload,\n      }: {\n        id: string;\n        topic: string;\n        payload: unknown;\n      }) => {\n        const handler = this._serveHandlers.get(topic);\n        const result = handler ? await handler(payload) : undefined;\n        socket.emit(\"serve_reply\", { id, payload: result });\n      },\n    );\n  }\n\n  get pluginId(): string {\n    return this._pluginId;\n  }\n\n  static connect(url: string, pluginId: string): Promise<RbWs> {\n    return new Promise((resolve, reject) => {\n      const socket = io(url, { transports: [\"websocket\"] });\n      const onConnect = () => {\n        cleanup();\n        resolve(new RbWs(socket, pluginId));\n      };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        socket.off(\"connect\", onConnect);\n        socket.off(\"connect_error\", onError);\n      };\n      socket.once(\"connect\", onConnect);\n      socket.once(\"connect_error\", onError);\n    });\n  }\n\n  private _key(topic: string): string {\n    return resolveTopic(this._pluginId, topic);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async pub<P = any>(topic: string, payload: P): Promise<void> {\n    this._socket.emit(\"pub\", { topic: this._key(topic), payload });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async sub<P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ): Promise<WsSubscriber> {\n    const key = this._key(topic);\n    if (!this._subHandlers.has(key)) {\n      this._subHandlers.set(key, new Set());\n      this._socket.emit(\"sub\", { topic: key });\n    }\n    const h = handler as (payload: unknown) => void;\n    this._subHandlers.get(key)!.add(h);\n    return {\n      undeclare: () => {\n        const set = this._subHandlers.get(key);\n        if (!set) return;\n        set.delete(h);\n        if (set.size === 0) {\n          this._subHandlers.delete(key);\n          this._socket.emit(\"unsub\", { topic: key });\n        }\n      },\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async action<R = any, P = any>(topic: string, payload?: P): Promise<R> {\n    const key = this._key(topic);\n    return new Promise((resolve, reject) => {\n      this._socket\n        .timeout(10_000)\n        .emit(\n          \"action\",\n          { topic: key, payload },\n          (err: Error | null, result: R) => {\n            if (err) {\n              // socket.io ack timeout \u2014 the bridge itself never answered.\n              reject(new Error(`action \"${key}\": no ack from bridge (${err.message})`));\n            } else if (\n              result &&\n              typeof result === \"object\" &&\n              \"error\" in result &&\n              typeof result.error === \"string\"\n            ) {\n              // Backend handler returned an error payload \u2014 surface it verbatim.\n              reject(new Error(result.error));\n            } else if (result === undefined || result === null) {\n              // The bridge acked but with no payload: the backend handler is\n              // registered yet didn't reply in time (hung inside the handler,\n              // e.g. a blocked SDK call) or returned nothing. Distinct from a\n              // \"No handler registered\" error, which comes back as result.error.\n              reject(\n                new Error(\n                  `action \"${key}\": no reply from plugin backend \u2014 the handler was reached but didn't return in time (check the backend's stdout on the robot).`,\n                ),\n              );\n            } else {\n              resolve(result);\n            }\n          },\n        );\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async serve<P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ): Promise<WsQueryable> {\n    const key = this._key(topic);\n    this._serveHandlers.set(key, handler as (payload?: unknown) => unknown);\n    this._socket.emit(\"serve_register\", { topic: key });\n    return {\n      undeclare: () => {\n        this._serveHandlers.delete(key);\n        this._socket.emit(\"serve_unregister\", { topic: key });\n      },\n    };\n  }\n\n  close(): void {\n    this._socket.disconnect();\n  }\n}\n\n/**\n * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through\n * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` \u2014\n * so callers don't block their first render on the WebSocket handshake (there\n * may be no backend reachable yet). Shared by both host mount paths (see\n * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise\n * duplicate this wiring.\n */\nexport function createLazyRbSdk(\n  wsPromise: Promise<RbWs>,\n  services: PluginUIServices,\n  // Per-mount, host-provided (unlike `services`, which is a global singleton):\n  // initial `data` and the `onSave` registration the host reads back. Plain\n  // values/closures, so they cross the dev React-instance boundary safely.\n  mount?: {\n    data?: unknown;\n    onSave?: (getPayload: () => unknown) => () => void;\n  },\n) {\n  return {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    pub: async (topic: string, payload: any) =>\n      (await wsPromise).pub(topic, payload),\n    sub: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload: any) => void,\n    ) => (await wsPromise).sub(topic, handler),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    action: async (topic: string, payload?: any) =>\n      (await wsPromise).action(topic, payload),\n    serve: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload?: any) => any,\n    ) => (await wsPromise).serve(topic, handler),\n    toast: services.toast,\n    alert: services.alert,\n    confirm: services.confirm,\n    prompt: services.prompt,\n    program: services.program,\n    data: mount?.data,\n    onSave: mount?.onSave ?? (() => () => {}),\n    rosPeers: rosPeersApi(async (op, payload) => {\n      const ws = await wsPromise;\n      return ws.action(`/muscat/plugin/${ws.pluginId}/ros_peers/${op}`, payload);\n    }),\n  };\n}\n\n// Answered by Muscat (common) on the robot and by `muscat-pk dev` locally.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction rosPeersApi(call: (op: \"get\" | \"set\", payload?: any) => Promise<any>) {\n  return {\n    get: async (): Promise<string[]> => (await call(\"get\"))?.peers ?? [],\n    set: async (peers: string[]): Promise<string[]> => {\n      const r = await call(\"set\", { peers });\n      if (!r?.ok) throw new Error(r?.error ?? \"rb.rosPeers.set failed\");\n      return r.peers;\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/plugin-ui",
-  "version": "1.3.7",
+  "version": "1.3.8-dev.0",
   "type": "module",
   "engines": {
     "node": ">=20"

package/src/host-ui.ts

@@ -1,6 +1,21 @@
 import { ReactElement } from "react";
 
+/** One step of a program tree a plugin hands to the host Program page. */
+export interface PluginProgramStep {
+  /** Muscat command name, e.g. "MoveJ", "Point", "Wait", "Repeat", "Condition". */
+  command: string;
+  args?: Record<string, unknown>;
+  summary?: string;
+  children?: PluginProgramStep[];
+}
+
 export interface PluginUIServices {
+  /** Replaces the loaded program's main step tree (unsaved edit; the user saves). */
+  program: {
+    setSteps: (steps: PluginProgramStep[]) => Promise<void>;
+    /** Command catalog of the loaded robot (names, default args, nesting rules). */
+    getCatalog: () => Promise<unknown[]>;
+  };
   alert: (params: {
     title?: string;
     message: string;

package/src/pluginData.tsx

@@ -138,7 +138,11 @@ function loadPreviewManifest(): Promise<PluginManifest> {
         if (!res.ok) throw new Error(`GET ${url} failed: ${res.status}`);
         return res.json() as Promise<PluginManifest>;
       } catch (e) {
-        console.error(e);
+        if (win()?.__RB_PLUGIN_PREVIEW_BASE__ || win()?.__RB_PREVIEW_PLUGIN_ID__) {
+          console.error(e);
+        } else {
+          console.warn("[plugin-ui] no preview-host at", previewBase(), "— run `muscat-pk dev` to preview a plugin");
+        }
       }
     })();
   }

package/src/sdk.ts

@@ -56,6 +56,9 @@ export interface RbSdk {
   /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */
   prompt: PluginUIServices["prompt"];
 
+  /** Push a step tree into the host Program page as an unsaved edit. */
+  program: PluginUIServices["program"];
+
   /**
    * Host-provided initial data for this mount — e.g. the previously-saved
    * values when the host re-opens a form. `undefined` for a fresh mount.
@@ -116,6 +119,15 @@ const noopSdk: RbSdk = {
     console.warn("[plugin-ui] rb.prompt called outside of a host context");
     return undefined;
   },
+  program: {
+    setSteps: async () => {
+      console.warn("[plugin-ui] rb.program called outside of a host context");
+    },
+    getCatalog: async () => {
+      console.warn("[plugin-ui] rb.program called outside of a host context");
+      return [];
+    },
+  },
   data: undefined,
   onSave: () => () => {},
   rosPeers: {

package/src/ws.ts

@@ -232,6 +232,7 @@ export function createLazyRbSdk(
     alert: services.alert,
     confirm: services.confirm,
     prompt: services.prompt,
+    program: services.program,
     data: mount?.data,
     onSave: mount?.onSave ?? (() => () => {}),
     rosPeers: rosPeersApi(async (op, payload) => {