@deepseek-ai/dsh-api-terminal-controller 0.1.6-alpha.1 → 0.1.7-alpha.1

package/lib/typert.remote-client.d.ts

@@ -1,9 +1,10 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import type {
   RemoteResult,
+  RemoteStreamHandle,
   TypertRemoteContribution,
 } from '@deepseek-ai/dsh-typert-protocol'
-import type { TerminalAttachmentId, TerminalCreateRequest, TerminalEnvironment, TerminalFrame, TerminalShell, WebTerminalId, WebTerminalInfo } from '@deepseek-ai/dsh-api-terminal-controller/types'
+import type { TerminalAttachmentId, TerminalCreateRequest, TerminalEnvironment, TerminalFrame, TerminalRetentionFrame, TerminalShell, WebTerminalId, WebTerminalInfo } from '@deepseek-ai/dsh-api-terminal-controller/types'
 import type { SessionId } from '@deepseek-ai/dsh-session/types'
 
 declare module '@deepseek-ai/dsh-typert-protocol' {
@@ -11,10 +12,11 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     close: (agentId: SessionId, id: WebTerminalId) => Promise<RemoteResult<void>>
     create: (agentId: SessionId, request: TerminalCreateRequest, signal?: AbortSignal) => Promise<RemoteResult<WebTerminalInfo>>
     environment: (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<TerminalEnvironment>>
-    follow: (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => AsyncIterable<TerminalFrame>
+    follow: (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => RemoteStreamHandle<TerminalFrame, never>
     list: (sessionId: SessionId) => Promise<RemoteResult<WebTerminalInfo[]>>
     rename: (agentId: SessionId, id: WebTerminalId, title: string) => Promise<RemoteResult<void>>
     resize: (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, cols: number, rows: number) => Promise<RemoteResult<void>>
+    retain: (sessionId: SessionId, id: WebTerminalId, signal?: AbortSignal) => RemoteStreamHandle<TerminalRetentionFrame, never>
     shells: (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<TerminalShell[]>>
     write: (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, data: string) => Promise<RemoteResult<void>>
   }
@@ -22,10 +24,11 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     'terminal/close': (agentId: SessionId, id: WebTerminalId) => Promise<RemoteResult<void>>
     'terminal/create': (agentId: SessionId, request: TerminalCreateRequest, signal?: AbortSignal) => Promise<RemoteResult<WebTerminalInfo>>
     'terminal/environment': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<TerminalEnvironment>>
-    'terminal/follow': (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => AsyncIterable<TerminalFrame>
+    'terminal/follow': (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => RemoteStreamHandle<TerminalFrame, never>
     'terminal/list': (sessionId: SessionId) => Promise<RemoteResult<WebTerminalInfo[]>>
     'terminal/rename': (agentId: SessionId, id: WebTerminalId, title: string) => Promise<RemoteResult<void>>
     'terminal/resize': (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, cols: number, rows: number) => Promise<RemoteResult<void>>
+    'terminal/retain': (sessionId: SessionId, id: WebTerminalId, signal?: AbortSignal) => RemoteStreamHandle<TerminalRetentionFrame, never>
     'terminal/shells': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<TerminalShell[]>>
     'terminal/write': (agentId: SessionId, id: WebTerminalId, attachmentId: TerminalAttachmentId, data: string) => Promise<RemoteResult<void>>
   }
@@ -36,7 +39,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     'agent:terminal/close': (id: WebTerminalId) => Promise<RemoteResult<void>>
     'agent:terminal/create': (request: TerminalCreateRequest, signal?: AbortSignal) => Promise<RemoteResult<WebTerminalInfo>>
     'agent:terminal/environment': (signal?: AbortSignal) => Promise<RemoteResult<TerminalEnvironment>>
-    'agent:terminal/follow': (id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => AsyncIterable<TerminalFrame>
+    'agent:terminal/follow': (id: WebTerminalId, attachmentId: TerminalAttachmentId, signal?: AbortSignal) => RemoteStreamHandle<TerminalFrame, never>
     'agent:terminal/rename': (id: WebTerminalId, title: string) => Promise<RemoteResult<void>>
     'agent:terminal/resize': (id: WebTerminalId, attachmentId: TerminalAttachmentId, cols: number, rows: number) => Promise<RemoteResult<void>>
     'agent:terminal/shells': (signal?: AbortSignal) => Promise<RemoteResult<TerminalShell[]>>

package/lib/typert.remote-client.js

@@ -1,17 +1,23 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema = z.void()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema = z.object({
+let _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema$value ??= z.void())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema$value ??= z.object({
   'shellPath': z.string().readonly().optional(),
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'cols': z.number().readonly(),
   'rows': z.number().readonly(),
-})
-const _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema = z.object({
+}))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema$value ??= z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'title': z.string().readonly(),
   'shell': z.object({
@@ -22,23 +28,29 @@ const _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema = z
   'cwd': z.string().readonly(),
   'cols': z.number().readonly(),
   'rows': z.number().readonly(),
-  'state': z.union([z.literal("running"), z.literal("failed"), z.literal("exited")]).readonly(),
+  'state': z.union([z.literal("failed"), z.literal("running"), z.literal("exited")]).readonly(),
   'exitCode': z.union([z.literal(null), z.number()]).readonly(),
   'error': z.string().readonly().optional(),
   'controllerId': z.intersection(z.string(), z.unknown()).readonly().optional(),
-})
-const _deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema = z.object({
+}))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema$value ??= z.object({
   'cwd': z.string().readonly(),
   'maxInputBytes': z.number().readonly(),
   'maxCols': z.number().readonly(),
   'maxRows': z.number().readonly(),
   'scrollback': z.number().readonly(),
-})
-const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema = z.union([z.object({
+}))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema$value ??= z.union([z.object({
   'type': z.literal("snapshot").readonly(),
   'sequence': z.number().readonly(),
   'screen': z.string().readonly(),
@@ -53,7 +65,7 @@ const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema = z
   'cwd': z.string().readonly(),
   'cols': z.number().readonly(),
   'rows': z.number().readonly(),
-  'state': z.union([z.literal("running"), z.literal("failed"), z.literal("exited")]).readonly(),
+  'state': z.union([z.literal("failed"), z.literal("running"), z.literal("exited")]).readonly(),
   'exitCode': z.union([z.literal(null), z.number()]).readonly(),
   'error': z.string().readonly().optional(),
   'controllerId': z.intersection(z.string(), z.unknown()).readonly().optional(),
@@ -75,14 +87,16 @@ const _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema = z
   'cwd': z.string().readonly(),
   'cols': z.number().readonly(),
   'rows': z.number().readonly(),
-  'state': z.union([z.literal("running"), z.literal("failed"), z.literal("exited")]).readonly(),
+  'state': z.union([z.literal("failed"), z.literal("running"), z.literal("exited")]).readonly(),
   'exitCode': z.union([z.literal(null), z.number()]).readonly(),
   'error': z.string().readonly().optional(),
   'controllerId': z.intersection(z.string(), z.unknown()).readonly().optional(),
 }).readonly(),
-})])
-const _deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema = z.array(z.object({
+})]))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema$value ??= z.array(z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'title': z.string().readonly(),
   'shell': z.object({
@@ -93,32 +107,57 @@ const _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema = z.a
   'cwd': z.string().readonly(),
   'cols': z.number().readonly(),
   'rows': z.number().readonly(),
-  'state': z.union([z.literal("running"), z.literal("failed"), z.literal("exited")]).readonly(),
+  'state': z.union([z.literal("failed"), z.literal("running"), z.literal("exited")]).readonly(),
   'exitCode': z.union([z.literal(null), z.number()]).readonly(),
   'error': z.string().readonly().optional(),
   'controllerId': z.intersection(z.string(), z.unknown()).readonly().optional(),
+})))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema$value ??= z.string())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema$value ??= z.void())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema$value ??= z.number())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema$value ??= z.number())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema$value ??= z.void())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_retain_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_retain_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_retain_result$schema$value ??= z.object({
+  'type': z.literal("retained").readonly(),
 }))
