@cline/core 0.0.81-nightly.1788229734 → 0.0.82

package/dist/cron/runner/cron-runner.d.ts

@@ -1,8 +1,21 @@
 import type { BasicLogger } from "@cline/shared";
 import type { ResolveCronSpecsDirOptions } from "@cline/shared/storage";
 import type { HubScheduleRuntimeHandlers } from "../service/schedule-service";
-import type { CronRunRecord, SqliteCronStore } from "../store/sqlite-cron-store";
+import type { CronRunRecord, CronSpecRecord, SqliteCronStore } from "../store/sqlite-cron-store";
 import type { CronMaterializer } from "./cron-materializer";
+/**
+ * Session metadata keys that identify the automation run a session belongs
+ * to. Clients (e.g. the desktop sidebar) read these to group a schedule's
+ * runs together and label each one, so they are part of the session
+ * metadata contract; keep them in sync with the readers.
+ */
+export declare const RUN_SESSION_METADATA_KEYS: {
+    readonly scheduleId: "scheduleId";
+    readonly scheduleName: "scheduleName";
+    readonly scheduleExecutionId: "scheduleExecutionId";
+    readonly scheduleRunNumber: "scheduleRunNumber";
+};
+export declare function buildRunSessionMetadata(spec: Pick<CronSpecRecord, "externalId" | "title">, run: Pick<CronRunRecord, "runId">, runNumber: number | undefined): Record<string, unknown>;
 export interface CronRunnerOptions {
     store: SqliteCronStore;
     materializer: CronMaterializer;

package/dist/cron/service/schedule-service.d.ts

@@ -22,8 +22,16 @@ type HubScheduleTurnResult = {
         durationMs?: number;
     }>;
 };
+export interface HubScheduleStartSessionOptions {
+    /**
+     * Provenance the runner knows about the automation run that is starting
+     * this session (schedule id/name, run id, run number). Handlers merge it
+     * into the session metadata so clients can group runs by schedule.
+     */
+    sessionMetadata?: Record<string, unknown>;
+}
 export interface HubScheduleRuntimeHandlers {
-    startSession(request: ChatStartSessionRequest): Promise<{
+    startSession(request: ChatStartSessionRequest, options?: HubScheduleStartSessionOptions): Promise<{
         sessionId: string;
         startResult?: ChatStartSessionArtifacts;
     }>;

package/dist/cron/store/sqlite-cron-store.d.ts

@@ -198,6 +198,14 @@ export declare class SqliteCronStore {
         nowMs: number;
     }): MaterializeScheduleRunResult;
     getRun(runId: string): CronRunRecord | undefined;
+    /**
+     * 1-based position of a run among every run ever created for its spec,
+     * in creation order. Counts runs of every status (including cancelled and
+     * failed ones) so the number is stable: a later cancellation never shifts
+     * the numbers already stamped onto earlier sessions. Returns undefined
+     * for an unknown run.
+     */
+    getRunOrdinal(runId: string): number | undefined;
     insertEventLog(event: AutomationEventEnvelope, options?: {
         receivedAtIso?: string;
     }): InsertEventLogResult;

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

@@ -91,10 +91,17 @@ export declare class NodeHubClient {
 }
 export declare function normalizeHubWebSocketUrl(url: string): string;
 export declare function verifyHubConnection(url: string, options?: Pick<HubClientOptions, "workspaceRoot" | "cwd" | "authToken">): Promise<boolean>;
+export interface HubSessionActivity {
+    /** Sessions with at least one live participant attached. */
+    activeSessionCount: number;
+    /** Distinct client ids attached to those sessions. */
+    participantClientCount: number;
+}
 /**
- * Whether any client is attached to a session on the hub - the one signal
- * that cannot go stale, because participants are live socket subscriptions
- * the hub drops the moment a client's connection closes.
+ * Summarize live activity from a `session.list` payload. A session counts as
+ * active only while a client is attached to it - the one signal that cannot
+ * go stale, because participants are live socket subscriptions the hub drops
+ * the moment a client's connection closes.
  *
  * Deliberately NOT based on session status: a client that dies without
  * stopping its session leaves the hub-side runtime behind in a non-terminal
@@ -104,7 +111,17 @@ export declare function verifyHubConnection(url: string, options?: Pick<HubClien
  * exact moment of a hub swap dies with the old hub - rare, and its next
  * scheduled tick runs normally on the replacement.
  */
+export declare function summarizeHubSessionActivity(payload: unknown): HubSessionActivity;
 export declare function hasActiveHubSessions(payload: unknown): boolean;
+/**
+ * Ask a hub how much live work it is serving. Throws when the hub cannot
+ * answer (unreachable, auth rejected, or too old to serve `session.list`),
+ * because the safe default points in opposite directions per caller: a
+ * replacement path treats an unanswerable hub as idle and retires it, while
+ * a recovery path treats it as busy and leaves it alone. Callers pick their
+ * own fallback instead of inheriting a hidden one.
+ */
+export declare function queryHubSessionActivity(url: string, authToken?: string, options?: Pick<HubClientOptions, "workspaceRoot" | "cwd">): Promise<HubSessionActivity>;
 export declare function localHubHasNoActiveSessions(url: string, authToken?: string, options?: Pick<HubClientOptions, "workspaceRoot" | "cwd">): Promise<boolean>;
 export declare function resolveCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;
 export declare function ensureCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;

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

@@ -17,6 +17,14 @@ export interface ManagedHubBuildMismatchEvent {
     hubCoreVersion?: string;
     /** Build identity this client expects a managed Hub to match. */
     expectedBuildId: string;
+    /**
+     * Sessions with live participants on the Hub (best-effort, `outdated_hub`
+     * only): the work that replacing the Hub would interrupt. Unset when the
+     * Hub cannot answer the query.
+     */
+    activeSessionCount?: number;
+    /** Distinct clients attached to those sessions (best-effort, `outdated_hub` only). */
+    participantClientCount?: number;
 }
 /**
  * Probe the managed local Hub once and report whether a live Hub is running