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

package/lib/typert.remote-client.js

@@ -2,6 +2,13 @@
 import { z } from 'zod'
 
 const ContentBlockRemoteCodec$schema = z.union([z.object({
+  'type': z.literal("file"),
+  'attachment': z.object({
+  'attachmentId': z.intersection(z.string(), z.unknown()),
+  'name': z.string(),
+  'bytes': z.number(),
+}),
+}), z.object({
   'type': z.literal("text"),
   'text': z.string(),
 }), z.object({
@@ -210,6 +217,7 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0$schema
   'mode': z.union([z.literal("one-shot"), z.literal("continuable")]).readonly(),
 })]).readonly(),
   'maxMessages': z.number().readonly().optional(),
+  'assistantStream': z.literal(true).readonly().optional(),
 })
 const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.union([z.object({
   'type': z.literal("event").readonly(),
@@ -234,13 +242,13 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   'createdAt': z.number().readonly(),
   'cwd': z.string().readonly().optional(),
   'parentSession': z.intersection(z.string(), z.unknown()).readonly().optional(),
-  'seedLength': z.number().readonly().optional(),
+  'isSeeded': z.boolean().readonly(),
   'origin': z.literal("subagent").readonly().optional(),
   'delegationDepth': z.number().readonly().optional(),
   'agentPreset': z.string().readonly().optional(),
 }).readonly(),
   'cursor': z.number().readonly(),
-  'records': z.array(z.union([z.object({
+  'records': z.array(z.object({
   'type': z.literal("event").readonly(),
   'event': z.object({
   'type': z.string().readonly(),
@@ -255,45 +263,7 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   'end': z.number().readonly(),
 })]).readonly().optional(),
 }).readonly(),
-}), z.object({
-  'type': z.literal("chunks").readonly(),
-  'event': z.union([z.object({
-  'type': z.literal("chunkrow/text-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'texts': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-}), z.object({
-  'type': z.literal("chunkrow/reasoning-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'texts': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-}), z.object({
-  'type': z.literal("chunkrow/tool-call-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'id': z.intersection(z.string(), z.unknown()),
-  'name': z.string().optional(),
-  'args': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-})]).readonly(),
-})])).readonly(),
+})).readonly(),
   'hasMore': z.boolean().readonly(),
   'projections': z.object({
   'asOfSeq': z.number().readonly(),
@@ -362,6 +332,46 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
 })]).optional(),
 }), z.record(z.string(), z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3)), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3))])).readonly()).readonly(),
 }).readonly(),
