npm - @crazx/dsh-api-session-controller - Versions diffs - 0.1.5-rc.2.zw.1 → 0.1.6-alpha.1.zw.2 - Mend

@crazx/dsh-api-session-controller 0.1.5-rc.2.zw.1 → 0.1.6-alpha.1.zw.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.i18n.yaml +2 -2
package/README.md +5 -1
package/README.zh.md +5 -1
package/lib/client.js +4 -3
package/lib/index.js +2 -2
package/lib/typert.host.js +65 -41
package/lib/typert.remote-client.js +28 -16
package/lib/types/client/time-zone.d.ts +1 -1
package/lib/types/client/time-zone.js +1 -1
package/lib/types/commands.js +3 -4
package/lib/types/history.js +1 -0
package/lib/types/index.js +1 -0
package/lib/types/skill-catalog.js +1 -0
package/lib/types/types.d.ts +2 -0
package/package.json +72 -69

package/README.i18n.yaml CHANGED Viewed

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/api/session-controller/README.md
-README.md: 24cfbba626ddec510452e3b6c8bc4333c03876bd
-README.zh.md: 883fa2343693e6512638fa437a3f8bd0db09310c
+README.md: 9b2cdeed600cd597ecfab076fe98a3a334533ba8
+README.zh.md: 04ed7808dc7ea581b489921f88349479d46d8037

package/README.md CHANGED Viewed

@@ -26,7 +26,7 @@ English | [中文](README.zh.md)
 History pages and follow opening snapshots carry one `{ type: 'event', event: SessionWireEvent }` record per durable Session event. The Client retains each accepted record as one durable `SessionEventLikeEntry`; Assistant token boundaries remain inside the compact stream on `assistant/message` or `assistant/attempt`. Tool arguments, result content, failures, and `tool/result.data.meta` pass through unchanged; the controller does not resolve a Tool definition, run a presenter, or attach UI data.
-The Client journal validates exact V3 event envelopes before publishing follow snapshots, live entries, or history pages. It reuses the browser-safe Session validators for required surface markers, exact replacement endpoints, earlier unique source seqs, embedded Assistant provenance, request-header omissions, and tool-error consistency. Invalid records fail without field stripping or normalization; range membership and source existence remain durable-log checks on the Host.
+The Client journal validates exact V3 event envelopes before publishing follow snapshots, live entries, or history pages. It reuses the browser-safe Session validators for required surface markers, exact replacement endpoints, earlier unique source seqs, embedded Assistant provider metadata, request-header omissions, and tool-error consistency. Invalid records fail without field stripping or normalization; range membership and source existence remain durable-log checks on the Host.
 Each endpoint states its activation policy. List reads only stored headers and projection-cache rows: it never calls per-session stat or opens a cold Session body. A current-format cache identity may supply every list hint; a lifecycle-matching predecessor cache may supply only its version-compatible title as a stale display fact, never as an authoritative fold seed. Search, attachment, history pages, log following, skill discovery, and workspace-path opening can inspect persistence without activating an Agent; `canOpenWorkspacePath()` reports native-opening availability without addressing a Session. Queue mutation and cancellation require live state; model, rename, prompt, and file-reference operations may resolve or resume an ordinary Session. Prompt rejects content with neither non-whitespace text nor an attachment before resolving the Agent or appending Session events; queue edits accept only non-empty text content. Prompt admission consumes opaque receipts from the injected [`fileUploads`](../../client/file-upload/README.md) Host service and resolves every same-Agent receipt before sending the complete ordered content list through `ctx.attachments`. Prompt retries whose `requestId` is already queued or logged return the original acceptance without inserting another message. Create and fork are the only operations that create a new Agent directly. The service applies one preset-aware resume policy and subagent ownership fence to its own methods and to the Typert Agent and Session lookups used by other Remote namespaces. Queue mutation has one narrow exception: a live child whose current projected identity is continuable and comes from its own non-seed suffix accepts the ordinary Edit, Remove, and QueueDock Steer actions across both inbox destinations. One-shot, missing, unknown, corrupt, seed-only, or cold children remain rejected without resume. The skill catalog uses a live Agent when present or the recorded preset's standing scope when cold, so listing never starts an Agent. The authenticated delivery routes use `workspaceDesktop()` for the serving Host name and file-manager behavior. `openWorkspacePath({ path, action: "reveal" })` delegates file-manager navigation to the native adapter; omitting `action` opens the default application.
@@ -35,6 +35,10 @@ The Client adapter exposes `SessionEventStream`, a Gateway `RemoteJournalStream`
 The Session object also carries local submission echoes: `session.beginSubmission` inserts one into `SessionSnapshot.pendingSubmissions` synchronously, before the caller serializes and prompts, so a conversation UI can show the message on the submit click's own frame. The echo stores ordered image previews and durable file references. Session derives its `transcript`, `queued`, or `steering` placement from the current running state and requested delivery mode, then retains that placement while serialization is in flight. The prompt's `requestId` is the correlation identity: the Host echoes it as the durable user source's `rpcId`, and queue occurrences project it as `SessionQueuedItem.rpcId`. An echo retires one animation frame after its durable event or queue occurrence is observed, immediately when its identified prompt fails or is abandoned, and as failed on disposal. Each retirement fires `onRetire` exactly once; an observed retirement includes the ordered durable attachment references so the composer can release successful cards while preserving failed drafts. Echoes are Client memory only; reload and reconnect rebuild the conversation from durable events alone.
