@deepseek-ai/dsh-session-reference 0.1.6-alpha.1 → 0.1.7-alpha.1

package/README.i18n.yaml

@@ -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/context/session-reference/README.md
-README.md: 533a1282da920b6daa47ef5be98e49c691a8cb84
-README.zh.md: e7b43c9a56cd5b4062770144ccea0bf125153b40
+README.md: e1afeef9b0e78826705ad2b3e426373b2bf0833d
+README.zh.md: e55dab4f6403cb6aee947f80873ffe99919acc5f

package/README.md

@@ -39,7 +39,7 @@ For a truncated reference, an optional spill backend saves the full captured tex
 
 ### Finding sessions to reference
 
-`listCandidates(agent, query?, limit?)` lists sessions other than the agent's own, filters case-insensitively by id, working directory, or the projected title, and ranks same-directory sessions first. Each candidate carries its latest title as the mention label, falling back to the session id when the title is absent or unreadable, and reports whether its working directory is the requesting agent's so a host can surface a location only when it distinguishes the row. Browser consumers call the same discovery as `ctx.remote.sessionReferenceResolver.candidates`, which attaches each candidate's canonical mention.
+`listCandidates(agent, query?, limit?)` lists sessions other than the agent's own, filters case-insensitively by id, working directory, projected title, or display title, and ranks same-directory sessions first. Each candidate carries its latest title as `label`, falling back to the session id when the title is absent or unreadable. Its display title prefers a subagent's durable creation label over that title. The candidate also reports whether its working directory is the requesting agent's so a host can surface a location only when it distinguishes the row. Browser consumers call the same discovery as `ctx.remote.sessionReferenceResolver.candidates`, which labels the canonical mention with `displayTitle` when present.
 
 ### Configuration
 

package/README.zh.md

@@ -39,7 +39,7 @@ kind: "package-reference"
 
 ### 查找可引用的会话
 
-`listCandidates(agent, query?, limit?)` 列出除 agent 自身外的会话，按 id、工作目录或投影标题做不区分大小写的过滤，并把同目录会话排在前面。每个候选以其最新标题作为 mention 标签；标题缺失或不可读时回退到会话 id，并报告其工作目录是否就是发起方 agent 的工作目录，宿主因此可以只在位置能区分该行时才显示它。浏览器消费方通过 `ctx.remote.sessionReferenceResolver.candidates` 调用同一发现能力，该方法会为每个候选附上规范 mention。
+`listCandidates(agent, query?, limit?)` 列出除 agent 自身外的会话，按 id、工作目录、投影标题或显示标题做不区分大小写的过滤，并把同目录会话排在前面。每个候选的 `label` 使用最新标题；标题缺失或不可读时回退到会话 id。显示标题优先使用 subagent 的持久创建 label，再回退到该标题。候选还会报告其工作目录是否就是发起方 agent 的工作目录，宿主因此可以只在位置能区分该行时才显示它。浏览器消费方通过 `ctx.remote.sessionReferenceResolver.candidates` 调用同一发现能力；该方法在 `displayTitle` 存在时用它标记规范 mention。
 
 ### 配置
 

package/lib/index.js

@@ -1,10 +1,10 @@
 import z from "@deepseek-ai/schemastery";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import { LlmError, createUserMessage, freezeMessage } from "@deepseek-ai/dsh-llm";
-import { SessionLogOffset, SessionSeq } from "@deepseek-ai/dsh-session";
 import { isCompactCheckpointSource } from "@deepseek-ai/dsh-compaction";
 import { TextRetainer } from "@deepseek-ai/dsh-output-retention";
 import { assertNever } from "@deepseek-ai/dsh-util-values";
+import { SessionSeq } from "@deepseek-ai/dsh-session";
 import { brandString } from "@deepseek-ai/dsh-brand";
 //#region lib/types/spill.js
 /** Full projected transcripts and model-visible spill outcomes for bounded reference previews. */
@@ -150,6 +150,7 @@ function projectSessionConversation(snapshot) {
 			});
 			break;
 		}
