@pellux/goodvibes-sdk 0.33.36 → 0.33.38

package/dist/client-auth/control-plane-auth-snapshot.d.ts

@@ -1,15 +1,38 @@
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Authentication mode reported by the daemon control plane.
+ *
+ * - `'anonymous'` — no credentials were supplied.
+ * - `'invalid'` — credentials were supplied but are not recognised.
+ * - `'session'` — authenticated via a session cookie.
+ * - `'shared-token'` — authenticated via a shared bearer token.
+ */
 export type ControlPlaneAuthMode = 'anonymous' | 'invalid' | 'session' | 'shared-token';
+/**
+ * Point-in-time snapshot of the daemon control-plane auth state for the
+ * current request principal. Returned by `sdk.auth.current()` and used
+ * internally by `PermissionResolver`.
+ */
 export interface ControlPlaneAuthSnapshot {
+    /** `true` when the principal is authenticated (mode is `'session'` or `'shared-token'`). */
     readonly authenticated: boolean;
+    /** The authentication mode active for this request. */
     readonly authMode: ControlPlaneAuthMode;
+    /** `true` when any token value was present on the request (regardless of validity). */
     readonly tokenPresent: boolean;
+    /** `true` when an `Authorization` header was present on the request. */
     readonly authorizationHeaderPresent: boolean;
+    /** `true` when the session cookie was present on the request. */
     readonly sessionCookiePresent: boolean;
+    /** The principal identifier (user id, bot id, etc.), or `null` for anonymous/invalid. */
     readonly principalId: string | null;
+    /** The category of the authenticated principal, or `null` when not authenticated. */
     readonly principalKind: 'user' | 'bot' | 'service' | 'token' | null;
+    /** `true` when the principal holds daemon admin privileges. */
     readonly admin: boolean;
+    /** OAuth / permission scopes granted to the principal. */
     readonly scopes: readonly string[];
+    /** Role identifiers assigned to the principal. */
     readonly roles: readonly string[];
 }
 //# sourceMappingURL=control-plane-auth-snapshot.d.ts.map