+  'assistantStream': z.object({
+  'revision': z.number().readonly(),
+  'activeAttempt': z.object({
+  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'startedAfterSeq': z.union([z.intersection(z.number(), z.unknown()), z.literal(-1)]).readonly(),
+  'turn': z.number().readonly(),
+  'step': z.number().readonly(),
+  'nextIndex': z.number().readonly(),
+  'stream': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3)), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3))])).readonly(),
+}).readonly().optional(),
+}).readonly().optional(),
+}), z.object({
+  'type': z.literal("assistant-stream").readonly(),
+  'frame': z.union([z.object({
+  'type': z.literal("start").readonly(),
+  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+  'startedAfterSeq': z.union([z.intersection(z.number(), z.unknown()), z.literal(-1)]).readonly(),
+  'turn': z.number().readonly(),
+  'step': z.number().readonly(),
+}), z.object({
+  'type': z.literal("chunk").readonly(),
+  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+  'index': z.number().readonly(),
+  'time': z.number().readonly(),
+  'chunk': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3)), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3))]).readonly(),
+}), z.object({
+  'type': z.literal("end").readonly(),
+  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+  'index': z.number().readonly(),
+  'outcome': z.union([z.object({
+  'kind': z.literal("committed").readonly(),
+  'eventType': z.union([z.literal("assistant/message"), z.literal("assistant/attempt")]).readonly(),
+  'seq': z.number().readonly(),
+}), z.object({
+  'kind': z.literal("abandoned").readonly(),
+})]).readonly(),
+})]).readonly(),
 })])
 const _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema = z.object({
   'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
@@ -502,7 +512,7 @@ const _deepseek_ai_dsh_api_session_controller_session_page_parameter_0$schema =
   'maxMessages': z.number().readonly().optional(),
 })
 const _deepseek_ai_dsh_api_session_controller_session_page_result$schema = z.object({
-  'records': z.array(z.union([z.object({
+  'records': z.array(z.object({
   'type': z.literal("event").readonly(),
   'event': z.object({
   'type': z.string().readonly(),
@@ -517,45 +527,7 @@ const _deepseek_ai_dsh_api_session_controller_session_page_result$schema = z.obj
   'end': z.number().readonly(),
 })]).readonly().optional(),
 }).readonly(),
-}), z.object({
-  'type': z.literal("chunks").readonly(),
-  'event': z.union([z.object({
-  'type': z.literal("chunkrow/text-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'texts': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-}), z.object({
-  'type': z.literal("chunkrow/reasoning-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'texts': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-}), z.object({
-  'type': z.literal("chunkrow/tool-call-chunks").readonly(),
-  'seq': z.number().readonly(),
-  'time': z.number().readonly(),
-  'data': z.object({
-  'id': z.intersection(z.string(), z.unknown()),
-  'name': z.string().optional(),
-  'args': z.array(z.string()),
-  'turn': z.number(),
-  'step': z.number(),
-  'index': z.number(),
-  'dt': z.array(z.number()),
-}).readonly(),
-})]).readonly(),
-})])).readonly(),
+})).readonly(),
   'hasMore': z.boolean().readonly(),
 })
 const _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema = z.object({
@@ -570,6 +542,9 @@ const _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema
   'mediaType': z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")]).readonly(),
   'data': z.string().readonly(),
   'name': z.string().readonly().optional(),
+}), z.object({
+  'type': z.literal("file").readonly(),
+  'receiptId': z.intersection(z.string(), z.unknown()).readonly(),
 })])).readonly(),
   'clientTimeZone': z.string().readonly().optional(),
 })
