@cline/core 0.0.73 → 0.0.74

package/dist/hub/client/managed-hub-build-watcher.d.ts

@@ -0,0 +1,47 @@
+export interface ManagedHubBuildMismatchEvent {
+    /** WebSocket URL of the live managed Hub that does not match this build. */
+    url: string;
+    /** Why this client should update: the running Hub is a newer build this
+     * client stays attached to, or it speaks an unsupported protocol. */
+    reason: "unsupported_protocol" | "build_mismatch";
+    /** Build identity reported by the running Hub, when it reports one. */
+    hubBuildId?: string;
+    /** Core package version reported by the running Hub. */
+    hubCoreVersion?: string;
+    /** Build identity this client expects a managed Hub to match. */
+    expectedBuildId: string;
+}
+/**
+ * Probe the managed local Hub once and report whether a live Hub is running
+ * a build this client cannot manage. Returns `undefined` when there is no
+ * discovery record, the recorded Hub is unreachable, a Hub startup
+ * transaction is in flight (another client may be mid-replacement), or the
+ * running Hub matches this build.
+ *
+ * A mismatch means another Cline installation replaced the shared Hub with a
+ * different build (for example, the CLI was updated while the desktop app
+ * kept running). This client can keep talking to it over the compatible wire
+ * protocol, but it should prompt the user to update and restart so client
+ * and Hub run the same code again.
+ */
+export declare function checkManagedHubBuildMismatch(): Promise<ManagedHubBuildMismatchEvent | undefined>;
+export interface WatchManagedHubBuildOptions {
+    onMismatch: (event: ManagedHubBuildMismatchEvent) => void;
+    intervalMs?: number;
+}
+/**
+ * Periodically watch the managed local Hub for a build-identity mismatch and
+ * invoke `onMismatch` when another Cline installation has replaced the Hub
+ * with a different build. Fires once per observed Hub build (it will fire
+ * again only if the Hub changes to yet another mismatched build after a
+ * compatible one was seen, or a different mismatch reason appears).
+ *
+ * Start this only for managed Hub usage. Hosts configured with an explicit
+ * Hub endpoint keep protocol-only compatibility and must not show update
+ * prompts, so the watcher refuses to start when `CLINE_HUB_PORT` is set.
+ * The first check runs after one interval so app startup (which may itself
+ * be replacing a stale Hub) has settled.
+ *
+ * Returns a stop function.
+ */
+export declare function watchManagedHubBuildMismatch(options: WatchManagedHubBuildOptions): () => void;