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

package/lib/typert.remote-client.js

@@ -131,6 +131,52 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = ()
   'label': z.string(),
   'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional(),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional(),
+  'projectedTokens': z.number().optional(),
+  'contextWindow': z.number().optional(),
+}).optional(),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number(),
+  'toolsTokens': z.number(),
+  'messageTokens': z.number(),
+}).optional(),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'questions': z.array(z.object({
+  'id': z.string(),
+  'question': z.string(),
+  'detail': z.string().optional(),
+  'header': z.string().optional(),
+  'options': z.array(z.object({
+  'label': z.string(),
+  'description': z.string().optional(),
+})).optional(),
+  'multiSelect': z.boolean().optional(),
+  'intent': z.object({
+  'kind': z.literal("plan-review"),
+  'approve': z.string(),
+  'callId': z.intersection(z.string(), z.unknown()).optional(),
+}).optional(),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly(),
+  'settled': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'answers': z.array(z.object({
+  'id': z.string(),
+  'selected': z.array(z.string()),
+  'custom': z.string().optional(),
+})).readonly(),
+})).readonly(),
+}).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
   'objective': z.string().readonly(),
@@ -303,6 +349,52 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
   'label': z.string(),
   'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional(),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional(),
+  'projectedTokens': z.number().optional(),
+  'contextWindow': z.number().optional(),
+}).optional(),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number(),
+  'toolsTokens': z.number(),
+  'messageTokens': z.number(),
+}).optional(),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'questions': z.array(z.object({
+  'id': z.string(),
+  'question': z.string(),
+  'detail': z.string().optional(),
+  'header': z.string().optional(),
+  'options': z.array(z.object({
+  'label': z.string(),
+  'description': z.string().optional(),
+})).optional(),
+  'multiSelect': z.boolean().optional(),
+  'intent': z.object({
+  'kind': z.literal("plan-review"),
+  'approve': z.string(),
+  'callId': z.intersection(z.string(), z.unknown()).optional(),
+}).optional(),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly(),
+  'settled': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'answers': z.array(z.object({
+  'id': z.string(),
+  'selected': z.array(z.string()),
+  'custom': z.string().optional(),
+})).readonly(),
+})).readonly(),
+}).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
   'objective': z.string().readonly(),
@@ -465,6 +557,52 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = () =>
   'label': z.string(),
   'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional(),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional(),
+  'projectedTokens': z.number().optional(),
+  'contextWindow': z.number().optional(),
+}).optional(),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number(),
+  'toolsTokens': z.number(),
+  'messageTokens': z.number(),
+}).optional(),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'questions': z.array(z.object({
+  'id': z.string(),
+  'question': z.string(),
+  'detail': z.string().optional(),
+  'header': z.string().optional(),
+  'options': z.array(z.object({
+  'label': z.string(),
+  'description': z.string().optional(),
+})).optional(),
+  'multiSelect': z.boolean().optional(),
+  'intent': z.object({
+  'kind': z.literal("plan-review"),
+  'approve': z.string(),
+  'callId': z.intersection(z.string(), z.unknown()).optional(),
+}).optional(),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly(),
+  'settled': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'answers': z.array(z.object({
+  'id': z.string(),
+  'selected': z.array(z.string()),
+  'custom': z.string().optional(),
+})).readonly(),
+})).readonly(),
+}).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
   'objective': z.string().readonly(),
@@ -642,6 +780,52 @@ const _deepseek_ai_dsh_api_session_controller_session_projections_result$schema
   'label': z.string(),
   'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional(),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional(),
+  'projectedTokens': z.number().optional(),
+  'contextWindow': z.number().optional(),
+}).optional(),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number(),
+  'toolsTokens': z.number(),
+  'messageTokens': z.number(),
+}).optional(),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'questions': z.array(z.object({
+  'id': z.string(),
+  'question': z.string(),
+  'detail': z.string().optional(),
+  'header': z.string().optional(),
+  'options': z.array(z.object({
+  'label': z.string(),
+  'description': z.string().optional(),
+})).optional(),
+  'multiSelect': z.boolean().optional(),
+  'intent': z.object({
+  'kind': z.literal("plan-review"),
+  'approve': z.string(),
+  'callId': z.intersection(z.string(), z.unknown()).optional(),
+}).optional(),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly(),
+  'settled': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'answers': z.array(z.object({
+  'id': z.string(),
+  'selected': z.array(z.string()),
+  'custom': z.string().optional(),
+})).readonly(),
+})).readonly(),
+}).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
   'objective': z.string().readonly(),
@@ -833,7 +1017,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentValue',
         create: _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":437,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":444,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -858,7 +1042,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":457,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":464,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -873,7 +1057,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath:result',
         create: _deepseek_ai_dsh_api_session_controller_session_canOpenWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":319,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":326,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -890,7 +1074,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionControlFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_control_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":520,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":527,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -915,7 +1099,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateValue',
         create: _deepseek_ai_dsh_api_session_controller_session_create_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":273,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":280,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -942,7 +1126,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_follow_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":480,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":487,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -967,7 +1151,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkValue',
         create: _deepseek_ai_dsh_api_session_controller_session_fork_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":415,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":422,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel',
@@ -982,7 +1166,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel:result',
         create: _deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":292,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":299,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -1008,7 +1192,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListValue',
         create: _deepseek_ai_dsh_api_session_controller_session_list_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":252,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":259,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -1023,7 +1207,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#ModelCatalog',
         create: _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":310,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":317,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -1049,7 +1233,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathValue',
         create: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":340,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -1075,7 +1259,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPage',
         create: _deepseek_ai_dsh_api_session_controller_session_page_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":468,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":475,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/projections',