+		case "developer/message":
 		case "system/message":
 		case "tool/result": break;
 		/* v8 ignore next 2 -- SurfaceEventType is closed and every variant is handled above. */
@@ -508,14 +509,13 @@ let SessionReferenceResolver = (() => {
 		/**
 		* List reference candidates, ranked by working-directory affinity.
 		*
-		* Discovery runs at keystroke rate, so a title only ever comes from a
-		* projection read: see {@link SessionReferenceResolver.projectedTitle} for
-		* which sessions can answer one and which fall back to their id.
+		* Discovery runs at keystroke rate, so titles and subagent labels only ever
+		* come from projection reads; sessions without either fall back to their id.
 		* @param agent - target agent; self is excluded and its cwd drives ranking.
-		* @param query - optional case-insensitive session-id/cwd/title substring.
+		* @param query - optional case-insensitive session-id/cwd/title/display-title substring.
 		* @param limit - optional positive result cap.
 		* @param signal - optional cancellation boundary for host autocomplete teardown.
-		* @returns candidates labeled by latest title or, when absent, session id.
+		* @returns candidates with canonical mention labels and presentation titles.
 		*/
 		async listCandidates(agent, query = "", limit = this.config.candidateLimit, signal) {
 			if (!Number.isSafeInteger(limit) || limit <= 0) throw new SessionReferenceError("candidate limit must be a positive safe integer", "SESSION_REFERENCE_INVALID_REFERENCE");
@@ -528,20 +528,21 @@ let SessionReferenceResolver = (() => {
 			})).map(({ record, index }) => ({
 				record,
 				index,
-				label: this.projectedTitle(record) ?? record.header.id
-			})).filter(({ record, label }) => {
+				...this.projectedLabels(record)
+			})).filter(({ record, label, displayTitle }) => {
 				if (needle === "") return true;
-				return record.header.id.toLocaleLowerCase().includes(needle) || record.header.cwd?.toLocaleLowerCase().includes(needle) === true || label.toLocaleLowerCase().includes(needle);
-			}).sort((a, b) => candidateRank(a.record.header.cwd, targetCwd) - candidateRank(b.record.header.cwd, targetCwd) || a.index - b.index).slice(0, limit).map(({ record, label }) => ({
+				return record.header.id.toLocaleLowerCase().includes(needle) || record.header.cwd?.toLocaleLowerCase().includes(needle) === true || label.toLocaleLowerCase().includes(needle) || displayTitle.toLocaleLowerCase().includes(needle);
+			}).sort((a, b) => candidateRank(a.record.header.cwd, targetCwd) - candidateRank(b.record.header.cwd, targetCwd) || a.index - b.index).slice(0, limit).map(({ record, label, displayTitle }) => ({
 				sessionId: record.header.id,
 				label,
+				displayTitle,
 				...record.header.cwd === void 0 ? {} : { cwd: record.header.cwd },
 				sameWorkspace: record.header.cwd !== void 0 && record.header.cwd === targetCwd,
 				createdAt: record.header.createdAt
 			}));
 		}
 		/**
-		* The title a session's projections can answer without reading its log.
+		* The mention label and display title a Session's projections can answer without reading its log.
 		*
 		* Attachment is decided by the store at read time, not by the listing:
 		* a session that attached in between would otherwise be answered from a
@@ -556,18 +557,21 @@ let SessionReferenceResolver = (() => {
 		* Nothing else is attempted. Folding a title from a log costs the whole
 		* log, and this call sits under every keystroke of `@` completion. A
 		* session that no projection can answer for — one persisted before the
-		* cache was composed, or seeded straight to disk — is labeled by its id
-		* and cannot be found by its title until it is opened once, which
-		* checkpoints it.
+		* cache was composed — is labeled by its id and cannot be found by its
+		* title until it is opened once, which checkpoints it.
 		* @param record - the listed session, live or cold.
-		* @returns the projected title, or undefined when no projection holds one.
+		* @returns the title-backed mention label and the subagent-label-first display title.
 		*/
-		projectedTitle(record) {
+		projectedLabels(record) {
 			const attached = this.ctx.get("sessions")?.get(record.header.id);
 			const projections = this.ctx.get("sessionProjections");
-			if (attached !== void 0 && projections !== void 0) return titleOf(projections.snapshot(attached, ["title"]));
-			if (record.header.isSeeded) return void 0;
-			return titleOf(this.ctx.get("sessionProjectionCache")?.cachedSnapshot(record.header, SessionLogOffset(0), ["title"]));
+			const snapshot = attached !== void 0 && projections !== void 0 ? projections.snapshot(attached, ["title", "subagent"]) : this.ctx.get("sessionProjectionCache")?.cachedSnapshot(record.header, ["title", "subagent"]);
+			const label = titleOf(snapshot) ?? record.header.id;
+			const subagent = snapshot?.values.subagent;
+			return {
+				label,
+				displayTitle: subagent === void 0 || subagent === null ? label : subagent.label ?? label
+			};
 		}
 		/**
 		* Remote face of {@link listCandidates}: the configured candidate limit
@@ -583,7 +587,7 @@ let SessionReferenceResolver = (() => {
 				...candidate,
 				mention: formatSessionReferenceMention({
 					sessionId: candidate.sessionId,
-					label: candidate.label
+					label: candidate.displayTitle ?? candidate.label
 				})
 			}));
 		}

package/lib/typert.host.js

@@ -1,16 +1,20 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema = z.string()
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema = z.array(z.object({
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema$value ??= z.string())
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema$value ??= z.array(z.object({
   'mention': z.string(),
   'sessionId': z.intersection(z.string(), z.unknown()),
   'label': z.string(),
+  'displayTitle': z.string().optional(),
   'cwd': z.string().optional(),
   'sameWorkspace': z.boolean(),
   'createdAt': z.number(),
-}))
+})))
 
 export const TYPERT = {
   package: '@deepseek-ai/dsh-session-reference',
@@ -38,7 +42,7 @@ export const TYPERT = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema,
+            create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema,
           },
         },
         {
@@ -48,7 +52,7 @@ export const TYPERT = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates:query',
-            schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema,
+            create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema,
           },
         },
       ],
@@ -56,9 +60,9 @@ export const TYPERT = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates:result',
-        schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema,
+        create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema,
       },
-      sourceLocation: {"file":"packages/context/session-reference/src/index.ts","line":274,"column":9},
+      sourceLocation: {"file":"packages/context/session-reference/src/index.ts","line":272,"column":9},
     },
   ],
   model: {
@@ -76,7 +80,7 @@ export const TYPERT = {
             "name": "listCandidates",
             "signature": "async listCandidates( agent: Agent, query: string = '', limit: number = this.config.candidateLimit, signal?: AbortSignal, ): Promise<SessionReferenceCandidate[]>",
             "summary": "List reference candidates, ranked by working-directory affinity.",
-            "jsDoc": "/**\n * List reference candidates, ranked by working-directory affinity.\n *\n * Discovery runs at keystroke rate, so a title only ever comes from a\n * projection read: see {@link SessionReferenceResolver.projectedTitle} for\n * which sessions can answer one and which fall back to their id.\n * @param agent - target agent; self is excluded and its cwd drives ranking.\n * @param query - optional case-insensitive session-id/cwd/title substring.\n * @param limit - optional positive result cap.\n * @param signal - optional cancellation boundary for host autocomplete teardown.\n * @returns candidates labeled by latest title or, when absent, session id.\n */"
+            "jsDoc": "/**\n * List reference candidates, ranked by working-directory affinity.\n *\n * Discovery runs at keystroke rate, so titles and subagent labels only ever\n * come from projection reads; sessions without either fall back to their id.\n * @param agent - target agent; self is excluded and its cwd drives ranking.\n * @param query - optional case-insensitive session-id/cwd/title/display-title substring.\n * @param limit - optional positive result cap.\n * @param signal - optional cancellation boundary for host autocomplete teardown.\n * @returns candidates with canonical mention labels and presentation titles.\n */"
           },
           {
             "kind": "method",
@@ -128,7 +132,7 @@ export const TYPERT = {
           },
           {
             "name": "AssistantMessage",
-            "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
+            "declaration": "export interface AssistantMessage extends MessageBase {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
           },
           {
             "name": "AssistantProviderMetadata",
@@ -166,6 +170,10 @@ export const TYPERT = {
             "name": "CommandSourceMap",
             "declaration": "export interface CommandSourceMap {\n    user: { kind: 'user'; };\n}"
           },
+          {
+            "name": "CompactionCheckpointSource",
+            "declaration": "export type CompactionCheckpointSource = typeof COMPACT_CHECKPOINT_MARKER & { readonly compactionId: CompactionId; readonly sourceCommandId?: CommandId; };"
+          },
           {
             "name": "CompactionId",
             "declaration": "export type CompactionId = Branded<'CompactionId'>;"
@@ -176,7 +184,7 @@ export const TYPERT = {
           },
           {
             "name": "ContentBlockMap",
-            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
+            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-addition': ToolAdditionBlock;\n    'tool-removal': ToolRemovalBlock;\n}"
           },
           {
             "name": "ContentBlockType",
@@ -194,9 +202,13 @@ export const TYPERT = {
             "name": "ContinuableSubagentDescriptorData",
             "declaration": "export interface ContinuableSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: 'continuable';\n    readonly label: string;\n    readonly agentProvider?: string;\n    readonly agentModel?: string;\n    readonly agentReasoningEffort?: ReasoningEffortId;\n    readonly persona?: string;\n    readonly toolFilter?: ToolRestriction;\n}"
           },
+          {
+            "name": "DeveloperMessage",
+            "declaration": "export interface DeveloperMessage extends MessageBase {\n    readonly role: 'developer';\n}"
+          },
           {
             "name": "EpochHeader",
-            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n}"
+            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n    system?: never;\n}"
           },
           {
             "name": "FeedbackCategory",
@@ -290,6 +302,10 @@ export const TYPERT = {
             "name": "JsonValue",
             "declaration": "export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue; };"
           },
+          {
+            "name": "KnownCatalogMode",
+            "declaration": "export type KnownCatalogMode = { readonly mode: 'one-shot'; readonly label?: string; } | { readonly mode: 'continuable'; readonly label: string; };"
+          },
           {
             "name": "LlmCallConfig",
             "declaration": "export interface LlmCallConfig {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}"
@@ -304,7 +320,11 @@ export const TYPERT = {
           },
           {
             "name": "Message",
-            "declaration": "export interface Message {\n    readonly id: MessageId;\n    readonly role: 'system' | 'user' | 'assistant';\n    readonly content: ContentBlock[];\n    readonly source: MessageSource;\n}"
+            "declaration": "export type Message = MessageRoleMap[keyof MessageRoleMap];"
+          },
+          {
+            "name": "MessageBase",
+            "declaration": "export interface MessageBase {\n    readonly id: MessageId;\n    readonly content: readonly ContentBlock[];\n    readonly source: MessageSource;\n}"
           },
           {
             "name": "MessageFeedbackDelete",
@@ -330,13 +350,17 @@ export const TYPERT = {
             "name": "MessageId",
             "declaration": "export type MessageId = Branded<'MessageId'>;"
           },
+          {
+            "name": "MessageRoleMap",
+            "declaration": "export interface MessageRoleMap {\n    system: SystemMessage;\n    developer: DeveloperMessage;\n    user: UserMessage;\n    assistant: AssistantMessage;\n    tool: ToolResultMessage;\n}"
+          },
           {
             "name": "MessageSource",
             "declaration": "export type MessageSource = MessageSourceMap[keyof MessageSourceMap];"
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -396,7 +420,7 @@ export const TYPERT = {
           },
           {
             "name": "Session",
-            "declaration": "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
+            "declaration": "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    readonly firstLifecycleSeq: SessionLogOffset;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
           },
           {
             "name": "SessionEvent",
@@ -404,7 +428,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; 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}"
+            "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    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\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",
@@ -424,7 +448,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionReferenceCandidate",
-            "declaration": "export interface SessionReferenceCandidate {\n    sessionId: SessionId;\n    label: string;\n    cwd?: string;\n    sameWorkspace: boolean;\n    createdAt: number;\n}"
+            "declaration": "export interface SessionReferenceCandidate {\n    sessionId: SessionId;\n    label: string;\n    displayTitle?: string;\n    cwd?: string;\n    sameWorkspace: boolean;\n    createdAt: number;\n}"
           },
           {
             "name": "SessionReferenceInput",
@@ -476,7 +500,7 @@ export const TYPERT = {
           },
           {
             "name": "SubagentCatalogEvent",
-            "declaration": "export type SubagentCatalogEvent = { readonly version: 0; readonly childId: SessionId; readonly childCreatedAt: number; } & ({ readonly mode: 'one-shot'; readonly label?: string; } | { readonly mode: 'continuable'; readonly label: string; });"
+            "declaration": "export type SubagentCatalogEvent = { readonly childId: SessionId; readonly childCreatedAt: number; } & (({ readonly version: 0; } & KnownCatalogMode) | ({ readonly version: 1; } & (KnownCatalogMode | { readonly mode: 'unknown'; readonly label?: string; })));"
           },
           {
             "name": "SubagentDescriptorBase",
@@ -492,7 +516,7 @@ export const TYPERT = {
           },
           {
             "name": "SurfaceEventType",
-            "declaration": "export type SurfaceEventType = 'system/message' | 'user/message' | 'assistant/message' | 'tool/result';"
+            "declaration": "export type SurfaceEventType = 'system/message' | 'developer/message' | 'user/message' | 'assistant/message' | 'tool/result';"
           },
           {
             "name": "SurfaceIntent",
@@ -504,7 +528,11 @@ export const TYPERT = {
           },
           {
             "name": "SystemMessage",
-            "declaration": "export interface SystemMessage extends Message {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['plugin'];\n}"
+            "declaration": "export interface SystemMessage extends MessageBase {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['system-prompt'];\n}"
+          },
+          {
+            "name": "SystemPromptMessageSource",
+            "declaration": "export interface SystemPromptMessageSource {\n    kind: 'system-prompt';\n}"
           },
           {
             "name": "SystemPromptUpdate",
@@ -558,6 +586,10 @@ export const TYPERT = {
             "name": "TokenUsage",
             "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: number;\n    totalTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    reasoningTokens?: number;\n}"
           },
+          {
+            "name": "ToolAdditionBlock",
+            "declaration": "export interface ToolAdditionBlock {\n    type: 'tool-addition';\n    toolName: string;\n    tool?: never;\n}"
+          },
           {
             "name": "ToolCallBlock",
             "declaration": "export interface ToolCallBlock {\n    type: 'tool-call';\n    id: ToolCallId;\n    name: string;\n    arguments: string;\n}"
@@ -571,20 +603,20 @@ export const TYPERT = {
             "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: ToolCallId;\n}"
           },
           {
-            "name": "ToolRestriction",
-            "declaration": "export interface ToolRestriction {\n    readonly allow?: readonly string[];\n    readonly deny?: readonly string[];\n}"
+            "name": "ToolRemovalBlock",
+            "declaration": "export interface ToolRemovalBlock {\n    type: 'tool-removal';\n    toolName: string;\n}"
           },
           {
-            "name": "ToolResultBlock",
-            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: ToolCallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
+            "name": "ToolRestriction",
+            "declaration": "export interface ToolRestriction {\n    readonly allow?: readonly string[];\n    readonly deny?: readonly string[];\n}"
           },
           {
             "name": "ToolResultMessage",
-            "declaration": "export interface ToolResultMessage extends Message {\n    readonly role: 'user';\n    readonly content: [ToolResultBlock];\n    readonly source: ToolMessageSource;\n}"
+            "declaration": "export interface ToolResultMessage extends MessageBase {\n    readonly role: 'tool';\n    readonly source: ToolMessageSource;\n    readonly toolCallId: ToolCallId;\n    readonly isError?: boolean;\n}"
           },
           {
             "name": "ToolSchema",
-            "declaration": "export interface ToolSchema {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
+            "declaration": "export interface ToolSchema {\n    deferLoading?: true;\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
           },
           {
             "name": "TurnEndCancelCause",
@@ -596,11 +628,11 @@ export const TYPERT = {
           },
           {
             "name": "TurnEndReasonMap",
-            "declaration": "export interface TurnEndReasonMap {\n    completed: { kind: 'completed'; };\n    aborted: { kind: 'aborted'; reason: TurnEndCancelCause; };\n    blocked: { kind: 'blocked'; };\n    error: { kind: 'error'; error: LlmFailure; };\n    'max-tokens': { kind: 'max-tokens'; };\n    interrupted: { kind: 'interrupted'; };\n}"
+            "declaration": "export interface TurnEndReasonMap {\n    completed: { kind: 'completed'; };\n    aborted: { kind: 'aborted'; reason: TurnEndCancelCause; };\n    blocked: { kind: 'blocked'; };\n    error: { kind: 'error'; error: LlmFailure; };\n    'max-tokens': { kind: 'max-tokens'; };\n    interrupted: { kind: 'interrupted'; };\n    forked: { kind: 'forked'; };\n}"
           },
           {
             "name": "UserMessage",
-            "declaration": "export interface UserMessage extends Message {\n    readonly role: 'user';\n}"
+            "declaration": "export interface UserMessage extends MessageBase {\n    readonly role: 'user';\n}"
           }
         ]
       }

package/lib/typert.remote-client.js

@@ -1,16 +1,20 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema = z.string()
-const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema = z.array(z.object({
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema$value ??= z.string())
+let _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema$value
+const _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema = () => (_deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema$value ??= z.array(z.object({
   'mention': z.string(),
   'sessionId': z.intersection(z.string(), z.unknown()),
   'label': z.string(),
+  'displayTitle': z.string().optional(),
   'cwd': z.string().optional(),
   'sameWorkspace': z.boolean(),
   'createdAt': z.number(),
-}))
+})))
 
 export const TYPERT_REMOTE = {
   package: '@deepseek-ai/dsh-session-reference',
@@ -35,7 +39,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema,
+            create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_0$schema,
           },
         },
         {
@@ -45,7 +49,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates:query',
-            schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema,
+            create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_parameter_1$schema,
           },
         },
       ],
@@ -53,9 +57,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates:result',
-        schema: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema,
+        create: _deepseek_ai_dsh_session_reference_sessionReferenceResolver_candidates_result$schema,
       },
-      sourceLocation: {"file":"packages/context/session-reference/src/index.ts","line":274,"column":9},
+      sourceLocation: {"file":"packages/context/session-reference/src/index.ts","line":272,"column":9},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -39,18 +39,17 @@ export declare class SessionReferenceResolver extends TypertRemoteService {
     /**
      * List reference candidates, ranked by working-directory affinity.
      *
-     * Discovery runs at keystroke rate, so a title only ever comes from a
-     * projection read: see {@link SessionReferenceResolver.projectedTitle} for
-     * which sessions can answer one and which fall back to their id.
+     * Discovery runs at keystroke rate, so titles and subagent labels only ever
+     * come from projection reads; sessions without either fall back to their id.
      * @param agent - target agent; self is excluded and its cwd drives ranking.
-     * @param query - optional case-insensitive session-id/cwd/title substring.
+     * @param query - optional case-insensitive session-id/cwd/title/display-title substring.
      * @param limit - optional positive result cap.
      * @param signal - optional cancellation boundary for host autocomplete teardown.
-     * @returns candidates labeled by latest title or, when absent, session id.
+     * @returns candidates with canonical mention labels and presentation titles.
      */
     listCandidates(agent: Agent, query?: string, limit?: number, signal?: AbortSignal): Promise<SessionReferenceCandidate[]>;
     /**
-     * The title a session's projections can answer without reading its log.
+     * The mention label and display title a Session's projections can answer without reading its log.
      *
      * Attachment is decided by the store at read time, not by the listing:
      * a session that attached in between would otherwise be answered from a
@@ -65,13 +64,12 @@ export declare class SessionReferenceResolver extends TypertRemoteService {
      * Nothing else is attempted. Folding a title from a log costs the whole
      * log, and this call sits under every keystroke of `@` completion. A
      * session that no projection can answer for — one persisted before the
-     * cache was composed, or seeded straight to disk — is labeled by its id
-     * and cannot be found by its title until it is opened once, which
-     * checkpoints it.
+     * cache was composed — is labeled by its id and cannot be found by its
+     * title until it is opened once, which checkpoints it.
      * @param record - the listed session, live or cold.
-     * @returns the projected title, or undefined when no projection holds one.
+     * @returns the title-backed mention label and the subagent-label-first display title.
      */
-    private projectedTitle;
+    private projectedLabels;
     /**
      * Remote face of {@link listCandidates}: the configured candidate limit
      * applies, and every candidate carries the canonical mention a host inserts

package/lib/types/index.js

@@ -41,7 +41,6 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
 import z from '@deepseek-ai/schemastery';
 import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import { createUserMessage, freezeMessage, LlmError } from '@deepseek-ai/dsh-llm';
-import { SessionLogOffset } from '@deepseek-ai/dsh-session';
 import { prepareReferenceOmission, REFERENCE_WARNING } from "./spill.js";
 import { DEFAULT_CANDIDATE_LIMIT, DEFAULT_MAX_REFERENCE_BYTES, MAX_REFERENCES, SessionReferenceError, } from "./config.js";
 import { retainReferencedSession } from "./projection.js";
@@ -153,14 +152,13 @@ let SessionReferenceResolver = (() => {
         /**
          * List reference candidates, ranked by working-directory affinity.
          *
-         * Discovery runs at keystroke rate, so a title only ever comes from a
-         * projection read: see {@link SessionReferenceResolver.projectedTitle} for
-         * which sessions can answer one and which fall back to their id.
+         * Discovery runs at keystroke rate, so titles and subagent labels only ever
+         * come from projection reads; sessions without either fall back to their id.
          * @param agent - target agent; self is excluded and its cwd drives ranking.
-         * @param query - optional case-insensitive session-id/cwd/title substring.
+         * @param query - optional case-insensitive session-id/cwd/title/display-title substring.
          * @param limit - optional positive result cap.
          * @param signal - optional cancellation boundary for host autocomplete teardown.
-         * @returns candidates labeled by latest title or, when absent, session id.
+         * @returns candidates with canonical mention labels and presentation titles.
          */
         async listCandidates(agent, query = '', limit = this.config.candidateLimit, signal) {
             if (!Number.isSafeInteger(limit) || limit <= 0) {
@@ -172,30 +170,28 @@ let SessionReferenceResolver = (() => {
             const records = (await settleWithCancellation(this.ctx.sessionQuery.listSessions(signal), signal))
                 .filter(record => record.header.id !== agent.id)
                 .map((record, index) => ({ record, index }));
-            const labelled = records.map(({ record, index }) => ({
-                record,
-                index,
-                label: this.projectedTitle(record) ?? record.header.id,
-            }));
-            return labelled.filter(({ record, label }) => {
+            const labelled = records.map(({ record, index }) => ({ record, index, ...this.projectedLabels(record) }));
+            return labelled.filter(({ record, label, displayTitle }) => {
                 if (needle === '')
                     return true;
                 return record.header.id.toLocaleLowerCase().includes(needle)
                     || record.header.cwd?.toLocaleLowerCase().includes(needle) === true
-                    || label.toLocaleLowerCase().includes(needle);
+                    || label.toLocaleLowerCase().includes(needle)
+                    || displayTitle.toLocaleLowerCase().includes(needle);
             }).sort((a, b) => candidateRank(a.record.header.cwd, targetCwd) - candidateRank(b.record.header.cwd, targetCwd)
                 || a.index - b.index)
                 .slice(0, limit)
-                .map(({ record, label }) => ({
+                .map(({ record, label, displayTitle }) => ({
                 sessionId: record.header.id,
                 label,
+                displayTitle,
                 ...record.header.cwd === undefined ? {} : { cwd: record.header.cwd },
                 sameWorkspace: record.header.cwd !== undefined && record.header.cwd === targetCwd,
                 createdAt: record.header.createdAt,
             }));
         }
         /**
-         * The title a session's projections can answer without reading its log.
+         * The mention label and display title a Session's projections can answer without reading its log.
          *
          * Attachment is decided by the store at read time, not by the listing:
          * a session that attached in between would otherwise be answered from a
@@ -210,21 +206,25 @@ let SessionReferenceResolver = (() => {
          * Nothing else is attempted. Folding a title from a log costs the whole
          * log, and this call sits under every keystroke of `@` completion. A
          * session that no projection can answer for — one persisted before the
-         * cache was composed, or seeded straight to disk — is labeled by its id
-         * and cannot be found by its title until it is opened once, which
-         * checkpoints it.
+         * cache was composed — is labeled by its id and cannot be found by its
+         * title until it is opened once, which checkpoints it.
          * @param record - the listed session, live or cold.
-         * @returns the projected title, or undefined when no projection holds one.
+         * @returns the title-backed mention label and the subagent-label-first display title.
          */
-        projectedTitle(record) {
+        projectedLabels(record) {
             const attached = this.ctx.get('sessions')?.get(record.header.id);
             const projections = this.ctx.get('sessionProjections');
-            if (attached !== undefined && projections !== undefined) {
-                return titleOf(projections.snapshot(attached, ['title']));
-            }
-            if (record.header.isSeeded)
-                return undefined;
-            return titleOf(this.ctx.get('sessionProjectionCache')?.cachedSnapshot(record.header, SessionLogOffset(0), ['title']));
+            const snapshot = attached !== undefined && projections !== undefined
+                ? projections.snapshot(attached, ['title', 'subagent'])
+                : this.ctx.get('sessionProjectionCache')?.cachedSnapshot(record.header, ['title', 'subagent']);
+            const label = titleOf(snapshot) ?? record.header.id;
+            const subagent = snapshot?.values.subagent;
+            return {
+                label,
+                displayTitle: subagent === undefined || subagent === null
+                    ? label
+                    : subagent.label ?? label,
+            };
         }
         /**
          * Remote face of {@link listCandidates}: the configured candidate limit
@@ -239,7 +239,10 @@ let SessionReferenceResolver = (() => {
             const candidates = await this.listCandidates(agent, query, this.config.candidateLimit, signal);
             return candidates.map(candidate => ({
                 ...candidate,
-                mention: formatSessionReferenceMention({ sessionId: candidate.sessionId, label: candidate.label }),
+                mention: formatSessionReferenceMention({
+                    sessionId: candidate.sessionId,
+                    label: candidate.displayTitle ?? candidate.label,
+                }),
             }));
         }
         /**

package/lib/types/projection.js

@@ -24,6 +24,7 @@ function projectSessionConversation(snapshot) {
                     conversation.push({ role: 'assistant', text, checkpoint: false, originalText: text, omittedBytes: 0 });
                 break;
             }
+            case 'developer/message':
             case 'system/message':
             case 'tool/result':
                 break;

package/lib/types/types.d.ts

@@ -46,6 +46,8 @@ export interface SessionReferenceCandidate {
     sessionId: SessionId;
     /** Latest log-backed title, falling back to the opaque session id. */
     label: string;
+    /** Display and canonical-mention text, preferring a subagent's durable creation label over {@link label}. */
+    displayTitle?: string;
     /** Source session working directory, when recorded. */
     cwd?: string;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-reference",
   "description": "Cross-session snapshot references and durable untrusted model context (ctx.sessionReferenceResolver)",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -45,24 +45,25 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.1",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.7-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-output-retention": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-compaction": "^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-typert-protocol": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-spill": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-output-retention": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-spill": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-alpha.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-spill": {
@@ -73,25 +74,26 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/cordis-plugin-include": "^1.0.7",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-compaction": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-output-retention": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-fs-local": "^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-query-sqlite": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-spill": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-spill-local": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tool-fs": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1"
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/cordis-plugin-include": "^1.0.8",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.4",
+    "@deepseek-ai/dsh-compaction": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-fs-local": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-output-retention": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-query-sqlite": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-spill": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-spill-local": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-tool-fs": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1"
   }
 }