@deepseek-ai/dsh-session-title 0.1.5-rc.2 → 0.1.6-alpha.2

package/README.i18n.yaml

@@ -3,4 +3,4 @@
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/session/session-title/README.md
 README.md: 09778e4e2b1cf1e6e6e4dc20dbe9237a4a0cc51f
-README.zh.md: 3e5bf34273a85747e0b5624df99c3815a134f937
+README.zh.md: db9efaa2ab0a226fb318b9b564d72f6f7e56be12

package/README.zh.md

@@ -1,5 +1,5 @@
 ---
-description: "面向用户与维护者的日志会话标题说明，用于选择标题来源、配置服务或排查标题状态。"
+description: "面向用户与维护者的日志支持型会话标题说明，用于选择标题来源、配置服务或排查标题状态。"
 kind: "package-reference"
 ---
 
@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-使用 `dsh-session-title` 为每个会话提供客户端可见标题，标题可以来自第一条符合条件的用户消息、可选异步生成器或显式用户重命名。已接受的标题在回放、恢复与分页后仍然存在，但绝不会进入模型输入。自动生成绝不会延迟主 agent 响应，较新的标题请求会取代旧工作。当客户端需要带可配置长度上限的持久标题，以及通过 `refresh()` 主动重新生成标题的路径时，请选择本包。
+使用 `dsh-session-title` 为每个会话提供客户端可见标题，标题可以来自第一条符合条件的用户消息、可选异步生成器或显式用户重命名。已接受的标题在回放、恢复与分页后仍然存在，但绝不会进入模型输入。自动生成绝不会延迟主 agent（智能体）响应，较新的标题请求会取代旧工作。当客户端需要带可配置长度上限的持久标题，以及通过 `refresh()` 主动重新生成标题的路径时，请选择本包。
 
 ## 目录
 
@@ -54,7 +54,7 @@ kind: "package-reference"
 
 ### 添加提供方
 
-可选异步提供方可通过 `ctx.sessionTitle.register(provider)` 注册一个；第二次注册会立即抛出。随附的模型支持提供方是[首消息](../session-title-first-prompt-llm/README.zh.md)与[全消息](../session-title-all-prompts-llm/README.zh.md)，两者都使用共享的 [LLM 生成策略](../session-title-llm/README.zh.md)。提供方只有在带标记、由循环构建的请求的确切路由与已记录 `request/header` 匹配时才启动，较新的修订会取代并中止旧工作。
+可选异步提供方可通过 `ctx.sessionTitle.register(provider)` 注册一个；第二次注册会立即抛出。随附的模型支持提供方是[首消息](../session-title-first-prompt-llm/README.zh.md)与[全消息](../session-title-all-prompts-llm/README.zh.md)，两者都使用共享的 [LLM（大语言模型）生成策略](../session-title-llm/README.zh.md)。提供方只有在带标记、由循环构建的请求的确切路由与已记录 `request/header` 匹配时才启动，较新的修订会取代并中止旧工作。
 
 ### 读取标题
 
@@ -84,7 +84,7 @@ kind: "package-reference"
 |---|---|
 | [`src/index.ts`](src/index.ts) | 服务：配置、折叠、回退调度、提供方注册表、并发、`title` 投影单元 |
 | [`src/normalize.ts`](src/normalize.ts) | 标题文本清洗、UTF-8 安全截断与确定性回退 |
-| [`src/types.ts`](src/types.ts) | `title` 投影键声明的唯一归属 |
+| [`src/types.ts`](src/types.ts) | `title` 投影键声明的归属位置 |
 
 ### 生命周期与并发
 

package/lib/types/index.d.ts

@@ -8,8 +8,8 @@ import { z as zod } from 'zod';
 import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
 import { SessionSeq } from '@deepseek-ai/dsh-session';
