@openscout/protocol 0.2.87 → 0.2.88

package/dist/presence.d.ts

@@ -22,6 +22,16 @@ import type { ObservedActivity, ObservedStatusPhase } from "./observed-status.js
  * beat must never flap an agent out of freshness.
  */
 export declare const PRESENCE_STALE_AFTER_MS = 45000;
+/**
+ * Maximum steady-state gap between freshness-bearing presence updates.
+ *
+ * A renderer only knows the `staleAt` carried by the last beat it received.
+ * The broker therefore republishes an otherwise unchanged beat before that
+ * deadline while newer liveness evidence keeps arriving. This remains bounded
+ * (two events per minute at the defaults) without letting a continuously
+ * heartbeating agent expire in a connected client.
+ */
+export declare const PRESENCE_REFRESH_INTERVAL_MS = 30000;
 /**
  * How long a stale beat lingers before it is dropped entirely.
  *

package/dist/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8EAA8E;IAC9E,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAKnB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,EAC/C,cAAc,EAAE,OAAO,GACtB,OAAO,CAET;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAET"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8EAA8E;IAC9E,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAKnB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,EAC/C,cAAc,EAAE,OAAO,GACtB,OAAO,CAET;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAET"}

package/dist/presence.js

@@ -20,6 +20,16 @@
  * beat must never flap an agent out of freshness.
  */
 export const PRESENCE_STALE_AFTER_MS = 45_000;
+/**
+ * Maximum steady-state gap between freshness-bearing presence updates.
+ *
+ * A renderer only knows the `staleAt` carried by the last beat it received.
+ * The broker therefore republishes an otherwise unchanged beat before that
+ * deadline while newer liveness evidence keeps arriving. This remains bounded
+ * (two events per minute at the defaults) without letting a continuously
+ * heartbeating agent expire in a connected client.
+ */
+export const PRESENCE_REFRESH_INTERVAL_MS = 30_000;
 /**
  * How long a stale beat lingers before it is dropped entirely.
  *

package/dist/runtime-execution.js

@@ -177,8 +177,8 @@ export function parseScoutRuntimeSpec(input) {
         };
     }
     const rawHarness = parts[0].trim().toLowerCase();
-    const harness = (rawHarness === "oc" ? "opencode" : rawHarness);
-    if (!isScoutLaunchableHarness(harness)) {
+    const harness = normalizeScoutLaunchableHarness(rawHarness);
+    if (!harness) {
         return {
             ok: false,
             error: `unsupported runtime harness "${parts[0]}"; expected one of: ${SCOUT_LAUNCHABLE_HARNESSES.join(", ")}`,
@@ -226,7 +226,7 @@ export function isScoutLaunchableHarness(value) {
     if (!value)
         return false;
     const normalized = value.trim().toLowerCase();
-    return normalized === "oc" || SCOUT_LAUNCHABLE_HARNESSES.includes(normalized);
+    return SCOUT_LAUNCHABLE_HARNESSES.includes(normalized);
 }
 export function normalizeScoutReasoningEffort(value) {
     const normalized = value?.trim().toLowerCase();

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@openscout/protocol",
-  "version": "0.2.87",
+  "version": "0.2.88",
   "description": "Typed protocol for the OpenScout local control plane",
   "license": "Apache-2.0",
   "type": "module",
   "author": "Arach Tchoupani",
-  "homepage": "https://github.com/arach/openscout/tree/main/packages/protocol#readme",
+  "homepage": "https://github.com/oscout/scout/tree/main/packages/protocol#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/arach/openscout.git",
+    "url": "git+https://github.com/oscout/scout.git",
     "directory": "packages/protocol"
   },
   "bugs": {
-    "url": "https://github.com/arach/openscout/issues"
+    "url": "https://github.com/oscout/scout/issues"
   },
   "keywords": [
     "openscout",
@@ -56,5 +56,6 @@
   },
   "devDependencies": {
     "typescript": "^5"
-  }
+  },
+  "gitHead": "0b038ccae278e10851b0a1a16108b94ecd4e7cdc"
 }

package/src/presence.ts

@@ -25,6 +25,17 @@ import type { ObservedActivity, ObservedStatusPhase } from "./observed-status.js
  */
 export const PRESENCE_STALE_AFTER_MS = 45_000;
 
+/**
+ * Maximum steady-state gap between freshness-bearing presence updates.
+ *
+ * A renderer only knows the `staleAt` carried by the last beat it received.
+ * The broker therefore republishes an otherwise unchanged beat before that
+ * deadline while newer liveness evidence keeps arriving. This remains bounded
+ * (two events per minute at the defaults) without letting a continuously
+ * heartbeating agent expire in a connected client.
+ */
+export const PRESENCE_REFRESH_INTERVAL_MS = 30_000;
+
 /**
  * How long a stale beat lingers before it is dropped entirely.
  *

package/src/runtime-execution.ts

@@ -353,8 +353,8 @@ export function parseScoutRuntimeSpec(input: string): ScoutRuntimeSpecParseResul
     };
   }
   const rawHarness = parts[0]!.trim().toLowerCase();
-  const harness = (rawHarness === "oc" ? "opencode" : rawHarness) as ScoutLaunchableHarness;
-  if (!isScoutLaunchableHarness(harness)) {
+  const harness = normalizeScoutLaunchableHarness(rawHarness);
+  if (!harness) {
     return {
       ok: false,
       error: `unsupported runtime harness "${parts[0]}"; expected one of: ${SCOUT_LAUNCHABLE_HARNESSES.join(", ")}`,
@@ -415,7 +415,7 @@ export function normalizeScoutLaunchableHarness(
 export function isScoutLaunchableHarness(value: string | null | undefined): value is ScoutLaunchableHarness {
   if (!value) return false;
   const normalized = value.trim().toLowerCase();
-  return normalized === "oc" || SCOUT_LAUNCHABLE_HARNESSES.includes(normalized as ScoutLaunchableHarness);
+  return SCOUT_LAUNCHABLE_HARNESSES.includes(normalized as ScoutLaunchableHarness);
 }
 
 export function normalizeScoutReasoningEffort(