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

package/lib/types/client/contract/sessions.d.ts

@@ -85,11 +85,11 @@ export interface ISessions {
     /**
      * Resolve an already discovered direct-parent address without opening it.
      * @param id - possible addressed child id.
-     * @returns a retained or loaded-catalog address, without retaining a new selection or scope.
+     * @returns a retained, catalog-derived, or unknown-mode listed address, without retaining a new selection or scope.
      */
     subagentAddress(id: SessionId): SubagentAddress | undefined;
     /**
-     * Load all Session projections once per connection; retry an unsuccessful initial read.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      * @returns completion of the current or newly started refresh.
      */
@@ -126,6 +126,8 @@ export interface ISessions {
         atSeq?: number;
         increaseTitle?: boolean;
         onCreated?: (childId: SessionId) => void;
+        /** False refuses source migration; omission preserves the Host default. */
+        allowMigration?: boolean;
     }): Promise<SessionId>;
     /**
      * Borrow an already-retained Agent-scoped Context without extending its lifetime.

package/lib/types/client/sessions/lineage.d.ts

@@ -21,6 +21,8 @@ export interface SessionListEntry {
     parentSessionId?: SessionId;
     /** Coarse durable origin for navigation filtering; not a continuation capability. */
     origin?: 'subagent';
+    /** Format classification supplied by the Host list. */
+    formatStatus?: SessionSummary['formatStatus'];
     cwd?: string;
     /** Current host-computed projection values for list consumers. */
     projectionValues?: Readonly<Partial<SessionProjectionMap>>;

package/lib/types/client/sessions/manager.d.ts

