@deepseek-ai/dsh-api-session-controller 0.2.0-rc.1 → 0.2.1-alpha.1

package/lib/index.js

@@ -17,6 +17,8 @@ import { SessionTitleInvalidError } from "@deepseek-ai/dsh-session-title";
 import { canonicalClientTimeZone } from "@deepseek-ai/dsh-util-time";
 import { assertNever } from "@deepseek-ai/dsh-util-values";
 import { Deque } from "@deepseek-ai/dsh-deque";
+import { performance } from "node:perf_hooks";
+import { scheduler } from "node:timers/promises";
 import { z as z$1 } from "zod";
 import { isUserInvocable } from "@deepseek-ai/dsh-skill";
 import { FsError } from "@deepseek-ai/dsh-fs";
@@ -1831,9 +1833,14 @@ function truncateUnicodeCodePoints(value, maximum) {
 /** Owns list projection registration, bounded cold summaries, and authorized search. */
 var ApiSessionList = class {
 	ctx;
-	/** @param ctx - Host context carrying Session, query, persistence, and projection services. */
-	constructor(ctx) {
+	workSliceMs;
+	/**
+	* @param ctx - Host context carrying Session, query, persistence, and projection services.
+	* @param workSliceMs - Resolved positive integral list-work budget in milliseconds.
+	*/
+	constructor(ctx, workSliceMs) {
 		this.ctx = ctx;
+		this.workSliceMs = workSliceMs;
 		ctx.sessionProjections.register({
 			key: "sessionListMetadata",
 			stateSchema: sessionListMetadataSchema,
@@ -1882,7 +1889,7 @@ var ApiSessionList = class {
 	}
 	/**
 	* Read every visible attached and persisted Session without activating an Agent.
-	* @param signal - optional cancellation for persistence reads.
+	* @param signal - optional cancellation for persistence reads and summary generation.
 	* @returns visible Session summaries ordered by activity.
 	*/
 	async list(signal) {
@@ -1891,16 +1898,28 @@ var ApiSessionList = class {
 		signal?.throwIfAborted();
 		const items = [];
 		const cold = [];
+		let yieldDeadline = performance.now() + this.workSliceMs;
 		for (const record of records) {
+			signal?.throwIfAborted();
 			const live = this.ctx.sessions.get(record.header.id);
-			if (live !== void 0) {
-				items.push(this.summaryFor(live));
-				continue;
+			if (live !== void 0) items.push(this.summaryFor(live));
+			else if (record.header.cwd !== void 0) cold.push(record.header);
+			if (performance.now() >= yieldDeadline) {
+				await scheduler.yield();
+				signal?.throwIfAborted();
+				yieldDeadline = performance.now() + this.workSliceMs;
+			}
+		}
+		for (const header of cold) {
+			signal?.throwIfAborted();
+			items.push(this.summarizeCold(header));
+			if (performance.now() >= yieldDeadline) {
+				await scheduler.yield();
+				signal?.throwIfAborted();
+				yieldDeadline = performance.now() + this.workSliceMs;
 			}
-			if (record.header.cwd === void 0) continue;
-			cold.push(record.header);
 		}
-		for (const header of cold) items.push(this.summarizeCold(header));
+		signal?.throwIfAborted();
 		items.sort((left, right) => right.updatedAt - left.updatedAt);
 		return items;
 	}
@@ -2826,7 +2845,10 @@ let SessionController = (() => {
 			"typert",
 			"workspaceRegistry"
 		];
-		static Config = z.object({ nativeOpen: z.boolean() });
+		static Config = z.object({
+			nativeOpen: z.boolean(),
+			listWorkSliceMs: z.natural().min(1).default(16)
+		});
 		agents = __runInitializers(this, _instanceExtraInitializers);
 		commands;
 		controlState;
@@ -2840,11 +2862,12 @@ let SessionController = (() => {
 		promotions = /* @__PURE__ */ new Set();
 		/**
 		* @param ctx - Host context containing the Session capability assembly.
-		* @param config - native-opener deployment policy.
+		* @param config - native-opener and list-scheduling deployment policy.
 		* @param internals - host integrations replaceable by direct unit tests.
 		*/
 		constructor(ctx, config, internals = {}) {
 			super(ctx, "sessionController", { namespace: "session" });
+			const resolved = SessionController.Config(config);
 			installModelSelectionProjection(ctx);
 			this.agents = new ApiSessionAgentController(ctx);
 			this.commands = new SessionCommandController(ctx, this.agents, process.cwd());
@@ -2860,7 +2883,7 @@ let SessionController = (() => {
 			this.history = new SessionHistoryController(ctx, (observation) => {
 				this.promote(observation);
 			});
-			this.listState = new ApiSessionList(ctx);
+			this.listState = new ApiSessionList(ctx, resolved.listWorkSliceMs);
 			this.fileApplications = internals.fileApplications ?? nativeFileApplications;
 			this.openFileApplication = internals.openFileApplication ?? openNativeFileApplication;
 			this.openPath = internals.openPath ?? openNativeAssociatedPath;
@@ -2948,7 +2971,7 @@ let SessionController = (() => {
 		/**
 		* Read all visible Session rows without resuming an Agent.
 		* @param _request - reserved empty list request.
-		* @param signal - cancellation for persistence reads.
+		* @param signal - cancellation for persistence reads and summary generation.
 		* @returns visible Session summaries ordered by activity.
 		*/
 		async list(_request, signal) {