-const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema = z.string()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema = z.void()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema = z.number()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema = z.number()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema = z.void()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema = z.array(z.object({
+let _deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema$value ??= z.array(z.object({
   'path': z.string().readonly(),
   'args': z.array(z.string()).readonly(),
   'name': z.string().readonly(),
-}))
-const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema = z.string()
-const _deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema = z.void()
+})))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema$value ??= z.string())
+let _deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema$value
+const _deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema = () => (_deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema$value ??= z.void())
 
 export const TYPERT_REMOTE = {
   package: '@deepseek-ai/dsh-api-terminal-controller',
@@ -142,7 +181,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_0$schema,
           },
         },
         {
@@ -152,16 +191,16 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_close_parameter_1$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/close:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_close_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":247,"column":9},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":269,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/create',
@@ -182,7 +221,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_0$schema,
           },
         },
         {
@@ -192,7 +231,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalCreateRequest',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_create_parameter_1$schema,
           },
         },
       ],
@@ -200,9 +239,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalInfo',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_create_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":155,"column":9},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":158,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/environment',
@@ -223,7 +262,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_environment_parameter_0$schema,
           },
         },
       ],
@@ -231,9 +270,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalEnvironment',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_environment_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":115,"column":3},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":118,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/follow',
@@ -255,7 +294,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_0$schema,
           },
         },
         {
@@ -265,7 +304,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_1$schema,
           },
         },
         {
@@ -275,7 +314,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalAttachmentId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_parameter_2$schema,
           },
         },
       ],