@@ -35,7 +35,7 @@ export interface SessionListSnapshot {
 /** Shared projection values and the lifecycle of their explicit baseline read. */
 export interface SessionProjectionSnapshot {
     readonly values: Readonly<Partial<SessionProjectionMap>>;
-    readonly state: 'idle' | 'loading' | 'ready' | 'error';
+    readonly state: 'idle' | 'loading' | 'ready' | 'migration-required' | 'error';
     readonly error: RemoteFailure | null;
 }
 /** Instance cluster + frame entry + the session list. */
@@ -86,8 +86,9 @@ export declare class SessionManager {
     resolveTarget(target: SessionTarget): SessionId;
     /**
      * Resolve an address for breadcrumb navigation without retaining transport authority.
-     * @param sessionId - possible child id in an already-loaded catalog.
-     * @returns A retained or catalog-derived direct-parent address.
+     * @param sessionId - possible child id in received Session metadata.
+     * @returns A retained address, then a catalog address, then an unknown-mode address
+     *   from a listed subagent header; undefined without that evidence.
      */
     subagentAddress(sessionId: SessionId): SubagentAddress | undefined;
     /**
@@ -130,7 +131,7 @@ export declare class SessionManager {
     /** Resident per-session projection store (create-on-demand; outlives instantiation). */
     private projectionStore;
     /**
-     * Load a complete projection baseline once per connection; retry unsuccessful reads.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      * @returns completion of the current or newly started read.
      */
@@ -171,12 +172,13 @@ export declare class SessionManager {
      * preserve it or lower it after an exact cut before the first `turn/start`;
      * lineage rides parentSessionId. A child published before Workspace
      * attachment fails is also reconciled into the list.
-     * @param opts - source session and the optional exact inclusive boundary seq.
+     * @param opts - source session, optional exact inclusive boundary seq, and permission to start migration.
      * @returns the fork result (the child session id).
      */
     fork(opts: {
         sessionId: SessionId;
         atSeq?: SessionSeq;
+        allowMigration?: boolean;
     }): Promise<RemoteResult<{
         sessionId: SessionId;
     }>>;

package/lib/types/client/sessions/manager.js

@@ -78,8 +78,9 @@ export class SessionManager {
     }
     /**
      * Resolve an address for breadcrumb navigation without retaining transport authority.
-     * @param sessionId - possible child id in an already-loaded catalog.
-     * @returns A retained or catalog-derived direct-parent address.
+     * @param sessionId - possible child id in received Session metadata.
+     * @returns A retained address, then a catalog address, then an unknown-mode address
+     *   from a listed subagent header; undefined without that evidence.
      */
     subagentAddress(sessionId) {
         const retained = this.addresses.get(sessionId);
@@ -88,7 +89,7 @@ export class SessionManager {
         for (const parentSessionId of this.projectionStores.keys()) {
             const child = this.projectionStores.get(parentSessionId)?.values().subagentCatalog
                 ?.find(entry => entry.id === sessionId);
-            if (child !== undefined) {
+            if (child !== undefined && child.mode !== 'external') {
                 return {
                     parentSessionId,
                     childSessionId: sessionId,
@@ -96,7 +97,14 @@ export class SessionManager {
                 };
             }
         }
-        return undefined;
+        const summary = this.summaries.find(summary => summary.sessionId === sessionId);
+        if (summary?.origin !== 'subagent' || summary.parentSessionId === undefined)
+            return undefined;
+        return {
+            parentSessionId: summary.parentSessionId,
+            childSessionId: sessionId,
+            mode: 'unknown',
+        };
     }
     // ---- Instance management ----
     /**
@@ -169,7 +177,7 @@ export class SessionManager {
                 const address = this.addresses.get(sessionId);
                 const child = address === undefined ? undefined : this.projectionStores.get(address.parentSessionId)?.values().subagentCatalog
                     ?.find(entry => entry.id === sessionId);
-                if (child !== undefined) {
+                if (child !== undefined && child.mode !== 'external') {
                     // A catalogued child exists only after its delegated session has
                     // durable history, even though child rows do not carry `blank`.
                     session.handleBlank(false);
@@ -252,7 +260,7 @@ export class SessionManager {
         return store;
     }
     /**
-     * Load a complete projection baseline once per connection; retry unsuccessful reads.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      * @returns completion of the current or newly started read.
      */
@@ -273,14 +281,27 @@ export class SessionManager {
                 if (controller.signal.aborted)
                     return;
                 if (result.ok) {
-                    if (result.value !== null) {
-                        store.seed({ ...result.value, asOfSeq: sessionSeqCursor(result.value.asOfSeq) });
+                    const value = result.value;
+                    if (value !== null) {
+                        switch (value.kind) {
+                            case 'sequenced':
+                                store.seed({ values: value.values, asOfSeq: sessionSeqCursor(value.asOfSeq) });
+                                break;
+                            case 'migration-required':
+                                store.applyCached(value.values);
+                                break;
+                            default:
+                                assertNever(value, 'session projections result');
+                        }
                     }
                     else if (store.values() === initialValues) {
                         // A later frame proves existence independently of an earlier missing read.
                         store.clear();
                     }
-                    this.projectionLoads.set(sessionId, { state: 'ready', error: null });
+                    this.projectionLoads.set(sessionId, {
+                        state: value?.kind === 'migration-required' ? 'migration-required' : 'ready',
+                        error: null,
+                    });
                 }
                 else {
                     this.projectionLoads.set(sessionId, { state: 'error', error: result.error });
@@ -454,7 +475,7 @@ export class SessionManager {
      * preserve it or lower it after an exact cut before the first `turn/start`;
      * lineage rides parentSessionId. A child published before Workspace
      * attachment fails is also reconciled into the list.
-     * @param opts - source session and the optional exact inclusive boundary seq.
+     * @param opts - source session, optional exact inclusive boundary seq, and permission to start migration.
      * @returns the fork result (the child session id).
      */
     async fork(opts) {
@@ -462,6 +483,7 @@ export class SessionManager {
         const result = await this.remote.session.fork({
             sessionId: opts.sessionId,
             ...opts.atSeq === undefined ? {} : { atSeq: opts.atSeq },
+            ...opts.allowMigration === undefined ? {} : { allowMigration: opts.allowMigration },
         });
         const childId = result.ok
             ? result.value.sessionId
@@ -691,6 +713,7 @@ export class SessionManager {
                 && prev.blank === entry.blank
                 && prev.parentSessionId === entry.parentSessionId && prev.cwd === entry.cwd
                 && prev.origin === entry.origin && prev.title === entry.title && prev.depth === entry.depth
+                && prev.formatStatus === entry.formatStatus
                 && prev.projectionValues === entry.projectionValues)
                 return prev;
             this.entryCache.set(entry.sessionId, entry);
@@ -732,6 +755,7 @@ function applyMutation(summaries, mutation) {
                 ...(mutation.kind === 'upsert' ? {
                     agentAvailable: mutation.summary.agentAvailable,
                     running: mutation.summary.running,
+                    ...(mutation.summary.formatStatus === undefined ? {} : { formatStatus: mutation.summary.formatStatus }),
                 } : {}),
                 ...(existing.cwd === undefined && mutation.summary.cwd !== undefined ? { cwd: mutation.summary.cwd } : {}),
                 ...(existing.parentSessionId === undefined && mutation.summary.parentSessionId !== undefined
@@ -741,7 +765,8 @@ function applyMutation(summaries, mutation) {
             };
             if (filled.cwd === existing.cwd && filled.parentSessionId === existing.parentSessionId
                 && filled.origin === existing.origin && filled.blank === existing.blank
-                && filled.agentAvailable === existing.agentAvailable && filled.running === existing.running)
+                && filled.agentAvailable === existing.agentAvailable && filled.running === existing.running
+                && filled.formatStatus === existing.formatStatus)
                 return [...summaries];
             return summaries.map(summary => summary.sessionId === mutation.summary.sessionId ? filled : summary);
         }

package/lib/types/client/sessions/projection-store.d.ts

@@ -6,8 +6,8 @@
  * (`{ value, seq }`) comes from the connected Host — a follow opening
  * baseline, a Session Controller `projection` frame, a list block the Host
  * computed for an attached Session — and merges under **higher seq wins**
- * against other sequenced rows. A `cached` row (`{ value }`) comes from the
- * session list's view of the persisted checkpoint, carries no comparable
+ * against other sequenced rows. A `cached` row (`{ value }`) comes from
+ * a Host view of the persisted checkpoint, carries no comparable
  * seq, and yields to every sequenced write. No client-side domain folding
  * exists: a domain ships projection support with zero client code. Per-key
  * bare observable faces feed `useProjection` (ui-renderer binds them).
@@ -101,7 +101,7 @@ export declare class ProjectionValueStore {
      */
     apply(key: string, value: unknown, seq: SessionSeqCursor): void;
     /**
-     * Fill keys from a session-list block the Host labeled `cached`: a zero-I/O
+     * Fill keys from a Host block labeled `cached`: a zero-I/O
      * view of the persisted checkpoint. A cached value lands only where no
      * sequenced row exists: a connected Session has already answered for such
      * a key, and the list's view of the persisted checkpoint cannot be newer

package/lib/types/client/sessions/projection-store.js

@@ -82,7 +82,7 @@ export class ProjectionValueStore {
         this.changed(key);
     }
     /**
-     * Fill keys from a session-list block the Host labeled `cached`: a zero-I/O
+     * Fill keys from a Host block labeled `cached`: a zero-I/O
      * view of the persisted checkpoint. A cached value lands only where no
      * sequenced row exists: a connected Session has already answered for such
      * a key, and the list's view of the persisted checkpoint cannot be newer

package/lib/types/client/sessions/service.d.ts

@@ -12,6 +12,7 @@ import type { AgentContext, ISessions, SessionReference, SessionRetainInfo, Sess
 import { SessionManager } from './manager.ts';
 import type { SessionRemotes } from './remotes.ts';
 import type { SessionListPhase, SessionSearchResultItem, SessionProjectionSnapshot } from './manager.ts';
+import type { SessionListEntry } from './lineage.ts';
 /** Session list row projected from the host list RPC plus live stream increments. */
 export interface SessionSummary {
     id: SessionId;
@@ -23,6 +24,8 @@ export interface SessionSummary {
     parentId?: SessionId;
     /** Coarse durable origin for navigation filtering; not a continuation capability. */
     origin?: 'subagent';
+    /** Format classification supplied by the Host list, when available. */
+    formatStatus?: SessionListEntry['formatStatus'];
     /** Host running state for `ids` members; a display fallback for other rows. */
     running: boolean;
     /** Local ownership counts; Host metadata refreshes cannot overwrite them. */
@@ -30,7 +33,7 @@ export interface SessionSummary {
     /**
      * New Session presentation and reuse eligibility, derived from the Host
      * summary, `sessionListMetadata`, and client acceptance/running observations.
-     * New Session reuses a blank one targeting the same workspace. Filtering
+     * Workspace reconnection may reuse a blank in the same workspace. Filtering
      * stays with the consumer: the store carries every row, while the Workspace
      * browser shows only the selected blank entry.
      */
@@ -113,11 +116,11 @@ export declare class ClientSessions implements ISessions {
      * Resolve an already discovered direct-parent address without opening it.
      * Feature plugins use this to avoid Agent-bound RPCs in persisted child views.
      * @param id - possible addressed child id.
-     * @returns A retained or loaded-catalog address, without retaining a new selection or scope.
+     * @returns A retained, catalog-derived, or unknown-mode listed address, without retaining a new selection or scope.
      */
     subagentAddress(id: SessionId): SubagentAddress | undefined;
     /**
-     * Load all Session projections once per connection; retry an unsuccessful initial read.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      */
     refreshProjections(sessionId: SessionId): Promise<void>;
@@ -189,7 +192,7 @@ export declare class ClientSessions implements ISessions {
      *   seq (a real event seq the caller already knows; a cut inside an open
      *   turn is balanced Host-side with synthetic closers, and omission selects
      *   the latest completed-turn prefix), and whether to increment an
-     *   inherited durable title before resolving.
+     *   inherited durable title before resolving, plus permission to start source migration.
      * @returns the child session id.
      * @throws {SessionForkError} with the source id.
      * @throws {Error} when a requested child-title rename fails after creation.
@@ -199,6 +202,7 @@ export declare class ClientSessions implements ISessions {
         atSeq?: number;
         increaseTitle?: boolean;
         onCreated?: (childId: SessionId) => void;
+        allowMigration?: boolean;
     }): Promise<SessionId>;
     /**
      * Borrow an already-retained Agent-scoped Context.

package/lib/types/client/sessions/service.js

@@ -234,13 +234,13 @@ export class ClientSessions {
      * Resolve an already discovered direct-parent address without opening it.
      * Feature plugins use this to avoid Agent-bound RPCs in persisted child views.
      * @param id - possible addressed child id.
-     * @returns A retained or loaded-catalog address, without retaining a new selection or scope.
+     * @returns A retained, catalog-derived, or unknown-mode listed address, without retaining a new selection or scope.
      */
     subagentAddress(id) {
         return this.manager.subagentAddress(id);
     }
     /**
-     * Load all Session projections once per connection; retry an unsuccessful initial read.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      */
     refreshProjections(sessionId) {
@@ -331,7 +331,7 @@ export class ClientSessions {
      *   seq (a real event seq the caller already knows; a cut inside an open
      *   turn is balanced Host-side with synthetic closers, and omission selects
      *   the latest completed-turn prefix), and whether to increment an
-     *   inherited durable title before resolving.
+     *   inherited durable title before resolving, plus permission to start source migration.
      * @returns the child session id.
      * @throws {SessionForkError} with the source id.
      * @throws {Error} when a requested child-title rename fails after creation.
@@ -343,6 +343,7 @@ export class ClientSessions {
         const result = await this.manager.fork({
             sessionId: opts.sessionId,
             ...(opts.atSeq === undefined ? {} : { atSeq: SessionSeq(opts.atSeq) }),
+            ...(opts.allowMigration === undefined ? {} : { allowMigration: opts.allowMigration }),
         });
         if (!result.ok)
             throw new SessionForkError(result.error, opts.sessionId);
@@ -502,6 +503,7 @@ export class ClientSessions {
                 retainedBy: this.retentionSnapshot(entry.sessionId).retainedBy,
                 blank: entry.blank,
                 updatedAt: entry.updatedAt,
+                formatStatus: entry.formatStatus,
                 ...(entry.projectionValues === undefined
                     ? {}
                     : { projectionValues: entry.projectionValues }),
@@ -513,6 +515,8 @@ export class ClientSessions {
         }
         for (const [parentId, projection] of Object.entries(projectionsBySession)) {
             for (const child of projection.values.subagentCatalog ?? []) {
+                if (child.mode === 'external')
+                    continue;
                 const childId = child.id;
                 const summary = byId[childId];
                 const projectionValues = summary?.projectionValues ?? this.manager.projectionValues(childId);

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>;
@@ -150,7 +156,7 @@ export declare class SessionController extends TypertRemoteService {
      * Fork one cold-readable exact event prefix into a new Session. An omitted
      * boundary selects the latest completed-turn prefix; an open cut receives
      * synthetic fork closers.
-     * @param request - source Session and optional exact inclusive event boundary.
+     * @param request - source Session, optional exact inclusive event boundary, and migration preflight choice.
      * @returns the new Session identity.
      */
     fork(request: SessionForkRequest): Promise<SessionForkValue>;
@@ -195,12 +201,13 @@ export declare class SessionController extends TypertRemoteService {
      */
     follow(request: SessionFollowRequest, signal: AbortSignal): AsyncIterable<SessionFollowFrame>;
     /**
-     * Read all registered projections without activating an Agent.
+     * Read exact projections, returning cached hints only when migration is required.
      * @param request - Session whose current values are required.
-     * @param signal - cancellation for the Session observation.
-     * @returns complete baseline, or null when the Session does not exist.
+     * @param signal - cancellation for the Session read.
+     * @returns a sequenced baseline, cached hints when migration is deferred, or null when absent.
      */
     projections(request: SessionProjectionsRequest, signal: AbortSignal): Promise<SessionProjectionsValue>;
+    private liveProjections;
     /**
      * Stream a complete live-control baseline followed by replacement frames.
      * @param signal - cancellation owned by the Remote stream carrier.

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) {
@@ -461,10 +463,18 @@ let SessionController = (() => {
          * Fork one cold-readable exact event prefix into a new Session. An omitted
          * boundary selects the latest completed-turn prefix; an open cut receives
          * synthetic fork closers.
-         * @param request - source Session and optional exact inclusive event boundary.
+         * @param request - source Session, optional exact inclusive event boundary, and migration preflight choice.
          * @returns the new Session identity.
          */
-        fork(request) {
+        async fork(request) {
+            if (request.allowMigration === false && this.ctx.sessions.get(request.sessionId) === undefined) {
+                const stored = await this.ctx.get('sessionPersistence')?.stat(request.sessionId);
+                if (stored?.formatStatus === 'migration-required' && this.ctx.sessions.get(request.sessionId) === undefined) {
+                    throw new RemoteError('session/migration-required', 'Open the source Session to complete migration before forking', {
+                        sessionId: request.sessionId,
+                    });
+                }
+            }
             return this.commands.fork(request);
         }
         /**
@@ -521,10 +531,10 @@ let SessionController = (() => {
             return this.history.follow(request, signal);
         }
         /**
-         * Read all registered projections without activating an Agent.
+         * Read exact projections, returning cached hints only when migration is required.
          * @param request - Session whose current values are required.
-         * @param signal - cancellation for the Session observation.
-         * @returns complete baseline, or null when the Session does not exist.
+         * @param signal - cancellation for the Session read.
+         * @returns a sequenced baseline, cached hints when migration is deferred, or null when absent.
          */
         async projections(request, signal) {
             const { sessionId } = request;
@@ -534,12 +544,27 @@ let SessionController = (() => {
             try {
                 const env_2 = { stack: [], error: void 0, hasError: false };
                 try {
+                    signal.throwIfAborted();
+                    const live = this.liveProjections(sessionId);
+                    if (live !== undefined)
+                        return live;
+                    const stored = await this.ctx.get('sessionPersistence')?.stat(sessionId, { signal });
+                    signal.throwIfAborted();
+                    const attached = this.liveProjections(sessionId);
+                    if (attached !== undefined)
+                        return attached;
+                    if (stored === undefined)
+                        return null;
+                    if (stored.formatStatus === 'migration-required') {
+                        const cached = this.ctx.get('sessionProjectionCache')?.cachedSnapshot(stored.header);
+                        return { kind: 'migration-required', values: { ...cached?.values } };
+                    }
                     const observation = __addDisposableResource(env_2, await this.ctx.sessionQuery.observeSession(sessionId, { signal }), false);
                     const projections = observation.projections;
                     if (projections === undefined) {
                         throw new RemoteError('session/projections-unavailable', 'Session projections are unavailable', {});
                     }
-                    return { asOfSeq: projections.asOfSeq, values: projections.values };
+                    return { kind: 'sequenced', asOfSeq: projections.asOfSeq, values: projections.values };
                 }
                 catch (e_2) {
                     env_2.error = e_2;
@@ -550,10 +575,10 @@ let SessionController = (() => {
                 }
             }
             catch (error) {
-                if (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_SESSION_NOT_FOUND')
-                    return null;
-                if (signal.aborted
-                    || (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_ABORTED')) {
+                if (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_SESSION_NOT_FOUND') {
+                    return this.liveProjections(sessionId) ?? null;
+                }
+                if (signal.aborted || (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_ABORTED')) {
                     throw new RemoteError('gateway/cancelled', 'Session projection read was cancelled', {}, { cause: error });
                 }
                 if (error instanceof RemoteError)
@@ -561,6 +586,13 @@ let SessionController = (() => {
                 throw new RemoteError('gateway/internal', 'Session projection read failed', {}, { cause: error });
             }
         }
+        liveProjections(sessionId) {
+            const session = this.ctx.sessions.get(sessionId);
+            if (session === undefined)
+                return undefined;
+            const snapshot = this.ctx.sessionProjections.snapshot(session);
+            return { kind: 'sequenced', asOfSeq: snapshot.asOfSeq, values: snapshot.values };
+        }
         /**
          * Stream a complete live-control baseline followed by replacement frames.
          * @param signal - cancellation owned by the Remote stream carrier.

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[]>;