+The user-invocable `skills/list` metadata includes the winning provider’s optional instruction-file `path`. The composer can preview that file without loading every skill body or activating a cold Agent.
+Fork copies history through the selected completed turn, including its `turn/end`. Events after that point, including queued input and model-setting changes, are excluded. An omitted or past-end anchor selects the last completed turn; an anchor inside an unfinished turn is rejected.
 <a id="session-media-references"></a>
 ## Session media references

package/README.zh.md CHANGED Viewed

@@ -26,7 +26,7 @@ kind: "package-reference"
 历史页与 follow opening 快照为每个持久 Session 事件携带一条 `{ type: 'event', event: SessionWireEvent }` record。Client 把每条已接受 record 保留为一个持久 `SessionEventLikeEntry`；Assistant token 边界保留在 `assistant/message` 或 `assistant/attempt` 的紧凑流内。工具参数、结果内容、失败信息和 `tool/result.data.meta` 原样通过；控制器不解析工具定义、不运行展示转换器，也不附加 UI 数据。
-Client journal 在发布 follow 快照、live entry 或历史页之前验证精确的 V3 事件 envelope。它复用浏览器安全的 Session validator，检查必需的 surface marker、精确的 replacement endpoint、更早且唯一的 source seq、内嵌 Assistant 来源、request header 可选字段的省略规则以及工具错误一致性。无效 record 直接失败，不删除字段或归一化；范围成员与来源存在性仍由 Host 的持久日志检查。
+Client journal 在发布 follow 快照、live entry 或历史页之前验证精确的 V3 事件 envelope。它复用浏览器安全的 Session validator，检查必需的 surface marker、精确的 replacement endpoint、更早且唯一的 source seq、内嵌 Assistant 提供方元数据、request header 可选字段的省略规则以及工具错误一致性。无效 record 直接失败，不删除字段或归一化；范围成员与来源存在性仍由 Host 的持久日志检查。
 每个 endpoint 都声明自己的激活策略。列表只读取持久化 header 与 projection cache row，绝不调用逐 Session stat 或打开冷 Session body。当前格式 cache identity 可以提供全部列表 hint；生命周期匹配的 predecessor cache 只能提供版本兼容的 title，作为可能过时的展示事实，绝不能作为权威 fold seed。搜索、附件、历史页、日志跟随、skill 发现和工作区路径打开可以在不激活 Agent 的情况下检查 persistence；`canOpenWorkspacePath()` 无需指定 Session 即可报告原生打开能力。queue 变更与取消要求 live 状态；模型、重命名、prompt 和文件引用操作可以解析或恢复普通 Session。提示词会在解析 Agent 或追加 Session 事件前，拒绝既没有非空白文本也没有附件的 content；queue edit 只接受非空文本 content。prompt 准入从注入的 [`fileUploads`](../../client/file-upload/README.zh.md) Host 服务取得不透明凭证，在把完整有序内容列表交给 `ctx.attachments` 前解析每个属于同一 Agent 的凭证。`requestId` 已进入 queue 或日志时，prompt 重试直接返回原来的接受结果，不会重复插入消息。只有 create 与 fork 会直接创建新 Agent。该服务把同一套感知 preset 的恢复策略和 subagent ownership fence 同时用于自身方法，以及其他 Remote namespace 使用的 Typert Agent 与 Session lookup。Queue 变更只有一个狭窄例外：当前 projection identity 为 continuable 且来自自身非 seed suffix 的在线 child，可以在两个 inbox 目标上使用普通 Edit、Remove 与 QueueDock Steer action。One-shot、缺失、未知、损坏、仅含 seed identity 或冷 child 继续被拒绝，且不会恢复。skill 目录优先使用已有 live Agent，否则使用所记录 preset 的常驻 scope，因此列表查询绝不会启动 Agent。经过鉴权的文件交付路由通过 `workspaceDesktop()` 获取提供服务的 Host 名称和文件管理器行为。`openWorkspacePath({ path, action: "reveal" })` 将文件管理器导航委托给原生适配器；省略 `action` 时打开默认应用。
@@ -35,6 +35,10 @@ Client 适配器提供 `SessionEventStream`，即绑定到一个普通 Session
 Session 对象还承载本地提交回显：`session.beginSubmission` 在调用方序列化与提示词之前，同步把一条回显写入 `SessionSnapshot.pendingSubmissions`，会话 UI 因此能在点击提交的当帧显示消息。回显按顺序存放图片预览与持久文件引用。Session 根据当前运行状态与请求的投递模式推导其 `transcript`、`queued` 或 `steering` 位置，并在序列化期间保留该位置。提示词的 `requestId` 是关联标识：Host 把它回显为 durable user source 的 `rpcId`，queue occurrence 也把它投影为 `SessionQueuedItem.rpcId`。回显在观察到其 durable event 或 queue occurrence 后延迟一个动画帧退休，带标识的提示词失败或被放弃时立即退休，销毁时按 failed 退休。每次退休恰好触发一次 `onRetire`；observed 退休还会携带有序的持久附件引用，让 composer 释放成功卡片并保留失败草稿。回显只存在于 Client 内存；刷新与重连只从持久事件重建会话。
