@relaycast/engine 12.1.0 → 12.2.0

package/dist/ports/nodeLiveness.d.ts

@@ -0,0 +1,23 @@
+import type { EngineDb } from './database.js';
+/** A host-owned receipt lease. All timestamps are server epoch milliseconds. */
+export interface NodeLivenessSnapshot {
+    status: 'online' | 'offline' | 'unknown';
+    providers: Array<{
+        name: string;
+        connection_id?: string;
+        instance_id?: string;
+        last_received_at: number;
+        expires_at: number;
+        live: boolean;
+        handlers_live: boolean;
+    }>;
+}
+/** Hosts bound RPC deadlines; unavailable authority returns unknown. The socket
+ * owner independently rechecks its generation and receipt lease at final send. */
+export interface NodeLivenessAuthority {
+    inspect(workspaceId: string, nodeId: string): Promise<NodeLivenessSnapshot>;
+}
+/** Bind all HTTP, maintenance and socket-owner database wrappers. */
+export declare function configureNodeLiveness(db: EngineDb, authority?: NodeLivenessAuthority): void;
+export declare function nodeLivenessAuthority(db: EngineDb): NodeLivenessAuthority | undefined;
+//# sourceMappingURL=nodeLiveness.d.ts.map

package/dist/ports/nodeLiveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeLiveness.d.ts","sourceRoot":"","sources":["../../src/ports/nodeLiveness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC;QACd,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AACD;kFACkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7E;AAGD,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAG3F;AACD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,qBAAqB,GAAG,SAAS,CAErF"}

package/dist/ports/nodeLiveness.js

@@ -0,0 +1,12 @@
+const authorities = new WeakMap();
+/** Bind all HTTP, maintenance and socket-owner database wrappers. */
+export function configureNodeLiveness(db, authority) {
+    if (authority)
+        authorities.set(db, authority);
+    else
+        authorities.delete(db);
+}
+export function nodeLivenessAuthority(db) {
+    return authorities.get(db);
+}
+//# sourceMappingURL=nodeLiveness.js.map

package/dist/ports/nodeLiveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeLiveness.js","sourceRoot":"","sources":["../../src/ports/nodeLiveness.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,GAAG,IAAI,OAAO,EAAiC,CAAC;AACjE,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,EAAY,EAAE,SAAiC;IACnF,IAAI,SAAS;QAAE,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;;QACzC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,EAAY;IAChD,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ports/presence.d.ts

@@ -12,6 +12,13 @@ export interface PresenceTracker {
     disconnect(workspaceId: string, agentId: string, agentName?: string): Promise<void>;
     /** Return the agent IDs currently considered online for a workspace. */
     getOnline(workspaceId: string): Promise<string[]>;
+    /**
+     * Independent REST/tracker heartbeats only, without node-owner probes.
+     * Authority-enabled engines use this optional narrow read to avoid probing
+     * every node twice; omission falls back to getOnline for existing adapters.
+     * A node-derived-only adapter returns an empty list here.
+     */
+    getTrackedOnline?(workspaceId: string): Promise<string[]>;
     /**
      * Agents that called disconnect and have not heartbeated since.
      * Node-derived presence must not put these ids back online. A host that

package/dist/ports/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/ports/presence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF,+DAA+D;IAC/D,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,wEAAwE;IACxE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAElD;;;;;OAKG;IACH,sBAAsB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,uBAAuB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/ports/presence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF,+DAA+D;IAC/D,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,wEAAwE;IACxE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAElD;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,sBAAsB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,uBAAuB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relaycast/engine",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "type": "module",
   "description": "Portable, platform-agnostic engine for Relaycast — channels, threads, DMs, presence, real-time events. Runs on Node + SQLite (self-host) or behind a Cloudflare Durable Object adapter (hosted).",
   "bin": {
@@ -62,8 +62,8 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.13.7",
-    "@relaycast/a2a": "12.1.0",
-    "@relaycast/types": "12.1.0",
+    "@relaycast/a2a": "12.2.0",
+    "@relaycast/types": "12.2.0",
     "better-sqlite3": "^11.10.0",
     "drizzle-orm": "^0.45.1",
     "hono": "^4.11.9",