@@ -283,9 +322,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalFrame',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_follow_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":194,"column":3},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":216,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/list',
@@ -301,16 +340,16 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_list_parameter_0$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/list:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_list_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":141,"column":3},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":144,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/rename',
@@ -331,7 +370,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_0$schema,
           },
         },
         {
@@ -341,7 +380,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_1$schema,
           },
         },
         {
@@ -351,16 +390,16 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/rename:title',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_parameter_2$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/rename:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_rename_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":235,"column":3},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":257,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/resize',
@@ -381,7 +420,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_0$schema,
           },
         },
         {
@@ -391,7 +430,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_1$schema,
           },
         },
         {
@@ -401,7 +440,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalAttachmentId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_2$schema,
           },
         },
         {
@@ -411,7 +450,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/resize:cols',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_3$schema,
           },
         },
         {
@@ -421,16 +460,53 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/resize:rows',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_parameter_4$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/resize:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_resize_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":245,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-terminal-controller#terminal/retain',
+      service: 'terminalController',
+      namespace: 'terminal',
+      method: 'retain',
+      mode: 'stream',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'sessionId',
+          wire: 'sessionId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_0$schema,
+          },
+        },
+        {
+          name: 'id',
+          wire: 'id',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_retain_parameter_1$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalRetentionFrame',
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_retain_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":223,"column":9},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":198,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/shells',
@@ -451,7 +527,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_shells_parameter_0$schema,
           },
         },
       ],
@@ -459,9 +535,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/shells:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_shells_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":130,"column":3},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":133,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-terminal-controller#terminal/write',
@@ -482,7 +558,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_0$schema,
           },
         },
         {
@@ -492,7 +568,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#WebTerminalId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_1$schema,
           },
         },
         {
@@ -502,7 +578,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller/types#TerminalAttachmentId',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_2$schema,
           },
         },
         {
@@ -512,16 +588,16 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/write:data',
-            schema: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema,
+            create: _deepseek_ai_dsh_api_terminal_controller_terminal_write_parameter_3$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-terminal-controller#terminal/write:result',
-        schema: _deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema,
+        create: _deepseek_ai_dsh_api_terminal_controller_terminal_write_result$schema,
       },
-      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":208,"column":9},
+      sourceLocation: {"file":"packages/api/terminal-controller/src/index.ts","line":230,"column":9},
     },
   ],
 }

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

@@ -0,0 +1,31 @@
+/** Independent content-to-terminal records keep concurrent browser writes disjoint. */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { WebTerminalId } from '../types.ts';
+/** Saved recovery targets keyed by Session and globally unique terminal content identity. */
+export declare class TerminalBindings {
+    private readonly memory;
+    /**
+     * Read a saved target, retaining this window's value when storage is unavailable.
+     * @param sessionId - owning Session.
+     * @param contentId - terminal content identity, shared only by deliberate copies.
+     * @returns the existing Host identity, if one has been saved.
+     */
+    get(sessionId: SessionId, contentId: string): WebTerminalId | undefined;
+    /**
+     * Save an identity before its Host allocation begins.
+     * @param sessionId - owning Session.
+     * @param contentId - globally unique terminal content identity.
+     * @param id - existing or newly allocated Host identity.
+     */
+    set(sessionId: SessionId, contentId: string, id: WebTerminalId): void;
+    /**
+     * Remove this content's target after its close intent has been saved.
+     * @param sessionId - owning Session.
+     * @param contentId - closing terminal content identity.
+     */
+    delete(sessionId: SessionId, contentId: string): void;
+    /** Release cached values when the Client service is disposed. */
+    clear(): void;
+    private key;
+}
+//# sourceMappingURL=bindings.d.ts.map