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

package/lib/typert.remote-client.js

@@ -62,6 +62,7 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = ()
   'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))])).readonly(),
   'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))])).readonly(),
 }).optional(),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional(),
   'agentPreset': z.union([z.literal(null), z.string()]).optional(),
   'title': z.union([z.literal(null), z.string()]).optional(),
   'todos': z.union([z.literal(null), z.array(z.object({
@@ -104,6 +105,12 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = ()
 })), z.intersection(z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
 }), z.object({
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
@@ -280,6 +287,7 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
   'next-turn': 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(),
   'next-step': 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(),
 }).optional(),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional(),
   'agentPreset': z.union([z.literal(null), z.string()]).optional(),
   'title': z.union([z.literal(null), z.string()]).optional(),
   'todos': z.union([z.literal(null), z.array(z.object({
@@ -322,6 +330,12 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
 })), z.intersection(z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
 }), z.object({
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
@@ -458,6 +472,7 @@ let _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema$valu
 const _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema$value ??= z.object({
   'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
   'atSeq': z.number().readonly().optional(),
+  'allowMigration': z.boolean().readonly().optional(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_fork_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_fork_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_fork_result$schema$value ??= z.object({
@@ -473,6 +488,7 @@ let _deepseek_ai_dsh_api_session_controller_session_list_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_list_result$schema$value ??= z.object({
   'items': z.array(z.object({
   'agentAvailable': z.boolean().readonly(),
+  'formatStatus': z.union([z.literal("current"), z.literal("migration-required")]).readonly().optional(),
   'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
   'updatedAt': z.number().readonly(),
   'running': z.boolean().readonly(),
@@ -488,6 +504,7 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = () =>
   'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))])).readonly(),
   'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))])).readonly(),
 }).optional(),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional(),
   'agentPreset': z.union([z.literal(null), z.string()]).optional(),
   'title': z.union([z.literal(null), z.string()]).optional(),
   'todos': z.union([z.literal(null), z.array(z.object({
@@ -530,6 +547,12 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = () =>
 })), z.intersection(z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
 }), z.object({
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
@@ -704,13 +727,14 @@ const _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0$sc
   'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_projections_result$schema$value
-const _deepseek_ai_dsh_api_session_controller_session_projections_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_projections_result$schema$value ??= z.union([z.literal(null), z.object({
+const _deepseek_ai_dsh_api_session_controller_session_projections_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_projections_result$schema$value ??= z.union([z.literal(null), z.intersection(z.object({
   'asOfSeq': z.number().readonly(),
   'values': z.intersection(z.object({
   'inbox': z.object({
   'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
   'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
 }).optional(),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional(),
   'agentPreset': z.union([z.literal(null), z.string()]).optional(),
   'title': z.union([z.literal(null), z.string()]).optional(),
   'todos': z.union([z.literal(null), z.array(z.object({
@@ -753,6 +777,160 @@ const _deepseek_ai_dsh_api_session_controller_session_projections_result$schema
 })), z.intersection(z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("continuable").readonly(),
+  'label': z.string().readonly(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("unknown").readonly(),
+  'label': z.string().readonly().optional(),
+}))])).optional(),
+  'subagentTiming': z.object({
+  'settledMs': z.number(),
+  'active': z.object({
+  'since': z.number(),
+  'through': z.number(),
+}).optional(),
+  'lastTurnCompleted': z.boolean().optional(),
+}).optional(),
+  'subagent': z.union([z.literal(null), z.object({
+  'mode': z.literal("one-shot"),
+  'label': z.string().optional(),
+  'seq': z.intersection(z.number(), z.unknown()),
+}), z.object({
+  'mode': z.literal("continuable"),
+  'label': z.string(),
+  'seq': z.intersection(z.number(), z.unknown()),
+})]).optional(),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional(),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional(),
+  'projectedTokens': z.number().optional(),
+  'contextWindow': z.number().optional(),
+}).optional(),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number(),
+  'toolsTokens': z.number(),
+  'messageTokens': z.number(),
+}).optional(),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'questions': z.array(z.object({
+  'id': z.string(),
+  'question': z.string(),
+  'detail': z.string().optional(),
+  'header': z.string().optional(),
+  'options': z.array(z.object({
+  'label': z.string(),
+  'description': z.string().optional(),
+})).optional(),
+  'multiSelect': z.boolean().optional(),
+  'intent': z.object({
+  'kind': z.literal("plan-review"),
+  'approve': z.string(),
+  'callId': z.intersection(z.string(), z.unknown()).optional(),
+}).optional(),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly(),
+  'settled': z.array(z.object({
+  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'answers': z.array(z.object({
+  'id': z.string(),
+  'selected': z.array(z.string()),
+  'custom': z.string().optional(),
+})).readonly(),
+})).readonly(),
+}).optional(),
+  'goal': z.union([z.literal(null), z.object({
+  'goal': z.object({
+  'objective': z.string().readonly(),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'blockedReason': z.object({
+  'code': z.string().readonly(),
+  'message': z.string().readonly(),
+}).readonly().optional(),
+  'maxGoalRounds': z.number().readonly(),
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+}).readonly(),
+  'roundsStarted': z.number().readonly(),
+  'createdAt': z.number().readonly(),
+  'updatedAt': z.number().readonly(),
+})]).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$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly()).readonly(),
+}), z.object({
+  'kind': z.literal("sequenced").readonly(),
+})), z.object({
+  'kind': z.literal("migration-required").readonly(),
+  'values': z.intersection(z.object({
+  'inbox': z.object({
+  'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
+  'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
+}).optional(),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional(),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional(),
+  'title': z.union([z.literal(null), z.string()]).optional(),
+  'todos': z.union([z.literal(null), z.array(z.object({
+  'content': z.string(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]),
+}))]).optional(),
+  'sessionListMetadata': z.object({
+  'blank': z.boolean().readonly(),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly(),
+}).optional(),
+  'imageLimits': z.object({
+  'maxImageBytes': z.number(),
+  'maxImagesPerMessage': z.number(),
+  'maxMessageImageBytes': z.number(),
+  'maxImagePixels': z.number(),
+  'maxImageDimension': z.number(),
+  'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
+}).optional(),
+  'modelSelection': z.object({
+  'lastUsed': z.union([z.literal(null), z.object({
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'reasoningEffort': z.string().readonly().optional(),
+})]).readonly(),
+  'next': z.union([z.literal(null), z.object({
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'reasoningEffort': z.string().readonly().optional(),
+})]).readonly(),
+}).optional(),
+  'permissions': z.object({
+  'currentValue': z.string(),
+}).optional(),
+  'subagentCatalog': z.array(z.union([z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("one-shot").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
+}), z.object({
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'createdAt': z.number().readonly(),
 }), z.object({
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
@@ -1017,7 +1195,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentValue',
         create: _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":444,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":453,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -1042,7 +1220,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":464,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":473,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -1057,7 +1235,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath:result',
         create: _deepseek_ai_dsh_api_session_controller_session_canOpenWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":326,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":327,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -1074,7 +1252,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionControlFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_control_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":527,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":558,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -1099,7 +1277,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateValue',
         create: _deepseek_ai_dsh_api_session_controller_session_create_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":280,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":281,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -1126,7 +1304,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_follow_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":487,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":496,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -1151,7 +1329,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkValue',
         create: _deepseek_ai_dsh_api_session_controller_session_fork_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":422,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":423,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel',
@@ -1166,7 +1344,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel:result',
         create: _deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":299,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":300,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -1192,7 +1370,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListValue',
         create: _deepseek_ai_dsh_api_session_controller_session_list_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":259,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":260,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -1207,7 +1385,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#ModelCatalog',
         create: _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":317,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":318,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -1233,7 +1411,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathValue',
         create: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":348,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -1259,7 +1437,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPage',
         create: _deepseek_ai_dsh_api_session_controller_session_page_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":475,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":484,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/projections',
@@ -1285,7 +1463,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionProjectionsValue',
         create: _deepseek_ai_dsh_api_session_controller_session_projections_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":498,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":507,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -1311,7 +1489,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptValue',
         create: _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":433,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":442,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1336,7 +1514,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameValue',
         create: _deepseek_ai_dsh_api_session_controller_session_rename_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":410,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":411,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1362,7 +1540,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchValue',
         create: _deepseek_ai_dsh_api_session_controller_session_search_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":270,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":271,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1387,7 +1565,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_selectModel_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":290,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":291,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1412,7 +1590,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueValue',
         create: _deepseek_ai_dsh_api_session_controller_session_updateQueue_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":454,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":463,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications',
@@ -1438,7 +1616,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications:result',
         create: _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":377,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":378,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',
@@ -1464,7 +1642,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SkillListValue',
         create: _deepseek_ai_dsh_api_session_controller_skills_list_result$schema,
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/skill-catalog.ts","line":35,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/skill-catalog.ts","line":36,"column":9},
     },
   ],
 }

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

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

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

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

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

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

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

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