package/dist/client-auth/control-plane-auth-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane-auth-snapshot.d.ts","sourceRoot":"","sources":["../../src/client-auth/control-plane-auth-snapshot.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}
+{"version":3,"file":"control-plane-auth-snapshot.d.ts","sourceRoot":"","sources":["../../src/client-auth/control-plane-auth-snapshot.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IACpE,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}

package/dist/client-auth/oauth-types.d.ts

@@ -5,17 +5,35 @@
  * runtime-neutral entry points (auth.ts, react-native.ts, browser.ts, etc.)
  * without pulling in node:crypto.
  */
+/**
+ * Ephemeral state produced at the start of an OAuth PKCE flow.
+ * Pass this object to `completeOAuthFlow()` once the authorisation server
+ * redirects back to `redirectUri` with a `code` parameter.
+ */
 export interface OAuthStartState {
+    /** The authorisation server URL to redirect the user to. */
     readonly authorizationUrl: string;
+    /** The `state` nonce sent to the authorisation server; verify it matches on callback. */
     readonly state: string;
+    /** The PKCE code verifier; kept secret until the token exchange step. */
     readonly verifier: string;
+    /** The redirect URI registered with the authorisation server. */
     readonly redirectUri: string;
 }
+/**
+ * Normalised token payload returned after a successful OAuth token exchange.
+ * Stored in the configured `GoodVibesTokenStore` and used by `AutoRefreshCoordinator`.
+ */
 export interface OAuthTokenPayload {
+    /** The bearer access token. */
     readonly accessToken: string;
+    /** The refresh token, if issued by the provider. */
     readonly refreshToken?: string | undefined;
+    /** The token type (typically `'Bearer'`). */
     readonly tokenType: string;
+    /** Unix-epoch millisecond timestamp when `accessToken` expires, if known. */
     readonly expiresAt?: number | undefined;
+    /** Scopes granted by the token, if returned by the provider. */
     readonly scopes?: readonly string[] | undefined;
 }
 //# sourceMappingURL=oauth-types.d.ts.map

package/dist/client-auth/oauth-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth-types.d.ts","sourceRoot":"","sources":["../../src/client-auth/oauth-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACjD"}
+{"version":3,"file":"oauth-types.d.ts","sourceRoot":"","sources":["../../src/client-auth/oauth-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACjD"}

package/dist/client-auth/types.d.ts

@@ -1,10 +1,28 @@
 import type { OperatorMethodInput, OperatorMethodOutput } from '@pellux/goodvibes-contracts';
+/** Response shape returned by `sdk.auth.current()` — the daemon's view of the current principal. */
 export type GoodVibesCurrentAuth = OperatorMethodOutput<'control.auth.current'>;
+/** Input payload for `sdk.auth.login()` — typically `{ username, password }`. */
 export type GoodVibesLoginInput = OperatorMethodInput<'control.auth.login'>;
+/** Successful login response, including the issued token and optional `expiresAt` (Unix ms). */
 export type GoodVibesLoginOutput = OperatorMethodOutput<'control.auth.login'>;
+/**
+ * Minimal token storage contract used by the GoodVibes SDK.
+ *
+ * Implement this interface when you need custom token persistence (e.g.
+ * encrypted storage, platform keychains, or external secret stores).
+ * For common use cases, use the built-in factories:
+ * - `createMemoryTokenStore` — in-memory (default when `authToken` is provided)
+ * - `createBrowserTokenStore` — `localStorage`-backed (browser)
+ * - `createExpoSecureTokenStore` — Expo secure store (React Native Expo)
+ * - `createIOSKeychainTokenStore` — iOS Keychain (bare React Native)
+ * - `createAndroidKeystoreTokenStore` — Android Keystore (bare React Native)
+ */
 export interface GoodVibesTokenStore {
+    /** Return the stored auth token, or `null` if none is present. */
     getToken(): Promise<string | null>;
+    /** Persist a new token, or clear storage when `null` is passed. */
     setToken(token: string | null): Promise<void>;
+    /** Equivalent to `setToken(null)` — removes the stored token. */
     clearToken(): Promise<void>;
 }
 /**
@@ -22,7 +40,15 @@ export interface GoodVibesExpiringTokenStore extends GoodVibesTokenStore {
     }>;
     setTokenEntry(token: string | null, expiresAt?: number): Promise<void>;
 }
+/** Options for `sdk.auth.login()`. */
 export interface GoodVibesAuthLoginOptions {
+    /**
+     * When `true` (default), automatically persist the token returned by the
+     * login response into the configured token store. Set to `false` to handle
+     * persistence manually.
+     *
+     * @defaultValue true
+     */
     readonly persistToken?: boolean | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/client-auth/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client-auth/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,aAAa,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client-auth/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,oGAAoG;AACpG,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;AAChF,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAC5E,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,iEAAiE;IACjE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,aAAa,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,sCAAsC;AACtC,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C"}

package/dist/client.d.ts

@@ -164,8 +164,11 @@ export interface GoodVibesSdkOptions {
  * Options controlling realtime transport behaviour.
  */
 export interface GoodVibesRealtimeOptions {
+    /** Reconnect policy for the SSE event-source connection. */
     readonly sseReconnect?: StreamReconnectPolicy | undefined;
+    /** Reconnect policy for the WebSocket connection. */
     readonly webSocketReconnect?: StreamReconnectPolicy | undefined;
+    /** Called when the realtime transport encounters an unrecoverable error. */
     readonly onError?: ((error: unknown) => void) | undefined;
 }
 /**
@@ -193,7 +196,26 @@ export interface GoodVibesRealtimeOptions {
  * });
  */
 export interface GoodVibesRealtime {
+    /**
+     * Open a Server-Sent Events stream and return a typed event bus.
+     *
+     * The connection is established lazily on the first `.on()` subscription.
+     * Each call to `viaSse()` returns a fresh, independent event bus.
+     *
+     * @returns A `RemoteRuntimeEvents` instance subscribed to all runtime event domains.
+     */
     viaSse(): RemoteRuntimeEvents<AnyRuntimeEvent>;
+    /**
+     * Open a WebSocket connection and return a typed event bus.
+     *
+     * Optionally pass a custom `WebSocket` constructor (required in Node.js < 21
+     * or when using a polyfill). Falls back to `options.WebSocketImpl` supplied
+     * at SDK construction time, then `globalThis.WebSocket`.
+     *
+     * @param webSocketImpl - Optional WebSocket constructor override.
+     * @returns A `RemoteRuntimeEvents` instance subscribed to all runtime event domains.
+     * @throws `ConfigurationError` when no WebSocket implementation is available.
+     */
     viaWebSocket(webSocketImpl?: typeof WebSocket): RemoteRuntimeEvents<AnyRuntimeEvent>;
 }
 /**

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/contracts/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.33.36"
+    "version": "0.33.38"
   },
   "auth": {
     "modes": [
@@ -5770,7 +5770,7 @@
       {
         "id": "automation.jobs.list",
         "title": "List Automation Jobs",
-        "description": "Return automation jobs and recent runs.",
+        "description": "Return automation jobs and recent runs. Without ?limit/?cursor returns { jobs: [...] } (backward compatible). With ?limit=N (1–500, default 100) and optional ?cursor=<opaque> returns a PaginatedResponse envelope { items, hasMore, nextCursor? }. Invalid cursors return HTTP 400.",
         "category": "automation",
         "source": "builtin",
         "access": "authenticated",
@@ -5790,7 +5790,14 @@
         ],
         "inputSchema": {
           "type": "object",
-          "properties": {},
+          "properties": {
+            "limit": {
+              "type": "number"
+            },
+            "cursor": {
+              "type": "string"
+            }
+          },
           "additionalProperties": false
         },
         "outputSchema": {
@@ -10115,7 +10122,7 @@
       {
         "id": "automation.runs.list",
         "title": "List Automation Runs",
-        "description": "Return automation run history.",
+        "description": "Return automation run history. Without ?limit/?cursor returns { runs: [...] } (backward compatible). With ?limit=N (1–500, default 100) and optional ?cursor=<opaque> returns a PaginatedResponse envelope { items, hasMore, nextCursor? }. Invalid cursors return HTTP 400.",
         "category": "automation",
         "source": "builtin",
         "access": "authenticated",
@@ -10132,7 +10139,14 @@
         },
         "inputSchema": {
           "type": "object",
-          "properties": {},
+          "properties": {
+            "limit": {
+              "type": "number"
+            },
+            "cursor": {
+              "type": "string"
+            }
+          },
           "additionalProperties": false
         },
         "outputSchema": {
@@ -39211,7 +39225,7 @@
       {
         "id": "knowledge.nodes.list",
         "title": "List Knowledge Nodes",
-        "description": "Return compiled knowledge nodes.",
+        "description": "Return compiled knowledge nodes. Without ?limit/?cursor returns { nodes: [...] } (backward compatible). With ?limit=N (1–1000, default 100) and optional ?cursor=<opaque> returns a PaginatedResponse envelope { items, hasMore, nextCursor? }. Fetch cap is 5 000 items per request (knowledge store does not support cursor/offset range queries natively). Invalid cursors return HTTP 400.",
         "category": "knowledge",
         "source": "builtin",
         "access": "authenticated",
@@ -39232,6 +39246,9 @@
             "limit": {
               "type": "number"
             },
+            "cursor": {
+              "type": "string"
+            },
             "knowledgeSpaceId": {
               "type": "string"
             },
@@ -43071,7 +43088,7 @@
       {
         "id": "knowledge.sources.list",
         "title": "List Knowledge Sources",
-        "description": "Return ingested structured knowledge sources.",
+        "description": "Return ingested structured knowledge sources. Without ?limit/?cursor returns { sources: [...] } (backward compatible). With ?limit=N (1–1000, default 100) and optional ?cursor=<opaque> returns a PaginatedResponse envelope { items, hasMore, nextCursor? }. Fetch cap is 5 000 items per request (knowledge store does not support cursor/offset range queries natively). Invalid cursors return HTTP 400.",
         "category": "knowledge",
         "source": "builtin",
         "access": "authenticated",
@@ -43092,6 +43109,9 @@
             "limit": {
               "type": "number"
             },
+            "cursor": {
+              "type": "string"
+            },
             "knowledgeSpaceId": {
               "type": "string"
             },
@@ -54793,6 +54813,60 @@
         },
         "invokable": true
       },
+      {
+        "id": "memory.review-queue",
+        "title": "Memory Review Queue",
+        "description": "Return memory records prioritised for review. Accepts optional limit (?limit=N) and scope filter (?scope=session|project|team). A scope query parameter that is present but not one of the three valid values returns 400.",
+        "category": "memory",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "read:memory"
+        ],
+        "http": {
+          "method": "GET",
+          "path": "/api/memory/review-queue"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "limit": {
+              "type": "number"
+            },
+            "scope": {
+              "type": "string",
+              "enum": [
+                "session",
+                "project",
+                "team"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "records": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true
+              }
+            }
+          },
+          "required": [
+            "records"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "memory.vector.rebuild",
         "title": "Rebuild Memory Vector Index",
@@ -75035,10 +75109,10 @@
       }
     ],
     "schemaCoverage": {
-      "methods": 279,
-      "typedInputs": 279,
+      "methods": 280,
+      "typedInputs": 280,
       "genericInputs": 0,
-      "typedOutputs": 279,
+      "typedOutputs": 280,
       "genericOutputs": 0
     },
     "eventCoverage": {

package/dist/events/knowledge.d.ts

@@ -8,6 +8,37 @@ export type KnowledgeEvent = {
     connectorId: string;
     sourceType: string;
     uri?: string | undefined;
+}
+/**
+ * Granular progress update during a knowledge ingest pipeline run.
+ *
+ * Emitted by the knowledge ingest engine at each processing phase so UIs can
+ * render live progress bars for long-running ingest operations (e.g. large
+ * document sets, semantic indexing).
+ *
+ * **Integration note:** Emission sites live in `platform/knowledge`. Wire by calling
+ * `bus.emit('knowledge', { type: 'KNOWLEDGE_INGEST_PROGRESS', ... })` at each
+ * phase-transition or item-complete checkpoint in the ingest pipeline. The contract
+ * is defined here so SDK consumers can subscribe without depending on the internal
+ * knowledge module.
+ *
+ * **Scope note:** `operationId` is operation-scoped (not task-scoped). See `lifecycle.ts`
+ * for the guard that ties progress events to their originating operation lifecycle.
+ */
+ | {
+    type: 'KNOWLEDGE_INGEST_PROGRESS';
+    /** Stable ingest operation identifier (matches KNOWLEDGE_INGEST_STARTED.sourceId). */
+    operationId: string;
+    /** Current pipeline phase (e.g. `'downloading'`, `'parsing'`, `'chunking'`, `'embedding'`, `'indexing'`). */
+    phase: string;
+    /** Items processed in the current phase so far. */
+    completed: number;
+    /** Total items for this phase (undefined if not yet determined). */
+    total?: number | undefined;
+    /** Completion percentage 0–100 (undefined if total unknown). */
+    percent?: number | undefined;
+    /** Optional human-readable status message (e.g. current file name). */
+    message?: string | undefined;
 } | {
     type: 'KNOWLEDGE_INGEST_COMPLETED';
     sourceId: string;

package/dist/events/knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/events/knowledge.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,gCAAgC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;CAC7C,GACD;IACE,IAAI,EAAE,+BAA+B,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/events/knowledge.ts"],"names":[],"mappings":"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"}

package/dist/events/tasks.d.ts

@@ -55,6 +55,64 @@ export type TaskEvent =
     taskId: string;
     agentId?: string | undefined;
     reason?: string | undefined;
+}
+/**
+ * Granular progress update for a batch job running as a task.
+ *
+ * Emitted by the batch processor as each item completes. UIs should use this
+ * to render progress bars and ETA estimates for long-running batch operations.
+ *
+ * **Integration note:** Emission sites live in `platform/batch`. Wire by calling
+ * `bus.emit('tasks', { type: 'BATCH_JOB_PROGRESS', ... })` at each item-complete
+ * checkpoint inside the batch runner. The contract is defined here so SDK consumers
+ * can subscribe to it without depending on the internal batch module.
+ *
+ * **Scope note:** `operationId` is operation-scoped (not task-scoped). See `lifecycle.ts`
+ * for the guard that ties progress events to their originating operation lifecycle.
+ */
+ | {
+    type: 'BATCH_JOB_PROGRESS';
+    /** Stable identifier for this batch operation (survives retries). */
+    operationId: string;
+    /** Human-readable label for the current processing phase (e.g. `'embedding'`, `'indexing'`). */
+    phase: string;
+    /** Number of items completed so far. */
+    completed: number;
+    /** Total items in the batch (undefined if not yet known). */
+    total?: number | undefined;
+    /** Completion percentage 0–100 (undefined if total unknown). */
+    percent?: number | undefined;
+    /** Optional human-readable status message. */
+    message?: string | undefined;
+}
+/**
+ * Granular progress update for an export operation.
+ *
+ * Emitted by the export engine as records are serialised. UIs should use this
+ * to render progress indicators for long-running export jobs.
+ *
+ * **Integration note:** Emission sites live in `platform/export`. Wire by calling
+ * `bus.emit('tasks', { type: 'EXPORT_PROGRESS', ... })` at each record-write
+ * checkpoint inside the export runner. The contract is defined here so SDK consumers
+ * can subscribe without depending on the internal export module.
+ *
+ * **Scope note:** `operationId` is operation-scoped (not task-scoped). See `lifecycle.ts`
+ * for the guard that ties progress events to their originating operation lifecycle.
+ */
+ | {
+    type: 'EXPORT_PROGRESS';
+    /** Stable identifier for this export operation. */
+    operationId: string;
+    /** Current phase of the export pipeline (e.g. `'querying'`, `'serializing'`, `'compressing'`). */
+    phase: string;
+    /** Records exported so far. */
+    completed: number;
+    /** Total records to export (undefined if not yet determined). */
+    total?: number | undefined;
+    /** Completion percentage 0–100 (undefined if total unknown). */
+    percent?: number | undefined;
+    /** Optional human-readable status message (e.g. estimated time remaining). */
+    message?: string | undefined;
 };
 /** All task event type literals as a union. */
 export type TaskEventType = TaskEvent['type'];

package/dist/events/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/events/tasks.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;GAIG;AAEH,MAAM,MAAM,SAAS;AACnB,qDAAqD;AACnD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACnG,kCAAkC;GAChC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,2DAA2D;GACzD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5E,yCAAyC;GACvC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AACjG,mCAAmC;GACjC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAClF,iCAAiC;GAC/B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC9F,4CAA4C;GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1G,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/events/tasks.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;GAIG;AAEH,MAAM,MAAM,SAAS;AACnB,qDAAqD;AACnD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACnG,kCAAkC;GAChC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,2DAA2D;GACzD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5E,yCAAyC;GACvC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AACjG,mCAAmC;GACjC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAClF,iCAAiC;GAC/B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC9F,4CAA4C;GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;AACvG;;;;;;;;;;;;;GAaG;GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AACH;;;;;;;;;;;;;GAaG;GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEN,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC"}

package/dist/events/transport.d.ts

@@ -83,6 +83,66 @@ export type TransportEvent =
     subscriberId: string;
     streamType: string;
     reason?: string;
+}
+/**
+ * The outbound WebSocket queue has saturated and messages are being dropped.
+ *
+ * This event is emitted when `MAX_OUTBOUND_QUEUE` entries or `MAX_OUTBOUND_QUEUE_BYTES`
+ * total bytes are exceeded, or when a single message exceeds `MAX_OUTBOUND_MESSAGE_BYTES`.
+ * Subscribe to this in UI layers to show a "connection lagging" indicator.
+ *
+ * The `onBackpressure` callback in `RuntimeEventConnectorOptions` fires at the same
+ * time and provides identical information for non-event-bus consumers.
+ */
+ | {
+    type: 'TRANSPORT_BACKPRESSURE';
+    /** Transport/connector identifier (domain name for WS connectors). */
+    transportId: string;
+    /** Number of messages dropped since the last successful queue flush. */
+    droppedCount: number;
+    /** Current number of messages waiting in the outbound buffer. */
+    queueLength: number;
+    /** Current byte footprint of the outbound buffer. */
+    queueBytes: number;
+    /** Overflow reason. */
+    reason: 'message_too_large' | 'queue_full';
+}
+/**
+ * The realtime transport connection state has changed.
+ *
+ * Emitted by `createWebSocketConnector` on every state transition. Subscribe
+ * to this in UI layers to drive connection-state badges (e.g. online/reconnecting
+ * indicators).
+ *
+ * The `onConnectionStateChange` callback in `RuntimeEventConnectorOptions` fires
+ * at the same time and provides the same state string for non-event-bus consumers.
+ */
+ | {
+    type: 'TRANSPORT_CONNECTION_STATE';
+    /** Transport/connector identifier (domain name for WS connectors). */
+    transportId: string;
+    /** New connection state. */
+    state: 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'failed';
+}
+/**
+ * A realtime transport reconnect attempt is scheduled.
+ *
+ * Provides richer reconnect metadata than `TRANSPORT_RECONNECTING` (which only
+ * carries `attempt` and `maxAttempts`). Subscribe to this for detailed backoff
+ * visualisation in diagnostic UIs.
+ */
+ | {
+    type: 'TRANSPORT_RECONNECT_ATTEMPT';
+    /** Transport/connector identifier (domain name for WS connectors). */
+    transportId: string;
+    /** 1-based attempt index. */
+    attempt: number;
+    /** Maximum attempts configured. */
+    maxAttempts: number;
+    /** Milliseconds the connector will wait before the next connect call. */
+    delayMs: number;
+    /** Human-readable reason for the reconnect. */
+    reason: string;
 };
 /** All transport event type literals as a union. */
 export type TransportEventType = TransportEvent['type'];

package/dist/events/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/events/transport.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;GAIG;AAEH,MAAM,MAAM,cAAc;AACxB,4CAA4C;AAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC3E,4DAA4D;GAC1D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC3D,qDAAqD;GACnD;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACxE,wDAAwD;GACtD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACpD,qEAAqE;GACnE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrE,4DAA4D;GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC/F,4CAA4C;GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;AAC9F,6DAA6D;GAC3D;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC5E,4DAA4D;GAC1D;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrI,+CAA+C;GAC7C;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACjG,uDAAuD;GACrD;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACrG,4DAA4D;GAC1D;IAAE,IAAI,EAAE,gCAAgC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5H,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/events/transport.ts"],"names":[],"mappings":"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"}

package/dist/platform/agents/wrfc-config.d.ts

@@ -10,9 +10,15 @@ export type WrfcConfigLike = {
         command: string;
         enabled: boolean;
     }>;
+    /**
+     * How long (in ms) to wait for an agent event before treating a running agent
+     * as hung/silent and failing the chain. Default: 0 (disabled).
+     */
+    agentHeartbeatTimeoutMs: number;
 };
 export type WrfcConfigReader = Pick<ConfigManager, 'get' | 'getCategory'>;
 export declare function readWrfcConfig(configManager: WrfcConfigReader): WrfcConfigLike;
+export declare function getWrfcAgentHeartbeatTimeoutMs(configManager: WrfcConfigReader): number;
 export declare function getWrfcScoreThreshold(configManager: WrfcConfigReader): number;
 export declare function getWrfcMaxFixAttempts(configManager: WrfcConfigReader): number;
 export declare function getWrfcAutoCommit(configManager: WrfcConfigReader): boolean;

package/dist/platform/agents/wrfc-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrfc-config.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AACxH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;AAE1E,wBAAgB,cAAc,CAAC,aAAa,EAAE,gBAAgB,GAAG,cAAc,CAiB9E;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAE7E;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,gBAAgB,GAAG,OAAO,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC,CAE5F"}
+{"version":3,"file":"wrfc-config.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AACxH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;AAE1E,wBAAgB,cAAc,CAAC,aAAa,EAAE,gBAAgB,GAAG,cAAc,CAqB9E;AAED,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAEtF;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAE7E;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,gBAAgB,GAAG,OAAO,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC,CAE5F"}

package/dist/platform/agents/wrfc-config.js

@@ -11,8 +11,14 @@ export function readWrfcConfig(configManager) {
             ? configManager.get('wrfc.autoCommit')
             : wrfcConfig?.autoCommit ?? false,
         gates: Array.isArray(wrfcConfig?.gates) ? wrfcConfig.gates : [],
+        agentHeartbeatTimeoutMs: typeof configManager.get('wrfc.agentHeartbeatTimeoutMs') === 'number'
+            ? configManager.get('wrfc.agentHeartbeatTimeoutMs')
+            : wrfcConfig?.agentHeartbeatTimeoutMs ?? 0,
     };
 }
+export function getWrfcAgentHeartbeatTimeoutMs(configManager) {
+    return readWrfcConfig(configManager).agentHeartbeatTimeoutMs ?? 0;
+}
 export function getWrfcScoreThreshold(configManager) {
     return readWrfcConfig(configManager).scoreThreshold ?? 9.9;
 }