@@ -613,6 +588,13 @@ const _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$sc
   'action': z.union([z.object({
   'kind': z.literal("edit").readonly(),
   'content': z.array(z.union([z.object({
+  'type': z.literal("file"),
+  'attachment': z.object({
+  'attachmentId': z.intersection(z.string(), z.unknown()),
+  'name': z.string(),
+  'bytes': z.number(),
+}),
+}), z.object({
   'type': z.literal("text"),
   'text': z.string(),
 }), z.object({
@@ -731,7 +713,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":338,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":340,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -756,7 +738,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":358,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":360,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -771,7 +753,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":263,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":265,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -788,7 +770,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":390,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":393,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -813,7 +795,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":235,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":237,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -840,7 +822,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":380,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":383,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -865,7 +847,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":316,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":318,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -891,7 +873,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":214,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":216,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -906,7 +888,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":254,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":256,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -932,7 +914,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":275,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":277,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -958,7 +940,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":369,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":371,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -984,7 +966,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":327,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":329,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1009,7 +991,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":306,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":308,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1035,7 +1017,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":225,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":227,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1060,7 +1042,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":245,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":247,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1085,7 +1067,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":348,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":350,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',

package/lib/types/assistant-stream.d.ts

@@ -0,0 +1,26 @@
+/** Process-local assistant state retained for reconnecting Web followers. */
+import type { AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
+import type { SessionSeqCursor } from '@deepseek-ai/dsh-session';
+import type { SessionAssistantStreamBaseline } from './types.ts';
+/**
+ * Folds dense Agent frames and materializes one shared immutable reconnect
+ * baseline per accepted revision.
+ */
+export declare class SessionAssistantStreamAccumulator {
+    private activeAttempt;
+    private revision;
+    private snapshotValue;
+    private dirty;
+    /**
+     * Fold one trusted frame from the current attached Agent lifecycle.
+     * @param frame - next dense process-local Assistant frame.
+     * @param durableCursor - last committed Session seq when this frame was observed.
+     */
+    accept(frame: AssistantStreamFrame, durableCursor: SessionSeqCursor): void;
+    /**
+     * Read the cached reconnect baseline, materializing it after a state change.
+     * @returns the identity-stable baseline for the latest accepted revision.
+     */
+    snapshot(): SessionAssistantStreamBaseline;
+}
+//# sourceMappingURL=assistant-stream.d.ts.map

package/lib/types/assistant-stream.js

@@ -0,0 +1,83 @@
+/** Process-local assistant state retained for reconnecting Web followers. */
+import { AssistantStreamAccumulator } from '@deepseek-ai/dsh-llm';
+const EMPTY_BASELINE = { revision: 0 };
+/**
+ * Folds dense Agent frames and materializes one shared immutable reconnect
+ * baseline per accepted revision.
+ */
+export class SessionAssistantStreamAccumulator {
+    activeAttempt;
+    revision = 0;
+    snapshotValue = EMPTY_BASELINE;
+    dirty = false;
+    /**
+     * Fold one trusted frame from the current attached Agent lifecycle.
+     * @param frame - next dense process-local Assistant frame.
+     * @param durableCursor - last committed Session seq when this frame was observed.
+     */
+    accept(frame, durableCursor) {
+        if (frame.type === 'start' && frame.revision === 1 && this.revision !== 0) {
+            this.activeAttempt = undefined;
+            this.revision = 0;
+        }
+        if (frame.revision !== this.revision + 1) {
+            this.activeAttempt = undefined;
+            this.revision = frame.revision;
+            this.dirty = true;
+            return;
+        }
+        this.revision = frame.revision;
+        switch (frame.type) {
+            case 'start':
+                this.activeAttempt = {
+                    attemptId: frame.attemptId,
+                    startedAfterSeq: durableCursor,
+                    turn: frame.turn,
+                    step: frame.step,
+                    stream: new AssistantStreamAccumulator(),
+                    nextIndex: 0,
+                };
+                break;
+            case 'chunk': {
+                const attempt = this.activeAttempt;
+                if (attempt === undefined
+                    || attempt.attemptId !== frame.attemptId
+                    || frame.index !== attempt.nextIndex) {
+                    this.activeAttempt = undefined;
+                    break;
+                }
+                attempt.stream.push({ time: frame.time, chunk: frame.chunk });
+                attempt.nextIndex += 1;
+                break;
+            }
+            case 'end':
+                this.activeAttempt = undefined;
+                break;
+        }
+        this.dirty = true;
+    }
+    /**
+     * Read the cached reconnect baseline, materializing it after a state change.
+     * @returns the identity-stable baseline for the latest accepted revision.
+     */
+    snapshot() {
+        if (!this.dirty)
+            return this.snapshotValue;
+        this.snapshotValue = {
+            revision: this.revision,
+            ...this.activeAttempt === undefined ? {} : {
+                activeAttempt: {
+                    attemptId: this.activeAttempt.attemptId,
+                    startedAfterSeq: this.activeAttempt.startedAfterSeq,
+                    turn: this.activeAttempt.turn,
+                    step: this.activeAttempt.step,
+                    nextIndex: this.activeAttempt.nextIndex,
+                    stream: this.activeAttempt.stream.snapshot(),
+                },
+            },
+        };
+        this.dirty = false;
+        return this.snapshotValue;
+    }
+}
+//# sourceMappingURL=assistant-stream.js.map

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

@@ -1,21 +1,42 @@
 /** Observable contiguous Session event window consumed by domain assemblers. */
 import { type ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { LlmAttemptId, StreamChunk } from '@deepseek-ai/dsh-llm';
 import type { SessionEvent } from '@deepseek-ai/dsh-session/types';
-import type { ChunkRowEvent } from '../../types.ts';
-/** Standard Session event or compact historical Assistant run. */
-export type SessionEventLike = SessionEvent | ChunkRowEvent;
+/** Client-only live chunk presentation; `seq` orders the transient row between durable Session seqs. */
+export interface AssistantLiveChunkEvent {
+    readonly type: 'assistant/live-chunk';
+    readonly seq: number;
+    readonly time: number;
+    readonly data: {
+        readonly attemptId: LlmAttemptId;
+        readonly turn: number;
+        readonly step: number;
+        readonly chunk: StreamChunk;
+    };
+}
+/** Current durable Session event or one client-only live chunk presentation. */
+export type SessionEventLike = SessionEvent | AssistantLiveChunkEvent;
 /** Client history entry retaining its coarse transport discriminator. */
 export type SessionEventLikeEntry = {
     readonly type: 'event';
     readonly event: SessionEvent;
 } | {
-    readonly type: 'chunks';
-    readonly event: ChunkRowEvent;
+    readonly type: 'transient';
+    readonly event: AssistantLiveChunkEvent;
 };
 /** Scalar live entry accepted by append-only Client paths. */
 export type SessionLiveEventEntry = Extract<SessionEventLikeEntry, {
     readonly type: 'event';
 }>;
+/** Durable Assistant event that atomically supersedes one attempt's transient rows. */
+export interface SessionAssistantSettlementEntry {
+    readonly type: 'event';
+    readonly event: SessionEvent<'assistant/message'> | SessionEvent<'assistant/attempt'>;
+}
+/** Client-only Assistant frame admitted outside durable cursor algebra. */
+export type SessionTransientEventEntry = Extract<SessionEventLikeEntry, {
+    readonly type: 'transient';
+}>;
 /** Exact delta that produced the latest event-window revision. */
 export type SessionEventChange = {
     readonly kind: 'replace';
@@ -25,7 +46,11 @@ export type SessionEventChange = {
     readonly entries: readonly SessionEventLikeEntry[];
 } | {
     readonly kind: 'append';
-    readonly entries: readonly SessionLiveEventEntry[];
+    readonly entries: readonly SessionEventLikeEntry[];
+} | {
+    readonly kind: 'settle-assistant';
+    readonly attemptId: LlmAttemptId;
+    readonly entry?: SessionAssistantSettlementEntry;
 };
 /** Current contiguous event window and its latest synchronous delta. */
 export interface SessionEventWindow {
@@ -65,7 +90,13 @@ export declare class MutableSessionEventSource implements SessionEventSource {
      * Append one contiguous live entry.
      * @param entry - live tail entry.
      */
-    append(entry: SessionLiveEventEntry): void;
+    append(entry: SessionEventLikeEntry): void;
+    /**
+     * Replace one attempt's transient rows with its committed durable settlement.
+     * @param attemptId - process-local attempt whose live rows are now redundant.
+     * @param entry - durable settlement committed for that attempt.
+     */
+    settleAssistant(attemptId: LlmAttemptId, entry?: SessionAssistantSettlementEntry): void;
     private publish;
 }
 //# sourceMappingURL=events.d.ts.map

package/lib/types/client/contract/events.js

@@ -83,6 +83,27 @@ export class MutableSessionEventSource {
             entries,
         });
     }
+    /**
+     * Replace one attempt's transient rows with its committed durable settlement.
+     * @param attemptId - process-local attempt whose live rows are now redundant.
+     * @param entry - durable settlement committed for that attempt.
+     */
+    settleAssistant(attemptId, entry) {
+        const entries = materialize(this.window).filter(candidate => (candidate.type !== 'transient' || candidate.event.data.attemptId !== attemptId));
+        if (entry !== undefined) {
+            const index = entries.findIndex(candidate => candidate.event.seq > entry.event.seq);
+            if (index < 0)
+                entries.push(entry);
+            else
+                entries.splice(index, 0, entry);
+        }
+        this.window = leaf(entries);
+        this.publish(this.snapshot.hasMore, {
+            kind: 'settle-assistant',
+            attemptId,
+            ...(entry === undefined ? {} : { entry }),
+        });
+    }
     publish(hasMore, change) {
         this.snapshot = windowSnapshot(this.window, hasMore, this.snapshot.revision + 1, change);
         notifySubscribers(this.listeners, '[session-controller] event feed');

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

@@ -7,22 +7,22 @@
  * must stub); implementation-internal entry points (history staging, wire-frame
  * dispatch) stay on the class, invisible out here.
  */
-import type { AttachmentIdType, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { AttachmentIdType, FileAttachmentRef, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { MessageId } from '@deepseek-ai/dsh-llm/brand';
 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';
-import type { PendingSubmissionImage, SessionSnapshot } from './snapshot.ts';
+import type { PendingSubmissionAttachment, SessionSnapshot } from './snapshot.ts';
 /**
  * Why a local submission echo left the snapshot: `observed` when its durable
  * `user/message` event or host queue occurrence arrived (with the admitted
- * image references in prompt order), `failed` when the prompt was rejected,
+ * attachment references in prompt order), `failed` when the prompt was rejected,
  * threw, or was aborted before acceptance.
  */
 export type PendingSubmissionRetirement = {
     readonly reason: 'observed';
-    readonly attachments: readonly ImageAttachmentRef[];
+    readonly attachments: readonly (ImageAttachmentRef | FileAttachmentRef)[];
 } | {
     readonly reason: 'failed';
 };
@@ -32,8 +32,8 @@ export interface BeginSubmissionInput {
     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. */
-    readonly images: readonly PendingSubmissionImage[];
+    /** Ordered image previews and durable file metadata matching the upcoming prompt attachments. */
+    readonly attachments: readonly PendingSubmissionAttachment[];
     /** Settlement callback fired exactly once when the echo retires. */
     readonly onRetire?: (retirement: PendingSubmissionRetirement) => void;
 }
@@ -91,7 +91,7 @@ export interface ISession {
         data: Uint8Array;
     }>>;
     /**
-     * Apply one edit, remove, or strict steer action to a still-pending queue occurrence.
+     * Apply one edit, remove, or Steer action to a still-pending queue occurrence.
      * @param itemId - agent-owned inbox occurrence identity.
      * @param action - requested queue operation.
      * @returns acceptance, or a business/transport error.

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

@@ -1,5 +1,6 @@
 /** Session-owned observable state excluding Conversation target data. */
 import type { ContentBlock } from '@deepseek-ai/dsh-llm/types';
+import type { FileAttachmentRef } 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 { SubagentAddress } from '@deepseek-ai/dsh-subagent/client';
@@ -27,6 +28,18 @@ export interface PendingSubmissionImage {
     /** Intrinsic pixel height, when the submitter has probed it. */
     readonly height?: number;
 }
+/** Image branch of a local submission echo attachment. */
+export interface PendingSubmissionImageAttachment {
+    readonly type: 'image';
+    readonly value: PendingSubmissionImage;
+}
+/** File branch of a local submission echo attachment. */
+export interface PendingSubmissionFileAttachment {
+    readonly type: 'file';
+    readonly value: FileAttachmentRef;
+}
+/** One attachment displayed by a local submission echo, in prompt order. */
+export type PendingSubmissionAttachment = PendingSubmissionImageAttachment | PendingSubmissionFileAttachment;
 /** Client surface selected when a local submission begins. */
 export type PendingSubmissionPlacement = 'transcript' | 'queued' | 'steering';
 /**
@@ -44,8 +57,8 @@ export interface PendingSubmission {
     readonly time: number;
     /** Prompt text exactly as it will be sent (one text block). */
     readonly text: string;
-    /** Ordered image previews matching the prompt's image parts. */
-    readonly images: readonly PendingSubmissionImage[];
+    /** Ordered image previews and durable file metadata matching the prompt attachments. */
+    readonly attachments: readonly PendingSubmissionAttachment[];
 }
 /** History-open lifecycle of a Session event window. */
 export type OpenState = 'cold' | 'loading' | 'open' | 'error';

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

@@ -12,8 +12,8 @@ export type { ProjectionsBaseline, ProjectionValueStore, SessionProjectionMap, U
 export type { BeginSubmissionInput, ISession, PendingSubmissionRetirement, ProjectionsFace, SessionFace, SubmissionHandle, } from './contract/session.ts';
 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, PendingSubmissionPlacement, PromptError, QueuedMessage, SessionSnapshot, } from './contract/snapshot.ts';
+export type { AssistantLiveChunkEvent, SessionAssistantSettlementEntry, SessionEventChange, SessionEventLike, SessionEventLikeEntry, SessionEventSource, SessionEventWindow, SessionLiveEventEntry, SessionTransientEventEntry, } from './contract/events.ts';
+export type { OpenState, PendingSubmission, PendingSubmissionAttachment, PendingSubmissionFileAttachment, PendingSubmissionImage, PendingSubmissionImageAttachment, PendingSubmissionPlacement, PromptError, QueuedMessage, SessionSnapshot, } from './contract/snapshot.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         /** Client Session object layer and Agent scope owner. */