@deepseek-ai/dsh-api-session-controller 0.1.2-alpha.2 → 0.1.2-alpha.4

package/lib/typert.remote-client.js

@@ -132,11 +132,11 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = z.
   'subagent': z.union([z.literal(null), z.object({
   'mode': z.literal("one-shot"),
   'label': z.string().optional(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 }), z.object({
   'mode': z.literal("continuable"),
   'label': z.string(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
@@ -221,9 +221,9 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   'ignorable': z.literal(true).readonly().optional(),
   'sourceEventSeqs': z.array(z.number()).readonly().optional(),
   'surfaceOp': z.union([z.literal("append"), z.object({
-  'op': z.literal("replace"),
-  'start': z.number(),
-  'end': z.number(),
+  'op': z.literal("replace").readonly(),
+  'start': z.number().readonly(),
+  'end': z.number().readonly(),
 })]).readonly().optional(),
 }).readonly(),
 }), z.object({
@@ -250,9 +250,9 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   'ignorable': z.literal(true).readonly().optional(),
   'sourceEventSeqs': z.array(z.number()).readonly().optional(),
   'surfaceOp': z.union([z.literal("append"), z.object({
-  'op': z.literal("replace"),
-  'start': z.number(),
-  'end': z.number(),
+  'op': z.literal("replace").readonly(),
+  'start': z.number().readonly(),
+  'end': z.number().readonly(),
 })]).readonly().optional(),
 }).readonly(),
 }), z.object({
@@ -338,11 +338,11 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   'subagent': z.union([z.literal(null), z.object({
   'mode': z.literal("one-shot"),
   'label': z.string().optional(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 }), z.object({
   'mode': z.literal("continuable"),
   'label': z.string(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
@@ -425,11 +425,11 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = z.obj
   'subagent': z.union([z.literal(null), z.object({
   'mode': z.literal("one-shot"),
   'label': z.string().optional(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 }), z.object({
   'mode': z.literal("continuable"),
   'label': z.string(),
-  'seq': z.number(),
+  'seq': z.intersection(z.number(), z.unknown()),
 })]).optional(),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
@@ -512,9 +512,9 @@ const _deepseek_ai_dsh_api_session_controller_session_page_result$schema = z.obj
   'ignorable': z.literal(true).readonly().optional(),
   'sourceEventSeqs': z.array(z.number()).readonly().optional(),
   'surfaceOp': z.union([z.literal("append"), z.object({
-  'op': z.literal("replace"),
-  'start': z.number(),
-  'end': z.number(),
+  'op': z.literal("replace").readonly(),
+  'start': z.number().readonly(),
+  'end': z.number().readonly(),
 })]).readonly().optional(),
 }).readonly(),
 }), z.object({
@@ -731,7 +731,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":333,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":338,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -756,7 +756,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":353,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":358,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -771,7 +771,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath:result',
         schema: _deepseek_ai_dsh_api_session_controller_session_canOpenWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":258,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":263,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -788,7 +788,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionControlFrame',
         schema: _deepseek_ai_dsh_api_session_controller_session_control_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":385,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":390,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -813,7 +813,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_create_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":230,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":235,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -840,7 +840,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowFrame',
         schema: _deepseek_ai_dsh_api_session_controller_session_follow_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":375,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":380,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -865,7 +865,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_fork_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":311,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":316,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -891,7 +891,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_list_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":209,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":214,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -906,7 +906,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#ModelCatalog',
         schema: _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":249,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":254,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -932,7 +932,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":270,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":275,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -958,7 +958,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPage',
         schema: _deepseek_ai_dsh_api_session_controller_session_page_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":364,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":369,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -984,7 +984,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":322,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":327,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1009,7 +1009,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_rename_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":301,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":306,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1035,7 +1035,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_search_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":220,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":225,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1060,7 +1060,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_selectModel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":240,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":245,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1085,7 +1085,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueValue',
         schema: _deepseek_ai_dsh_api_session_controller_session_updateQueue_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":343,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":348,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',

package/lib/types/agent.d.ts

@@ -1,7 +1,8 @@
 /** Agent activation, composition, and model-selection policy owned by API Session. */
 import type { Context } from '@deepseek-ai/cordis';
 import type { Agent, AgentSetup, ModelSelection as AgentModelSelection, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
-import type { Session, SessionEvent, SessionHeader, SessionId } from '@deepseek-ai/dsh-session';
+import type { Session, SessionId } from '@deepseek-ai/dsh-session';
+import type { SessionInspection } from '@deepseek-ai/dsh-session-persistence';
 import { type SessionObservation } from '@deepseek-ai/dsh-session-query';
 import { RemoteError } from '@deepseek-ai/dsh-typert-protocol';
 /** Cold Session identity absent from persistence. */
@@ -60,10 +61,7 @@ export declare function apiSessionSubagentOwnershipError(sessionId: SessionId):
  * @param signal - optional cancellation for persistence reads.
  * @returns the persisted header and complete event prefix.
  */
-export declare function inspectApiSession(ctx: Context, sessionId: SessionId, signal?: AbortSignal): Promise<{
-    meta: SessionHeader;
-    events: SessionEvent[];
-}>;
+export declare function inspectApiSession(ctx: Context, sessionId: SessionId, signal?: AbortSignal): Promise<SessionInspection>;
 /** Owns every operation that may create, resume, or configure a Web Agent. */
 export declare class ApiSessionAgentController {
     private readonly ctx;

package/lib/types/agent.js

@@ -138,7 +138,11 @@ export async function inspectApiSession(ctx, sessionId, signal) {
             if (observation.header.cwd === undefined) {
                 throw new ApiSessionNotFound(`session "${sessionId}" not found`);
             }
-            return { meta: observation.header, events: [...observation.events] };
+            return {
+                meta: observation.header,
+                inheritedEventCount: observation.inheritedEventCount,
+                events: [...observation.events],
+            };
         }
         catch (e_1) {
             env_1.error = e_1;

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

@@ -9,7 +9,7 @@
  */
 import type { AttachmentIdType, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { MessageId } from '@deepseek-ai/dsh-llm/brand';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SessionId, SessionSeq } from '@deepseek-ai/dsh-session/types';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
 import type { PromptContentPart, QueueAction, SessionRequestId } from '../../types.ts';
@@ -28,6 +28,8 @@ export type PendingSubmissionRetirement = {
 };
 /** Input registering one local submission echo ahead of its prompt call. */
 export interface BeginSubmissionInput {
+    /** Delivery mode used with the upcoming prompt. */
+    readonly mode: 'queue' | 'steer';
     /** Prompt text exactly as the upcoming prompt will send it. */
     readonly text: string;
     /** Ordered image previews matching the upcoming prompt's image parts. */
@@ -113,13 +115,22 @@ export interface ISession {
      */
     rename(title: string): Promise<RemoteResult<{
         title: string;
-        seq: number;
+        seq: SessionSeq;
     }>>;
     /**
      * Extend the history window backwards (older messages pagination).
      * @returns completion; failures land in snapshot.openState/loadingOlder.
      */
     loadOlder(): Promise<void>;
+    /**
+     * Page history backwards until the window covers `seq` (inclusive) — the
+     * turn-jump loader. Repeated calls while a jump is paging lower its shared
+     * target and return the in-flight completion; `snapshot.loadingOlder` is
+     * the busy signal for the whole jump.
+     * @param seq - durable event seq the window must reach (a turn's `turn/start` seq).
+     * @returns completion once covered, exhausted, superseded, or failed soft.
+     */
+    loadThrough(seq: SessionSeq): Promise<void>;
     /**
      * Execute one slash-command line against this session's agent — pure
      * admission semantics (the host executor durably logs the lifecycle).

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

@@ -27,6 +27,8 @@ export interface PendingSubmissionImage {
     /** Intrinsic pixel height, when the submitter has probed it. */
     readonly height?: number;
 }
+/** Client surface selected when a local submission begins. */
+export type PendingSubmissionPlacement = 'transcript' | 'queued' | 'steering';
 /**
  * One local prompt-submission echo: inserted synchronously when a submission
  * begins, so the conversation can show the message before serialization,
@@ -36,6 +38,8 @@ export interface PendingSubmissionImage {
 export interface PendingSubmission {
     /** The prompt RPC identity; the durable `user/message` source echoes it as `rpcId`. */
     readonly requestId: SessionRequestId;
+    /** Expected surface until the Host reports the admitted queue or durable occurrence. */
+    readonly placement: PendingSubmissionPlacement;
     /** Client wall-clock ms when the submission began. */
     readonly time: number;
     /** Prompt text exactly as it will be sent (one text block). */

package/lib/types/client/index.d.ts

@@ -13,7 +13,7 @@ export type { BeginSubmissionInput, ISession, PendingSubmissionRetirement, Proje
 export type { ISessions } from './contract/sessions.ts';
 export { MutableSessionEventSource } from './contract/events.ts';
 export type { SessionEventChange, SessionEventLike, SessionEventLikeEntry, SessionEventSource, SessionEventWindow, SessionLiveEventEntry, } from './contract/events.ts';
-export type { OpenState, PendingSubmission, PendingSubmissionImage, PromptError, QueuedMessage, SessionSnapshot, } from './contract/snapshot.ts';
+export type { OpenState, PendingSubmission, PendingSubmissionImage, PendingSubmissionPlacement, PromptError, QueuedMessage, SessionSnapshot, } from './contract/snapshot.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         /** Client Session object layer and Agent scope owner. */

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

@@ -1,5 +1,5 @@
 import type { SubagentAddress, SubagentCatalog } from '@deepseek-ai/dsh-subagent/client';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { SessionSeq, type SessionId } from '@deepseek-ai/dsh-session/types';
 import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
 import type { SessionControlFrame, SessionSummary, SessionJob as JobView } from '../../types.ts';
 import type { RemoteFailure, RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
@@ -193,7 +193,7 @@ export declare class SessionManager {
      */
     fork(opts: {
         sessionId: SessionId;
-        atSeq?: number;
+        atSeq?: SessionSeq;
     }): Promise<RemoteResult<{
         sessionId: SessionId;
     }>>;

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

@@ -1,12 +1,16 @@
 // SessionManager: the instance cluster Map<SessionId, Session> (lazy-built, resident) + the frame
 // dispatch entry + list state, constructed and held by ClientSessions (one per browser client).
 // List data never enters zustand; React connects via subscribe/getListSnapshot.
+import { SessionSeq } from '@deepseek-ai/dsh-session/types';
 import { mergeOrderedBaseline } from "../ordered-baseline.js";
 import { isRemoteFailure } from '@deepseek-ai/dsh-api-gateway/client';
 import { flattenLineage } from "./lineage.js";
 import { Notifier } from "./notifier.js";
 import { ProjectionValueStore } from "./projection-store.js";
 import { Session } from "./session.js";
+function sessionSeqCursor(value) {
+    return value === -1 ? -1 : SessionSeq(value);
+}
 function catalogAvailability(parentAvailable) {
     return parentAvailable === undefined ? {} : { parentAvailable };
 }
@@ -404,7 +408,7 @@ export class SessionManager {
                         const store = this.projectionStore(s.sessionId);
                         const values = block.values;
                         for (const key of Object.keys(values))
-                            store.apply(key, values[key], block.asOfSeq);
+                            store.apply(key, values[key], sessionSeqCursor(block.asOfSeq));
                     }
                 }
                 else {
@@ -552,7 +556,7 @@ export class SessionManager {
             return;
         }
         if (frame.type === 'projection') {
-            this.projectionStore(frame.sessionId).apply(frame.key, frame.value, frame.seq);
+            this.projectionStore(frame.sessionId).apply(frame.key, frame.value, SessionSeq(frame.seq));
             this.notifier.markDirty();
             return;
         }
@@ -579,8 +583,9 @@ export class SessionManager {
         }
         for (const [sessionId, block] of Object.entries(baseline.projections)) {
             const store = this.projectionStore(sessionId);
-            store.truncate(block.asOfSeq);
-            store.seed(block);
+            const asOfSeq = sessionSeqCursor(block.asOfSeq);
+            store.truncate(asOfSeq);
+            store.seed({ ...block, asOfSeq });
         }
         for (const [sessionId, session] of this.sessions) {
             session.replaceControl(this.queues.get(sessionId) ?? []);
@@ -598,7 +603,7 @@ export class SessionManager {
         if (projections !== undefined) {
             const store = this.projectionStore(summary.sessionId);
             for (const [key, value] of Object.entries(projections.values)) {
-                store.apply(key, value, projections.asOfSeq);
+                store.apply(key, value, sessionSeqCursor(projections.asOfSeq));
             }
         }
         if (summary.origin === 'subagent' && summary.parentSessionId !== undefined) {

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

@@ -9,6 +9,7 @@
  * bare observable faces feed `useProjection` (ui-renderer binds them).
  */
 import type { SessionProjectionMap } from '@deepseek-ai/dsh-session-projection/types';
+import type { SessionSeqCursor } from '@deepseek-ai/dsh-session/types';
 import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
 export type { SessionProjectionMap } from '@deepseek-ai/dsh-session-projection/types';
 /**
@@ -31,7 +32,7 @@ export type UseProjection = {
  */
 export interface ProjectionsBaseline {
     /** The consistent-cut seq (equals the window tail seq by construction). */
-    asOfSeq: number;
+    asOfSeq: SessionSeqCursor;
     /** Whole current values by key; a registered key absent here means the capability is absent. */
     values: Readonly<Record<string, unknown>>;
 }
@@ -84,7 +85,7 @@ export declare class ProjectionValueStore {
      * @param value - whole value computed by the host unit.
      * @param seq - the unit's watermark at emission.
      */
-    apply(key: string, value: unknown, seq: number): void;
+    apply(key: string, value: unknown, seq: SessionSeqCursor): void;
     /**
      * Seed from a history tail page's projections block: every carried key
      * lands under the same seq rule as frames; a key the block omits is
@@ -101,7 +102,7 @@ export declare class ProjectionValueStore {
      * baseline immediately afterward.
      * @param lastSeq - highest durable sequence reflected by the baseline.
      */
-    truncate(lastSeq: number): void;
+    truncate(lastSeq: SessionSeqCursor): void;
     private changed;
     private channel;
 }

package/lib/types/client/sessions/queue-mirror.js

@@ -1,6 +1,9 @@
 const QUEUE_PREVIEW_CHARS = 200;
+// Image blocks are excluded: queue presentation renders them as thumbnails
+// from `content`, so the text preview covers only what has no visual form.
 function previewOf(content) {
     const flat = content
+        .filter(block => block.type !== 'image')
         .map(block => (block.type === 'text' ? block.text : `[${block.type}]`))
         .join(' ').replace(/\s+/g, ' ').trim();
     const chars = Array.from(flat);

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

@@ -16,7 +16,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { SubagentAddress } from '@deepseek-ai/dsh-subagent/client';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type SessionId } from '@deepseek-ai/dsh-session/types';
 import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
 import type { SessionJob as JobView } from '../../types.ts';
 import type { SessionProjectionMap } from '@deepseek-ai/dsh-session-projection/types';

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

@@ -1,3 +1,4 @@
+import { SessionSeq } from '@deepseek-ai/dsh-session/types';
 import { workspaceTitleOf } from '@deepseek-ai/dsh-util-workspace-path';
 import { SESSION_SEARCH_RESULT_LIMIT } from "../../types.js";
 import { createSnapshotStore, } from '@deepseek-ai/dsh-client-store';
@@ -297,7 +298,7 @@ export class ClientSessions {
             // Flooring lands inside the anchor's own turn (every turn opens with a
             // turn/start), so the host's first-turn/end-at-or-after cut still ends
             // on that turn — never clipped back to the previous one.
-            ...(opts.atSeq === undefined ? {} : { atSeq: Math.floor(opts.atSeq) }),
+            ...(opts.atSeq === undefined ? {} : { atSeq: SessionSeq(Math.floor(opts.atSeq)) }),
         });
         if (!result.ok)
             throw new SessionForkError(result.error, opts.sessionId);

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

@@ -2,7 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { AttachmentIdType, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { SubagentAddress } from '@deepseek-ai/dsh-subagent/client';
 import type { MessageId } from '@deepseek-ai/dsh-llm/brand';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { SessionSeq, type SessionId } from '@deepseek-ai/dsh-session/types';
 import type { PromptContentPart, QueueAction, SessionControlFrame, SessionQueuedItem, SessionRequestId } from '../../types.ts';
 import type { BeginSubmissionInput, SessionFace, SubmissionHandle } from '../contract/session.ts';
 import type { SessionSnapshot } from '../contract/snapshot.ts';
@@ -12,6 +12,8 @@ import type { SessionRemotes } from './remotes.ts';
 import { ProjectionValueStore } from './projection-store.ts';
 /** Messages requested per history page. */
 export declare const PAGE_MESSAGES = 50;
+/** Messages requested per page while a turn jump loops backwards (fewer, larger round trips). */
+export declare const JUMP_PAGE_MESSAGES = 200;
 /** Manager-owned observers of a Session object's local state edges. */
 export interface SessionOptions {
     /** Catalog-discovered address selecting non-activating subagent transport. */
@@ -53,6 +55,10 @@ export declare class Session implements SessionFace {
      *  passes drop all writes once the generation moves on. */
     private openGeneration;
     private loadingOlder;
+    /** Shared low-water target of the running jump loop; null when no jump is paging. */
+    private jumpTargetSeq;
+    /** The running jump loop's completion, shared by retargeting callers. */
+    private jumpPromise;
     /** Authoritative stream-only inbox snapshot; pending work never hits history. */
     private readonly queueMirror;
     private running;
@@ -173,7 +179,7 @@ export declare class Session implements SessionFace {
      */
     rename(title: string): Promise<RemoteResult<{
         title: string;
-        seq: number;
+        seq: SessionSeq;
     }>>;
     /**
      * Execute one slash-command line against this session's agent — pure
@@ -189,6 +195,8 @@ export declare class Session implements SessionFace {
     open(): Promise<void>;
     /** Page up: pull one earlier page with the window's first seq as beforeSeq and prepend. */
     loadOlder(): Promise<void>;
+    /** Jump loader: page backwards until the window covers seq (see ISession.loadThrough). */
+    loadThrough(seq: SessionSeq): Promise<void>;
     /** Rebuild an opened history source after address replacement.
      *  Invalidates any in-flight open first; queue state belongs to the independently
      *  reconnecting control stream and remains untouched. */