+面向用户调用的 `skills/list` 元数据包含胜出提供方可选的指令文件 `path`。输入框可据此预览文件，无需加载每个 skill 的正文或激活冷态 Agent。
+分叉复制截至选中已结束轮次的历史，并包含其 `turn/end`。该位置之后的事件均被排除，包括排队输入和模型设置变更。省略锚点或锚点超出日志末尾时，选择最后一个已结束轮次；位于未结束轮次内的锚点会被拒绝。
 <a id="session-media-references"></a>
 ## 会话媒体引用

package/lib/client.js CHANGED Viewed

@@ -134,6 +134,7 @@ window.__ModuleLoader__.load({
 			"goal/change",
 			"hook/invoked",
 			"hook/result",
+			"image/offload",
 			"llm/retry",
 			"llm/retry-started",
 			"model/selection",
@@ -244,7 +245,7 @@ window.__ModuleLoader__.load({
 			return op;
 		}
 		/** Validate cited source-event seqs against prior log entries and the replacement range. */
-		function assertProvenance(event, shadowedSeqs) {
+		function assertSourceEventReferences(event, shadowedSeqs) {
 			const raw = event.sourceEventSeqs;
 			if (event.type === "assistant/message" && raw !== void 0) throw new Error("assistant/message embeds its source stream and cannot carry sourceEventSeqs");
 			const sources = /* @__PURE__ */ new Set();
@@ -273,7 +274,7 @@ window.__ModuleLoader__.load({
 		function validateSurfaceMetadata(event) {
 			const op = surfaceOpOf(event);
 			if (op !== void 0 && op !== "append" && (op.startSeq >= event.seq || op.endSeq >= event.seq)) throw new Error(`surface replace at seq ${event.seq}: startSeq and endSeq must reference earlier events`);
-			if (op !== void 0) assertProvenance(event, []);
+			if (op !== void 0) assertSourceEventReferences(event, []);
 			return op;
 		}
 		//#endregion
@@ -938,7 +939,7 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/time-zone.js
-		/** Browser-owned time-zone sampling for prompt RPC provenance. */
+		/** Browser-owned time-zone sampling for one prompt RPC. */
 		/**
 		* Resolve the current browser IANA zone for one outbound operation.
 		* @returns The browser-provided canonical zone.

package/lib/index.js CHANGED Viewed

@@ -698,8 +698,7 @@ var SessionCommandController = class {
 			const lastSeq = source.events.at(-1)?.seq ?? -1;
 			const boundary = (atSeq === void 0 ? void 0 : source.events.find((event) => event.type === "turn/end" && event.seq >= atSeq)) ?? (atSeq === void 0 || atSeq > lastSeq ? source.events.findLast((event) => event.type === "turn/end") : void 0);
 			if (boundary === void 0) throw new RemoteError("session/fork-unavailable", atSeq !== void 0 && atSeq <= lastSeq ? `session "${request.sessionId}" has not completed the turn containing event ${String(atSeq)}` : `session "${request.sessionId}" has no completed turn to fork from`, { sessionId: request.sessionId });
-			let cut = SessionLogOffset(boundary.seq + 1);
-			while (cut < source.events.length && source.events[cut]?.type !== "turn/start") cut = SessionLogOffset(cut + 1);
+			const cut = SessionLogOffset(boundary.seq + 1);
 			let workspace;
 			try {
 				workspace = await this.forkWorkspace(source.header);
@@ -2296,6 +2295,7 @@ let SessionSkillCatalog = (() => {
 					scope
 				})).filter(isUserInvocable).map((skill) => ({
 					name: skill.name,
+					...skill.path === void 0 ? {} : { path: skill.path },
 					description: skill.description,
 					...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
 					modelInvocable: skill.invocation.modelInvocable

package/lib/typert.host.js CHANGED Viewed

@@ -25,6 +25,7 @@ const ContentBlockRemoteCodec$schema = z.union([z.object({
   'height': z.number(),
 }).optional(),
 }),
+  'offloaded': z.literal(true).optional(),
 }), z.object({
   'type': z.literal("reasoning"),
   'text': z.string(),
@@ -132,6 +133,9 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = z.
   '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(),
@@ -310,6 +314,9 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   '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(),
@@ -454,6 +461,9 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = z.obj
   '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(),
@@ -651,6 +661,7 @@ const _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$sc
   'height': z.number(),
 }).optional(),
 }),
+  'offloaded': z.literal(true).optional(),
 }), z.object({
   'type': z.literal("reasoning"),
   'text': z.string(),
@@ -679,6 +690,7 @@ const _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema = z
 })
 const _deepseek_ai_dsh_api_session_controller_skills_list_result$schema = z.object({
   'skills': z.array(z.object({
+  'path': z.string().readonly().optional(),
   'name': z.string().readonly(),
   'description': z.string().readonly(),
   'whenToUse': z.string().readonly().optional(),
@@ -756,7 +768,7 @@ export const TYPERT = {
         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":357,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":358,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -781,7 +793,7 @@ export const TYPERT = {
         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":377,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":378,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -796,7 +808,7 @@ export const TYPERT = {
         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":272,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":273,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -813,7 +825,7 @@ export const TYPERT = {
         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":410,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":411,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -838,7 +850,7 @@ export const TYPERT = {
         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":244,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":245,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -865,7 +877,7 @@ export const TYPERT = {
         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":400,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":401,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -890,7 +902,7 @@ export const TYPERT = {
         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":335,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":336,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -916,7 +928,7 @@ export const TYPERT = {
         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":223,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":224,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -931,7 +943,7 @@ export const TYPERT = {
         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":263,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":264,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -957,7 +969,7 @@ export const TYPERT = {
         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":293,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":294,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -983,7 +995,7 @@ export const TYPERT = {
         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":388,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":389,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -1009,7 +1021,7 @@ export const TYPERT = {
         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":346,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1034,7 +1046,7 @@ export const TYPERT = {
         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":325,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":326,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1060,7 +1072,7 @@ export const TYPERT = {
         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":234,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":235,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1085,7 +1097,7 @@ export const TYPERT = {
         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":254,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":255,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1110,7 +1122,7 @@ export const TYPERT = {
         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":367,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":368,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',
@@ -1329,8 +1341,8 @@ export const TYPERT = {
             "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
           },
           {
-            "name": "AssistantProvenance",
-            "declaration": "export interface AssistantProvenance {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
+            "name": "AssistantProviderMetadata",
+            "declaration": "export interface AssistantProviderMetadata {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
           },
           {
             "name": "AssistantStreamRecord",
@@ -1474,12 +1486,16 @@ export const TYPERT = {
           },
           {
             "name": "ImageBlock",
-            "declaration": "export interface ImageBlock {\n    type: 'image';\n    attachment: ImageAttachmentRef;\n}"
+            "declaration": "export interface ImageBlock {\n    type: 'image';\n    attachment: ImageAttachmentRef;\n    offloaded?: true;\n}"
           },
           {
             "name": "ImageMediaType",
             "declaration": "export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';"
           },
+          {
+            "name": "ImageOffloadTarget",
+            "declaration": "export interface ImageOffloadTarget {\n    seq: SessionSeq;\n    imageIndexes: number[];\n}"
+          },
           {
             "name": "Inbox",
             "declaration": "export interface Inbox {\n    readonly nextTurn: readonly UserMessage[];\n    readonly nextStep: readonly UserMessage[];\n    clear(): void;\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
@@ -1514,7 +1530,7 @@ export const TYPERT = {
           },
           {
             "name": "LlmFailure",
-            "declaration": "export interface LlmFailure {\n    readonly message: string;\n    readonly code: string;\n    readonly status?: number;\n    readonly providerRetryAfterMs?: number;\n    readonly requestId?: ProviderRequestId;\n}"
+            "declaration": "export interface LlmFailure {\n    readonly message: string;\n    readonly code: string;\n    readonly status?: number;\n    readonly providerRetryAfterMs?: number;\n    readonly requestId?: ProviderRequestId;\n    readonly offloadImages?: number;\n}"
           },
           {
             "name": "Message",
@@ -1566,7 +1582,7 @@ export const TYPERT = {
           },
           {
             "name": "ModelMessageSource",
-            "declaration": "export interface ModelMessageSource extends AssistantProvenance {\n    kind: 'model';\n}"
+            "declaration": "export interface ModelMessageSource extends AssistantProviderMetadata {\n    kind: 'model';\n}"
           },
           {
             "name": "ModelProviderGroup",
@@ -1596,6 +1612,10 @@ export const TYPERT = {
             "name": "OptionalSessionSeq",
             "declaration": "export type OptionalSessionSeq = SessionSeq | null;"
           },
+          {
+            "name": "PermissionSelection",
+            "declaration": "export interface PermissionSelection {\n    currentValue: string;\n}"
+          },
           {
             "name": "PromptContentPart",
             "declaration": "export type PromptContentPart = { readonly type: 'text'; readonly text: string; } | { readonly type: 'image'; readonly mediaType: ImageMediaType; readonly data: string; readonly name?: string; } | { readonly type: 'file'; readonly receiptId: Branded<'file-upload-receipt-id'>; };"
@@ -1606,7 +1626,7 @@ export const TYPERT = {
           },
           {
             "name": "PtcDispatchEventData",
-            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n}"
+            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n    error?: { name: string; code: string; reason?: string; };\n}"
           },
           {
             "name": "PtcDispatchStartEventData",
@@ -1634,7 +1654,7 @@ export const TYPERT = {
           },
           {
             "name": "RemoteErrorDetailsMap",
-            "declaration": "export interface RemoteErrorDetailsMap {\n    'gateway/bad-request': { readonly issues?: readonly object[]; };\n    'gateway/cancelled': {};\n    'gateway/internal': {};\n    'llm/model-discovery-rejected': { readonly settingsNs: string; readonly baseURL?: string; };\n    'session/not-found': { readonly sessionId: SessionId; };\n    'agent-preset/not-found': { readonly agentPreset: string; readonly available: readonly string[]; };\n    'agent-preset/invalid': { readonly agentPreset: string; readonly reason: string; };\n    'agent-preset/read-only': { readonly agentPreset: string; readonly reason: string; };\n    'agent-preset/locked': { readonly sessionId: SessionId; readonly agentPreset: string; };\n    'workspace/not-found': { readonly workspaceId: WorkspaceId; };\n    'session/model-unavailable': { readonly provider: string; readonly model: string; };\n    'session/conflict': { readonly sessionId: SessionId; readonly requestedCwd: string; readonly existingCwd?: string; };\n    'session/agent-busy': { readonly reason: string; };\n    'session/invalid-time-zone': { readonly value: string; };\n    'session/workspace-attach-failed': { readonly sessionId: SessionId; readonly workspaceId: string; };\n    'agent-preset/conflict': { readonly sessionId: SessionId; readonly requestedPreset: string; readonly existingPreset?: string; };\n    'session/attachment-invalid': { readonly reason: string; };\n    'session/queue-item-not-found': { readonly itemId: MessageId; };\n    'session/steer-unavailable': { readonly itemId: MessageId; };\n    'session/title-invalid': { readonly sessionId: SessionId; };\n    'session/fork-unavailable': { readonly sessionId: SessionId; };\n    'subagent/not-found': { readonly parentSessionId: SessionId; readonly childSessionId: SessionId; };\n    'subagent/catalog-diagnostic': { readonly parentSessionId: SessionId; readonly childSessionId: SessionId; readonly reason: 'corrupt' | 'unsupported' | 'unavailable'; };\n    'subagent/invalid-time-zone': { readonly value: string; };\n    'subagent/parent-unavailable': { readonly parentSessionId: SessionId; };\n    'subagent/not-resumable': { readonly childSessionId: SessionId; };\n    'subagent/unauthorized': { readonly childSessionId: SessionId; };\n    'subagent/attachment-invalid': { readonly reason: string; };\n    'subagent/delivery-unavailable': { readonly childSessionId: SessionId; };\n    'subagent/projections-unavailable': {};\n    'settings/rejected': { readonly ns: string; };\n    'settings/conflict': { readonly ns: string; readonly expected: number; readonly actual: number; };\n    'credential/rejected': { readonly ref: string; };\n    'workspace/invalid-path': { readonly path: string; };\n    'workspace/name-conflict': { readonly name: string; };\n    'workspace/move-invalid': { readonly workspaceId: WorkspaceId; readonly sessionId: SessionId; readonly beforeSessionId?: SessionId; };\n    'directory-picker/unavailable': { readonly capability: string; };\n    'directory-picker/unreadable': { readonly path: string; };\n    'directory-picker/exists': { readonly path: string; };\n    'directory-picker/create-failed': { readonly path: string; };\n    'workspace-file/not-found': { readonly path: string; };\n    'workspace-file/outside-workspace': { readonly path: string; };\n    'workspace-file/too-large': { readonly path: string; readonly limit: number; };\n    'workspace-file/not-text': { readonly path: string; };\n    'workspace-file/not-regular-file': { readonly path: string; readonly kind: 'directory' | 'symlink' | 'other'; };\n    'workspace-file/not-directory': { readonly path: string; readonly kind: 'file' | 'symlink' | 'other'; };\n}"
+            "declaration": "export interface RemoteErrorDetailsMap {\n    'gateway/bad-request': { readonly issues?: readonly object[]; };\n    'gateway/cancelled': {};\n    'gateway/internal': {};\n    'llm/model-discovery-rejected': { readonly settingsNs: string; readonly baseURL?: string; };\n    'session/not-found': { readonly sessionId: SessionId; };\n    'agent-preset/not-found': { readonly agentPreset: string; readonly available: readonly string[]; };\n    'agent-preset/invalid': { readonly agentPreset: string; readonly reason: string; };\n    'agent-preset/read-only': { readonly agentPreset: string; readonly reason: string; };\n    'agent-preset/locked': { readonly sessionId: SessionId; readonly agentPreset: string; };\n    'workspace/not-found': { readonly workspaceId: WorkspaceId; };\n    'session/model-unavailable': { readonly provider: string; readonly model: string; };\n    'session/conflict': { readonly sessionId: SessionId; readonly requestedCwd: string; readonly existingCwd?: string; };\n    'session/agent-busy': { readonly reason: string; };\n    'session/invalid-time-zone': { readonly value: string; };\n    'session/workspace-attach-failed': { readonly sessionId: SessionId; readonly workspaceId: string; };\n    'agent-preset/conflict': { readonly sessionId: SessionId; readonly requestedPreset: string; readonly existingPreset?: string; };\n    'session/attachment-invalid': { readonly reason: string; };\n    'session/queue-item-not-found': { readonly itemId: MessageId; };\n    'session/steer-unavailable': { readonly itemId: MessageId; };\n    'session/title-invalid': { readonly sessionId: SessionId; };\n    'session/fork-unavailable': { readonly sessionId: SessionId; };\n    'subagent/not-found': { readonly parentSessionId: SessionId; readonly childSessionId: SessionId; };\n    'subagent/catalog-diagnostic': { readonly parentSessionId: SessionId; readonly childSessionId: SessionId; readonly reason: 'corrupt' | 'unsupported' | 'unavailable'; };\n    'subagent/invalid-time-zone': { readonly value: string; };\n    'subagent/parent-unavailable': { readonly parentSessionId: SessionId; };\n    'subagent/not-resumable': { readonly childSessionId: SessionId; };\n    'subagent/unauthorized': { readonly childSessionId: SessionId; };\n    'subagent/attachment-invalid': { readonly reason: string; };\n    'subagent/delivery-unavailable': { readonly childSessionId: SessionId; };\n    'subagent/projections-unavailable': {};\n    'settings/rejected': { readonly ns: string; };\n    'settings/conflict': { readonly ns: string; readonly expected: number; readonly actual: number; };\n    'credential/rejected': { readonly ref: string; };\n    'terminal/control-unavailable': { readonly reason: 'read-only' | 'not-running'; };\n    'terminal/limit-reached': { readonly limit: number; };\n    'workspace/invalid-path': { readonly path: string; };\n    'workspace/name-conflict': { readonly name: string; };\n    'workspace/move-invalid': { readonly workspaceId: WorkspaceId; readonly sessionId: SessionId; readonly beforeSessionId?: SessionId; };\n    'directory-picker/unavailable': { readonly capability: string; };\n    'directory-picker/unreadable': { readonly path: string; };\n    'directory-picker/exists': { readonly path: string; };\n    'directory-picker/create-failed': { readonly path: string; };\n    'workspace-file/not-found': { readonly path: string; };\n    'workspace-file/outside-workspace': { readonly path: string; };\n    'workspace-file/too-large': { readonly path: string; readonly limit: number; };\n    'workspace-file/not-text': { readonly path: string; };\n    'workspace-file/not-regular-file': { readonly path: string; readonly kind: 'directory' | 'symlink' | 'other'; };\n    'workspace-file/not-directory': { readonly path: string; readonly kind: 'file' | 'symlink' | 'other'; };\n}"
           },
           {
             "name": "ReplayEnvelope",
@@ -1714,7 +1734,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -1798,7 +1818,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionProjectionMap",
-            "declaration": "export interface SessionProjectionMap {\n    inbox: InboxWireState;\n    agentPreset: string | null;\n    title: string | null;\n    todos: TodoItem[] | null;\n    sessionListMetadata: SessionListMetadata;\n    imageLimits: ImageAttachmentLimits;\n    modelSelection: ModelSelectionProjection;\n    subagentCatalog: SubagentCatalogEntry[];\n    subagentTiming: SubagentTimingProjection;\n    subagent: SubagentIdentityProjection | null;\n    goal: GoalProjection | null;\n}"
+            "declaration": "export interface SessionProjectionMap {\n    inbox: InboxWireState;\n    agentPreset: string | null;\n    title: string | null;\n    todos: TodoItem[] | null;\n    sessionListMetadata: SessionListMetadata;\n    imageLimits: ImageAttachmentLimits;\n    modelSelection: ModelSelectionProjection;\n    permissions: PermissionSelection;\n    subagentCatalog: SubagentCatalogEntry[];\n    subagentTiming: SubagentTimingProjection;\n    subagent: SubagentIdentityProjection | null;\n    goal: GoalProjection | null;\n}"
           },
           {
             "name": "SessionProjectionUpdate",
@@ -1878,15 +1898,15 @@ export const TYPERT = {
           },
           {
             "name": "SessionSurface",
-            "declaration": "export interface SessionSurface {\n    readonly nodes: readonly SessionSeq[];\n    readonly replaceGeneration: number;\n}"
+            "declaration": "export interface SessionSurface {\n    readonly nodes: readonly SessionSeq[];\n    readonly replaceGeneration: number;\n    readonly contentGeneration: number;\n}"
           },
           {
             "name": "SessionTitleEventData",
             "declaration": "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: SessionSeq[];\n    readonly source: SessionTitleSource;\n}"
           },
           {
-            "name": "SessionTitleModelProvenance",
-            "declaration": "export interface SessionTitleModelProvenance {\n    readonly provider: string;\n    readonly model: string;\n}"
+            "name": "SessionTitleModelIdentity",
+            "declaration": "export interface SessionTitleModelIdentity {\n    readonly provider: string;\n    readonly model: string;\n}"
           },
           {
             "name": "SessionTitleProviderId",
@@ -1894,7 +1914,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionTitleSource",
-            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelProvenance; } | { readonly kind: 'user'; };"
+            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelIdentity; } | { readonly kind: 'user'; };"
           },
           {
             "name": "SessionUpdateQueueRequest",
@@ -2120,8 +2140,8 @@ export const TYPERT = {
             "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
           },
           {
-            "name": "AssistantProvenance",
-            "declaration": "export interface AssistantProvenance {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
+            "name": "AssistantProviderMetadata",
+            "declaration": "export interface AssistantProviderMetadata {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
           },
           {
             "name": "AssistantStreamRecord",
@@ -2261,12 +2281,16 @@ export const TYPERT = {
           },
           {
             "name": "ImageBlock",
-            "declaration": "export interface ImageBlock {\n    type: 'image';\n    attachment: ImageAttachmentRef;\n}"
+            "declaration": "export interface ImageBlock {\n    type: 'image';\n    attachment: ImageAttachmentRef;\n    offloaded?: true;\n}"
           },
           {
             "name": "ImageMediaType",
             "declaration": "export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';"
           },
+          {
+            "name": "ImageOffloadTarget",
+            "declaration": "export interface ImageOffloadTarget {\n    seq: SessionSeq;\n    imageIndexes: number[];\n}"
+          },
           {
             "name": "Inbox",
             "declaration": "export interface Inbox {\n    readonly nextTurn: readonly UserMessage[];\n    readonly nextStep: readonly UserMessage[];\n    clear(): void;\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
@@ -2289,7 +2313,7 @@ export const TYPERT = {
           },
           {
             "name": "LlmFailure",
-            "declaration": "export interface LlmFailure {\n    readonly message: string;\n    readonly code: string;\n    readonly status?: number;\n    readonly providerRetryAfterMs?: number;\n    readonly requestId?: ProviderRequestId;\n}"
+            "declaration": "export interface LlmFailure {\n    readonly message: string;\n    readonly code: string;\n    readonly status?: number;\n    readonly providerRetryAfterMs?: number;\n    readonly requestId?: ProviderRequestId;\n    readonly offloadImages?: number;\n}"
           },
           {
             "name": "Message",
@@ -2329,7 +2353,7 @@ export const TYPERT = {
           },
           {
             "name": "ModelMessageSource",
-            "declaration": "export interface ModelMessageSource extends AssistantProvenance {\n    kind: 'model';\n}"
+            "declaration": "export interface ModelMessageSource extends AssistantProviderMetadata {\n    kind: 'model';\n}"
           },
           {
             "name": "ModelSelection",
@@ -2349,7 +2373,7 @@ export const TYPERT = {
           },
           {
             "name": "PtcDispatchEventData",
-            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n}"
+            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n    error?: { name: string; code: string; reason?: string; };\n}"
           },
           {
             "name": "PtcDispatchStartEventData",
@@ -2389,7 +2413,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -2421,15 +2445,15 @@ export const TYPERT = {
           },
           {
             "name": "SessionSurface",
-            "declaration": "export interface SessionSurface {\n    readonly nodes: readonly SessionSeq[];\n    readonly replaceGeneration: number;\n}"
+            "declaration": "export interface SessionSurface {\n    readonly nodes: readonly SessionSeq[];\n    readonly replaceGeneration: number;\n    readonly contentGeneration: number;\n}"
           },
           {
             "name": "SessionTitleEventData",
             "declaration": "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: SessionSeq[];\n    readonly source: SessionTitleSource;\n}"
           },
           {
-            "name": "SessionTitleModelProvenance",
-            "declaration": "export interface SessionTitleModelProvenance {\n    readonly provider: string;\n    readonly model: string;\n}"
+            "name": "SessionTitleModelIdentity",
+            "declaration": "export interface SessionTitleModelIdentity {\n    readonly provider: string;\n    readonly model: string;\n}"
           },
           {
             "name": "SessionTitleProviderId",
@@ -2437,7 +2461,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionTitleSource",
-            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelProvenance; } | { readonly kind: 'user'; };"
+            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelIdentity; } | { readonly kind: 'user'; };"
           },
           {
             "name": "SkillInvocationSource",
@@ -2604,7 +2628,7 @@ export const TYPERT = {
           },
           {
             "name": "SkillEntry",
-            "declaration": "export interface SkillEntry {\n    readonly name: string;\n    readonly description: string;\n    readonly whenToUse?: string;\n    readonly modelInvocable: boolean;\n}"
+            "declaration": "export interface SkillEntry {\n    readonly path?: string;\n    readonly name: string;\n    readonly description: string;\n    readonly whenToUse?: string;\n    readonly modelInvocable: boolean;\n}"
           },
           {
             "name": "SkillListRequest",

package/lib/typert.remote-client.js CHANGED Viewed

@@ -25,6 +25,7 @@ const ContentBlockRemoteCodec$schema = z.union([z.object({
   'height': z.number(),
 }).optional(),
 }),
+  'offloaded': z.literal(true).optional(),
 }), z.object({
   'type': z.literal("reasoning"),
   'text': z.string(),
@@ -132,6 +133,9 @@ const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = z.
   '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(),
@@ -310,6 +314,9 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = z.u
   '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(),
@@ -454,6 +461,9 @@ const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = z.obj
   '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(),
@@ -651,6 +661,7 @@ const _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$sc
   'height': z.number(),
 }).optional(),
 }),
+  'offloaded': z.literal(true).optional(),
 }), z.object({
   'type': z.literal("reasoning"),
   'text': z.string(),
@@ -679,6 +690,7 @@ const _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema = z
 })
 const _deepseek_ai_dsh_api_session_controller_skills_list_result$schema = z.object({
   'skills': z.array(z.object({
+  'path': z.string().readonly().optional(),
   'name': z.string().readonly(),
   'description': z.string().readonly(),
   'whenToUse': z.string().readonly().optional(),
@@ -753,7 +765,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":357,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":358,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
@@ -778,7 +790,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":377,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":378,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
@@ -793,7 +805,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":272,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":273,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/control',
@@ -810,7 +822,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":410,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":411,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/create',
@@ -835,7 +847,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":244,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":245,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/follow',
@@ -862,7 +874,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":400,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":401,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/fork',
@@ -887,7 +899,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":335,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":336,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/list',
@@ -913,7 +925,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":223,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":224,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
@@ -928,7 +940,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":263,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":264,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
@@ -954,7 +966,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":293,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":294,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/page',
@@ -980,7 +992,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":388,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":389,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
@@ -1006,7 +1018,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":346,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/rename',
@@ -1031,7 +1043,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":325,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":326,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/search',
@@ -1057,7 +1069,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":234,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":235,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
@@ -1082,7 +1094,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":254,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":255,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
@@ -1107,7 +1119,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":367,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":368,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-api-session-controller#skills/list',

package/lib/types/client/time-zone.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-/** Browser-owned time-zone sampling for prompt RPC provenance. */
+/** Browser-owned time-zone sampling for one prompt RPC. */
 /**
  * Resolve the current browser IANA zone for one outbound operation.
  * @returns The browser-provided canonical zone.

package/lib/types/client/time-zone.js CHANGED Viewed

@@ -1,4 +1,4 @@
-/** Browser-owned time-zone sampling for prompt RPC provenance. */
+/** Browser-owned time-zone sampling for one prompt RPC. */
 /**
  * Resolve the current browser IANA zone for one outbound operation.
  * @returns The browser-provided canonical zone.

package/lib/types/commands.js CHANGED Viewed

@@ -257,10 +257,7 @@ export class SessionCommandController {
                     ? `session "${request.sessionId}" has not completed the turn containing event ${String(atSeq)}`
                     : `session "${request.sessionId}" has no completed turn to fork from`, { sessionId: request.sessionId });
             }
-            let cut = SessionLogOffset(boundary.seq + 1);
-            while (cut < source.events.length && source.events[cut]?.type !== 'turn/start') {
-                cut = SessionLogOffset(cut + 1);
-            }
+            const cut = SessionLogOffset(boundary.seq + 1);
             let workspace;
             try {
                 workspace = await this.forkWorkspace(source.header);
@@ -526,6 +523,7 @@ export class SessionCommandController {
     async readSessionState(sessionId) {
         const attached = this.ctx.sessions.get(sessionId);
         if (attached !== undefined) {
+            // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
             return { id: attached.id, header: attached.header, events: attached.snapshotEvents() };
         }
         const inspected = await inspectApiSession(this.ctx, sessionId);
@@ -566,6 +564,7 @@ function hasPromptRequest(agent, requestId) {
     };
     if (agent.inbox.nextTurn.some(matches) || agent.inbox.nextStep.some(matches))
         return true;
+    // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
     return agent.session.snapshotEvents().some((event) => {
         if (event.type !== 'user/message')
             return false;

package/lib/types/history.js CHANGED Viewed

@@ -167,6 +167,7 @@ export class SessionHistoryController {
             // Constructor seed events have no session/event notification. Normally
             // only the end-seed suffix is new; if persistence advanced after the
             // opening observation, replay everything beyond that snapshot cursor.
+            // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
             const suffix = session.snapshotEvents(snapshotCursor === undefined
                 ? session.firstLiveSeq
                 : SessionLogOffset(snapshotCursor + 1));

package/lib/types/index.js CHANGED Viewed

@@ -281,6 +281,7 @@ let SessionController = (() => {
                 return Promise.resolve({
                     meta: attached.header,
                     inheritedEventCount: attached.inheritedEventCount,
+                    // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
                     events: attached.snapshotEvents(),
                 });
             }

package/lib/types/skill-catalog.js CHANGED Viewed

@@ -159,6 +159,7 @@ let SessionSkillCatalog = (() => {
                 return {
                     skills: skills.map(skill => ({
                         name: skill.name,
+                        ...skill.path === undefined ? {} : { path: skill.path },
                         description: skill.description,
                         ...skill.whenToUse === undefined ? {} : { whenToUse: skill.whenToUse },
                         modelInvocable: skill.invocation.modelInvocable,

package/lib/types/types.d.ts CHANGED Viewed

@@ -219,6 +219,8 @@ export interface SkillListRequest {
 }
 /** One skill available to the Session's human-facing composer. */
 export interface SkillEntry {
+    /** Absolute SKILL.md path when supplied by a filesystem provider. */
+    readonly path?: string;
     /** Kebab-case identifier referenced as `/name`. */
     readonly name: string;
     /** Short routing description. */

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@crazx/dsh-api-session-controller",
   "description": "Session Remote commands, cold reads, and live control transport",
-  "version": "0.1.5-rc.2.zw.1",
+  "version": "0.1.6-alpha.1.zw.2",
   "publishConfig": {
     "access": "public"
   },
@@ -47,7 +47,8 @@
         "@deepseek-ai/dsh-api-gateway/client"
       ],
       "inject": [
-        "@deepseek-ai/dsh-api-gateway"
+        "@deepseek-ai/dsh-api-gateway",
+        "@deepseek-ai/dsh-client-file-upload"
       ],
       "platform": "web"
     }
@@ -64,42 +65,42 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-deque": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-deque": "^0.1.6-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "mime-types": "^3.0.2",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.5-rc.2.zw.1",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-file-reference": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-fs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.6-alpha.1.zw.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-fs": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-native-command": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-jobs": {
@@ -114,43 +115,45 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "npm:@crazx/dsh-agent-default-model@0.1.5-rc.2.zw.1",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-file-reference": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-fs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-fs-local": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage-json": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-default-model": "npm:@crazx/dsh-agent-default-model@0.1.6-alpha.1.zw.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "npm:@crazx/dsh-client-test-runtime@0.1.6-alpha.1.zw.2",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-fs": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-fs-local": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-native-command": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-storage": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.1",
     "@types/mime-types": "^3.0.1"
   },
   "scripts": {