-export type { SessionTitleEventData, SessionTitleModelProvenance, SessionTitleSnapshot, SessionTitleSource, SessionTitleUserMessage, TitleProjection, } from './types.ts';
-import type { SessionTitleEventData, SessionTitleModelProvenance, SessionTitleSnapshot, SessionTitleUserMessage } from './types.ts';
+export type { SessionTitleEventData, SessionTitleModelIdentity, SessionTitleSnapshot, SessionTitleSource, SessionTitleUserMessage, TitleProjection, } from './types.ts';
+import type { SessionTitleEventData, SessionTitleModelIdentity, SessionTitleSnapshot, SessionTitleUserMessage } from './types.ts';
 /** Identifies one session-title provider registration. */
 export type SessionTitleProviderId = Branded<'SessionTitleProviderId'>;
 /**
@@ -60,7 +60,7 @@ export interface SessionTitleProviderRequest {
     /** All eligible human messages through this generation revision. */
     readonly messages: readonly SessionTitleUserMessage[];
     /** Exact current logged main-request route, when one has been recorded. */
-    readonly route?: SessionTitleModelProvenance;
+    readonly route?: SessionTitleModelIdentity;
     /** Cancellation for supersession, disposal, timeout composition, or the explicit caller. */
     readonly signal: AbortSignal;
 }
@@ -71,7 +71,7 @@ export interface SessionTitleProviderResult {
     /** Exact seqs from `request.messages` used by this result. */
     readonly messageSeqs: readonly SessionSeq[];
     /** Auxiliary LLM route, when generation used a model. */
-    readonly model?: SessionTitleModelProvenance;
+    readonly model?: SessionTitleModelIdentity;
 }
 /** One optional asynchronous title implementation registered with the service. */
 export interface SessionTitleProvider {

package/lib/types/index.js

@@ -236,6 +236,7 @@ export class SessionTitleService extends Service {
      * @returns latest title snapshot, or `undefined` before eligible input.
      */
     get(session) {
+        // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
         return foldSessionTitle(session.snapshotEvents());
     }
     /**
@@ -440,6 +441,7 @@ export class SessionTitleService extends Service {
             this.assertCurrent(session, work);
             await this.ensureFallback(session);
             this.assertCurrent(session, work);
+            // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
             const messages = collectSessionTitleMessages(session.snapshotEvents(), work.throughSeq);
             const result = await work.registration.provider.generate({
                 session,

package/lib/types/invariant.js

@@ -35,6 +35,7 @@ function validate(session, event, fail) {
             fail(`session/title event ${String(event.seq)} repeats message seq ${checked}`);
         }
         seen.add(checked);
+        // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
         const cited = checked < event.seq ? session.eventAt(checked) : undefined;
         if (cited?.type !== 'user/message' || cited.data.source.kind !== 'user') {
             fail(`session/title event ${String(event.seq)} message seq ${checked} must name an earlier human user/message`);
@@ -43,6 +44,7 @@ function validate(session, event, fail) {
 }
 const install = Object.assign((ctx, fail) => {
     const validateExisting = (session) => {
+        // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
         for (const event of session.snapshotEvents()) {
             if (event.type === 'session/title')
                 validate(session, event, fail);

package/lib/types/types.d.ts

@@ -13,7 +13,7 @@ import type { OptionalSessionSeq, SessionSeq } from '@deepseek-ai/dsh-session/ty
 /** Identifies one session-title provider registration. */
 export type SessionTitleProviderId = Branded<'SessionTitleProviderId'>;
 /** Exact auxiliary model route that produced a title. */
-export interface SessionTitleModelProvenance {
+export interface SessionTitleModelIdentity {
     /** Registered LLM provider route. */
     readonly provider: string;
     /** Provider model id. */
@@ -25,7 +25,7 @@ export type SessionTitleSource = {
 } | {
     readonly kind: 'provider';
     readonly provider: SessionTitleProviderId;
-    readonly model?: SessionTitleModelProvenance;
+    readonly model?: SessionTitleModelIdentity;
 } | {
     /** Explicit user rename: pins the title — automatic generation stops scheduling. */
     readonly kind: 'user';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-title",
   "description": "Log-backed session title service and provider registry for the DeepSeek Harness",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -42,27 +42,27 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2"
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2"
   }
 }