@cline/core 0.0.73 → 0.0.74

package/dist/hub/daemon/shutdown-coordinator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Kept below the caller-side retirement wait so a current daemon exits through
+ * its own cleanup deadline before an older caller considers force retirement.
+ */
+export declare const HUB_DAEMON_SHUTDOWN_DEADLINE_MS = 2000;
+export interface HubDaemonShutdownRequest {
+    reason: string;
+    exitCode: number;
+}
+export type HubDaemonShutdownState = "idle" | "shutting_down" | "forced" | "finished";
+export interface HubDaemonShutdownCoordinatorOptions {
+    deadlineMs: number;
+    cleanup(): Promise<void>;
+    exit(code: number): void;
+    onCleanupError?(error: unknown): void;
+    onForcedExit?(request: HubDaemonShutdownRequest): void;
+}
+export interface HubDaemonShutdownCoordinator {
+    request(request: HubDaemonShutdownRequest): Promise<void>;
+    force(request: HubDaemonShutdownRequest): void;
+    getState(): HubDaemonShutdownState;
+}
+/**
+ * Owns the daemon's monotonic shutdown lifecycle.
+ *
+ * Every graceful trigger shares one cleanup promise. A later fatal trigger can
+ * raise the eventual exit code, but it cannot run cleanup twice. The deadline
+ * and an explicit second-signal path both use `force`, whose exit is also
+ * guarded so an injected test exit that returns cannot be called repeatedly.
+ */
+export declare function createHubDaemonShutdownCoordinator(options: HubDaemonShutdownCoordinatorOptions): HubDaemonShutdownCoordinator;

package/dist/hub/discovery/index.d.ts

@@ -8,6 +8,7 @@ export interface HubServerDiscoveryRecord {
     capabilities?: readonly string[];
     coreVersion?: string;
     buildId?: string;
+    buildEpochMs?: number;
     authToken: string;
     host: string;
     port: number;
@@ -23,6 +24,7 @@ export type HubServerProbeRecord = {
     capabilities?: readonly string[];
     coreVersion?: string;
     buildId?: string;
+    buildEpochMs?: number;
     host: string;
     port: number;
     url: string;
@@ -38,6 +40,13 @@ export interface HubOwnerContext {
 }
 export declare function createHubAuthToken(): string;
 export declare function resolveHubBuildId(): string;
+/**
+ * When this SDK build was produced, embedded at bundle time. Orders builds so
+ * managed-Hub handling can distinguish a newer daemon (attach and prompt the
+ * user to update) from a stale one (retire and replace). Undefined when
+ * running from unbundled sources, where no meaningful ordering exists.
+ */
+export declare function resolveHubBuildEpochMs(): number | undefined;
 export type ManagedHubCompatibilityResult = {
     compatible: true;
 } | {
@@ -56,11 +65,30 @@ export type ManagedHubCompatibilityResult = {
 export declare function getManagedHubCompatibility(record: HubProtocolMetadata & {
     buildId?: string;
 }, expectedBuildId?: string): ManagedHubCompatibilityResult;
+/**
+ * Whether a client may keep using a managed local Hub instead of retiring it.
+ *
+ * Same build: always reusable. Different build: reusable only when the Hub
+ * was produced *after* this client's own build (another installation
+ * upgraded the shared Hub) - the daemon is then running newer code, so
+ * replacing it would be a downgrade; the client attaches over the compatible
+ * wire protocol and the build-mismatch watcher prompts the user to update.
+ * A Hub that is older, unordered, or missing build metadata is not reusable
+ * and gets retired and replaced, preserving the stale-daemon fix.
+ */
+export declare function isManagedHubReusable(record: HubProtocolMetadata & {
+    buildId?: string;
+    buildEpochMs?: number;
+}, options?: {
+    expectedBuildId?: string;
+    expectedBuildEpochMs?: number;
+}): boolean;
 export declare function resolveHubOwnerContext(ownerBasis?: string): HubOwnerContext;
 export declare function createInMemoryHubOwnerContext(label?: string): HubOwnerContext;
 export declare function readHubDiscovery(discoveryPath: string): Promise<HubServerDiscoveryRecord | undefined>;
 export declare function writeHubDiscovery(discoveryPath: string, record: HubServerDiscoveryRecord): Promise<void>;
 export declare function clearHubDiscovery(discoveryPath: string): Promise<void>;
+export declare function clearHubDiscoveryIfOwned(discoveryPath: string, hubId: string): Promise<boolean>;
 export declare function withHubStartupLock<T>(discoveryPath: string, callback: () => Promise<T>): Promise<T>;
 export declare function probeHubServer(url: string, options?: {
     authToken?: string;

package/dist/hub/index.d.ts

@@ -18,6 +18,7 @@ export { HubScheduleService } from "../cron/service/schedule-service";
 export { type ConfiguredTelemetryHandle, type CreateOpenTelemetryTelemetryServiceOptions, createConfiguredTelemetryHandle, createConfiguredTelemetryService, } from "../services/telemetry/OpenTelemetryProvider";
 export * from "./client";
 export * from "./client/connect";
+export * from "./client/managed-hub-build-watcher";
 export * from "./client/session-client";
 export * from "./client/ui-client";
 export * from "./daemon";