@synapse-sdk/core 0.3.3 → 0.3.4

package/dist/error_codes.json

@@ -9,7 +9,7 @@
         "code": "admission_refused",
         "retryable": true,
         "source": "broker",
-        "description": "the runtime refused this connection; retryable: a live session may hold this name, the project may be settling, or the runtime is overloaded \u2014 retry with backoff"
+        "description": "the runtime refused this connection; retryable: a live session holds this name (a crashed one is released after the idle timeout) \u2014 the SDK keeps retrying with backoff"
     },
     {
         "code": "invalid_input",
@@ -105,7 +105,7 @@
         "code": "project_busy",
         "retryable": false,
         "source": "broker",
-        "description": "another project is active and other operators hold grants on it; data.active, data.operators"
+        "description": "a project is active; deactivate it first (data: active, operators)"
     },
     {
         "code": "project_inactive",
@@ -117,7 +117,7 @@
         "code": "project_settling",
         "retryable": true,
         "source": "broker",
-        "description": "the active project just switched; retry when the settle window ends"
+        "description": "the store/scene is still catching up with an activation; retry"
     },
     {
         "code": "not_operator",

package/dist/types.d.ts

@@ -15,8 +15,8 @@ export interface FecParams {
 export declare const FEC_DEFAULTS: Readonly<FecParams>;
 /** `FecParams::repair_for`: repair symbols for K source symbols: `max(2, ceil(K * pct / 100))`; `repair_pct = 0` means none. */
 export declare function fecRepairFor(params: FecParams, k: number): number;
-/** The role ladder (WP §3.2), lowest first. */
-export type Role = "observer" | "agent" | "operator" | "admin";
+/** The role ladder (WP §3.2), five rungs, lowest first: a web node starts `observer`, an hmi `hmi` (never promoted or demoted), an agent `agent`. */
+export type Role = "observer" | "agent" | "operator" | "hmi" | "admin";
 export declare const ROLES: readonly Role[];
 export declare function roleRank(r: Role): number;
 export declare function isRole(s: unknown): s is Role;
@@ -220,15 +220,18 @@ export type TimeOffsets = Record<string, TimeOffsetEntry>;
 export interface ProjectSnapshot {
     active: ActiveProject | null;
     operators: OperatorEntry[];
-    settling_until_us: number | null;
 }
-/** The active project; `scene_id`, `store_id` and `behavior_trees` (slot → `tree:<id>`) are its project document's. */
+/**
+ * The active project; `scene_id`, `store_id` and `behavior_trees` (slot → `tree:<id>`) are its project document's.
+ * `activated_by_hmi`: an hmi activated it, so only an hmi may deactivate it.
+ */
 export interface ActiveProject {
     id: string;
     since_us: number;
     scene_id: string;
     store_id: string;
     behavior_trees: Record<string, string>;
+    activated_by_hmi: boolean;
 }
 /** The reply of `synapse/tasks/run_robot` and `synapse/tasks/run_project`: how many tasks were started, and how many were declared but have nothing to run. */
 export interface TasksRun {

package/dist/types.js

@@ -11,7 +11,7 @@ export function fecRepairFor(params, k) {
         return 0;
     return Math.min(255, Math.max(2, Math.ceil((k * params.repair_pct) / 100)));
 }
-export const ROLES = ["observer", "agent", "operator", "admin"];
+export const ROLES = ["observer", "agent", "operator", "hmi", "admin"];
 export function roleRank(r) { return ROLES.indexOf(r); }
 export function isRole(s) { return typeof s === "string" && ROLES.includes(s); }
 export const CLIENT_TYPES = ["agent", "observer", "web", "hmi"];
@@ -97,7 +97,7 @@ export function normalizeProjectSnapshot(v) {
     const a = o.active;
     const trees = a && a.behavior_trees && typeof a.behavior_trees === "object" ? a.behavior_trees : {};
     const active = a && typeof a === "object" && typeof a.id === "string"
-        ? { id: a.id, since_us: num(a.since_us) ?? 0, scene_id: str(a.scene_id), store_id: str(a.store_id), behavior_trees: trees }
+        ? { id: a.id, since_us: num(a.since_us) ?? 0, scene_id: str(a.scene_id), store_id: str(a.store_id), behavior_trees: trees, activated_by_hmi: a.activated_by_hmi === true }
         : null;
     const operators = Array.isArray(o.operators)
         ? o.operators.filter(e => e && typeof e.name === "string").map(e => ({
@@ -105,7 +105,7 @@ export function normalizeProjectSnapshot(v) {
             type: isClientType(e.type) ? e.type : "observer", since_us: num(e.since_us) ?? 0,
         }))
         : [];
-    return { active, operators, settling_until_us: num(o.settling_until_us) ?? null };
+    return { active, operators };
 }
 // ------------------------------------------------------------------------------------ store.rs
 export const STORE_CONFIG = "config";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synapse-sdk/core",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Synapse SDK core: message encoding, contracts and error codes shared by the other packages.",
   "type": "module",
   "sideEffects": false,