@@ -1101,7 +1285,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionProjectionsValue',
         create: _deepseek_ai_dsh_api_session_controller_session_projections_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":491,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":498,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -1127,7 +1311,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptValue',
         create: _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":426,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":433,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1152,7 +1336,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameValue',
         create: _deepseek_ai_dsh_api_session_controller_session_rename_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":403,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":410,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1178,7 +1362,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchValue',
         create: _deepseek_ai_dsh_api_session_controller_session_search_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":263,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":270,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1203,7 +1387,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_selectModel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":283,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":290,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1228,7 +1412,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueValue',
         create: _deepseek_ai_dsh_api_session_controller_session_updateQueue_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":447,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":454,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications',
@@ -1254,7 +1438,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications:result',
         create: _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":370,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":377,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',

package/lib/types/index.d.ts

@@ -22,7 +22,13 @@ declare module '@deepseek-ai/cordis' {
 export interface Config {
     /** Override platform desktop-opener detection. */
     readonly nativeOpen?: boolean;
+    /** Positive integral milliseconds of list work before yielding between complete rows. */
+    readonly listWorkSliceMs?: number;
 }
+/** Deployment policy after schema defaults have been applied. */
+type ResolvedConfig = Config & {
+    readonly listWorkSliceMs: number;
+};
 /** Host integrations replaceable by direct unit tests. */
 export interface SessionControllerInternals {
     /** Native default-application handoff. */
@@ -39,7 +45,7 @@ export interface SessionControllerInternals {
 /** Host service backing the generated `ctx.remote.session` namespace. */
 export declare class SessionController extends TypertRemoteService {
     static inject: string[];
-    static Config: z<Config>;
+    static Config: z<Config, ResolvedConfig>;
     private readonly agents;
     private readonly commands;
     private readonly controlState;
@@ -53,7 +59,7 @@ export declare class SessionController extends TypertRemoteService {
     private readonly promotions;
     /**
      * @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: Context, config: Config, internals?: SessionControllerInternals);
@@ -74,7 +80,7 @@ export declare class SessionController extends TypertRemoteService {
     /**
      * 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.
      */
     list(_request: SessionListRequest, signal: AbortSignal): Promise<SessionListValue>;

package/lib/types/index.js

@@ -187,6 +187,7 @@ let SessionController = (() => {
         ];
         static Config = z.object({
             nativeOpen: z.boolean(),
+            listWorkSliceMs: z.natural().min(1).default(16),
         });
         agents = __runInitializers(this, _instanceExtraInitializers);
         commands;
@@ -201,11 +202,12 @@ let SessionController = (() => {
         promotions = 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());
@@ -222,7 +224,7 @@ let SessionController = (() => {
                 await Promise.allSettled([...this.promotions]);
             }, 'session-controller.promotions');
             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;
@@ -318,7 +320,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) {

package/lib/types/list.d.ts

@@ -19,8 +19,12 @@ export declare function truncateUnicodeCodePoints(value: string, maximum: number
 /** Owns list projection registration, bounded cold summaries, and authorized search. */
 export declare class ApiSessionList {
     private readonly ctx;
-    /** @param ctx - Host context carrying Session, query, persistence, and projection services. */
-    constructor(ctx: Context);
+    private readonly workSliceMs;
+    /**
+     * @param ctx - Host context carrying Session, query, persistence, and projection services.
+     * @param workSliceMs - Resolved positive integral list-work budget in milliseconds.
+     */
+    constructor(ctx: Context, workSliceMs: number);
     /**
      * Build one current attached-Session summary.
      * @param session - attached Session to summarize.
@@ -29,7 +33,7 @@ export declare class ApiSessionList {
     summaryFor(session: Session): SessionSummary;
     /**
      * 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.
      */
     list(signal?: AbortSignal): Promise<SessionSummary[]>;

package/lib/types/list.js

@@ -1,4 +1,6 @@
 /** Cold-safe Session list and search projection. */
+import { performance } from 'node:perf_hooks';
+import { scheduler } from 'node:timers/promises';
 import { SessionQueryError } from '@deepseek-ai/dsh-session-query';
 import { RemoteError } from '@deepseek-ai/dsh-typert-protocol';
 import { z } from 'zod';
@@ -53,9 +55,14 @@ export function truncateUnicodeCodePoints(value, maximum) {
 /** Owns list projection registration, bounded cold summaries, and authorized search. */
 export class ApiSessionList {
     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,
@@ -98,7 +105,7 @@ export class ApiSessionList {
     }
     /**
      * 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) {
@@ -107,18 +114,32 @@ export class ApiSessionList {
         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 !== undefined) {
                 items.push(this.summaryFor(live));
-                continue;
             }
-            if (record.header.cwd === undefined)
-                continue;
-            cold.push(record.header);
+            else if (record.header.cwd !== undefined) {
+                cold.push(record.header);
+            }
+            if (performance.now() >= yieldDeadline) {
+                await scheduler.yield();
+                signal?.throwIfAborted();
+                yieldDeadline = performance.now() + this.workSliceMs;
+            }
         }
-        for (const header of cold)
+        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;
+            }
+        }
+        signal?.throwIfAborted();
         items.sort((left, right) => right.updatedAt - left.updatedAt);
         return items;
     }