@deepseek-ai/dsh-session-title 0.0.1-rc.2 → 0.0.1-rc.3

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/session/session-title/README.md
-README.md: e7004eb2e03757cb28b4b5756a876e1dee4b6229
-README.zh.md: 45c1aafdf214f63ae7a071d2558eaefec13ea70f
+README.md: e923bd9700180214f235c4971d4b020565bfee43
+README.zh.md: 8e84ac27d9f1509c8530b838eeb5eb2216d87199

package/README.md

@@ -15,7 +15,7 @@ Only text blocks from human `user/message` events are eligible. The first eligib
 
 Automatic work never delays the main agent response. A provider starts only after a marked loop-built request's exact route matches the current logged `request/header`, including when the unchanged header needs no new snapshot. Its late completion appends a standalone log-only event directly through `Session` without opening a turn. Persistence observes that event eagerly and drains on ordinary lifecycle checkpoints; title publication itself does not force a flush. Automatic failures warn and retain the latest title. New all-message revisions, provider disposal, session disposal, and explicit refresh abort older work, and a stale completion cannot append. Concurrent explicit refreshes reserve their revision before provider work, while overlapping automatic and explicit fallback requests share one session-local in-flight append. The service and bundled model provider each append their own literal event type, so no generic title-write marker, cast, or settlement queue is needed. Service teardown cancels queued work and drains calls that ignore cancellation before unloading completes.
 
-Forks inherit title events in their seed unchanged. The first-message cadence does not automatically retitle a child; the all-messages cadence may append a new revision after the child receives a later human prompt.
+Forks inherit title events in their seed unchanged. The first-prompt cadence does not automatically retitle a child; the all-messages cadence may append a new revision after the child receives a later human prompt.
 
 ## Configuration
 
@@ -29,7 +29,7 @@ All limits are required; the library supplies no defaults.
 
 ## Provider contract
 
-A provider supplies a branded stable id, automatic mode (`first-message` or `all-user-messages`), and `generate(request)`. The request carries the live session, all eligible messages through one fixed revision, the current logged main-request route when available, and cancellation. The result identifies a non-empty title, unique ordered source-message seqs from that request, and the optional provider/model route used to generate it. The service normalizes and validates the result before it becomes durable.
+A provider supplies a branded stable id, automatic mode (`first-prompt` or `all-prompts`), and `generate(request)`. The request carries the live session, all eligible messages through one fixed revision, the current logged main-request route when available, and cancellation. The result identifies a non-empty title, unique ordered source-message seqs from that request, and the optional provider/model route used to generate it. The service normalizes and validates the result before it becomes durable.
 
 See the [session-title data structures](../../../docs/subsystems/session-title.md) and [implemented decision](../../../.agents/notes/implemented/feature/2026-07-21-log-backed-session-titles.md).
 

package/README.zh.md

@@ -10,12 +10,12 @@
 
 - `get(session)` 从活跃或回放日志折叠最新已接受标题。
 - `refresh(session, signal?)` 在需要时物化回退，然后显式运行已注册提供方，处理当前符合条件的消息。提供方错误或调用方取消都会导致返回的 Promise 被拒绝；取消不会回滚已接受的回退事件。
-- `rename(session, title)` 同步接受用户显式标题：规范化文本、取代在途自动工作，并追加一条 `user` 来源的 `session/title` 事件。最新标题来源为 user 即钉住该会话——后续用户消息不再安排自动 revision；显式 `refresh` 仍是有意的解钉手段。
+- `rename(session, title)` 同步接受用户显式标题：规范化文本、取代在途自动工作，并追加一条 `user` 来源的 `session/title` 事件。用户来源的最新标题会钉住该会话——后续用户消息不再安排自动修订；显式 `refresh` 仍是有意的解钉手段。
 - `register(provider)` 安装唯一可选提供方，并返回可等待的 Cordis effect disposer。第二次注册会立即抛出；对提供方执行 dispose（资源释放）会中止待处理和活跃调用，等待其结算，之后才允许注册另一个提供方。
 
 自动工作绝不会延迟主 agent（智能体）响应。只有当带标记、由循环构建的请求，其确切路由与当前已记录的 `request/header` 匹配时，提供方才会启动；即使请求头未变而无需新快照，也适用此规则。延迟完成会直接通过 `Session` 追加一个独立的纯日志事件，而不打开轮次。持久化会立即观察到该事件，并在常规生命周期检查点完成刷写；标题发布本身不会强制刷写。自动失败会发出警告并保留最新标题。新的全消息修订、提供方 dispose、会话 dispose 和显式刷新都会中止旧工作，陈旧的完成结果无法追加。并发显式刷新会在提供方工作之前预留修订号；重叠的自动／显式回退请求共享一个会话本地正在进行的追加操作。服务与内置模型提供方各自追加自己的字面事件类型，因此不需要通用标题写入标记、类型断言或结算队列。服务拆卸会取消排队工作，并在卸载完成前等待不响应取消的调用结算完成。
 
-Fork 出的会话会原样继承种子中的标题事件。首消息节奏不会自动为子会话重新生成标题；全消息节奏可以在子会话收到后续用户提示词后追加新修订。
+fork 出的会话会原样继承种子中的标题事件。首消息节奏不会自动为子会话重新生成标题；全消息节奏可以在子会话收到后续用户提示词后追加新修订。
 
 ## 配置
 
@@ -29,7 +29,7 @@ Fork 出的会话会原样继承种子中的标题事件。首消息节奏不会
 
 ## 提供方约定
 
-提供方会提供带品牌类型的稳定 id、自动模式（`first-message` 或 `all-user-messages`）和 `generate(request)`。请求携带活跃会话、截至一次固定修订的所有符合条件消息、可用时当前已记录的主请求路由，以及取消信号。结果包含非空标题、该请求中唯一且有序的来源消息 seq，以及生成该标题时使用的可选提供方／模型路由。服务会在结果持久保存前进行规范化和验证。
+提供方会提供带品牌类型的稳定 id、自动模式（`first-prompt` 或 `all-prompts`）和 `generate(request)`。请求携带活跃会话、截至一次固定修订的所有符合条件消息、可用时当前已记录的主请求路由，以及取消信号。结果包含非空标题、该请求中互不重复且有序的来源消息 seq，以及生成该标题时使用的可选提供方／模型路由。服务会在结果持久保存前进行规范化和验证。
 
 参见[会话标题数据结构](../../../docs/subsystems/session-title.md)与[已实现决策](../../../.agents/notes/implemented/feature/2026-07-21-log-backed-session-titles.md)。
 

package/lib/index.js

@@ -51,7 +51,7 @@ function normalizeSessionTitle(input, maxBytes) {
 	return truncateTitleUtf8(cleanTitleText(input), maxBytes).trimEnd();
 }
 /**
-* Derive the deterministic first-message fallback.
+* Derive the deterministic first-prompt fallback.
 * @param input - text from the first eligible human message.
 * @param maxWords - positive whitespace-delimited word cap.
 * @param maxBytes - positive UTF-8 byte cap.
@@ -320,7 +320,7 @@ var SessionTitleService = class extends Service {
 		const registration = this.registration;
 		if (registration !== void 0 && !registration.closing) {
 			const messages = collectSessionTitleMessages(session.events, event.seq);
-			if (registration.provider.automatic === "all-user-messages" || session.header.parentSession === void 0 && messages.length === 1 && this.get(session) === void 0) {
+			if (registration.provider.automatic === "all-prompts" || session.header.parentSession === void 0 && messages.length === 1 && this.get(session) === void 0) {
 				const state = this.stateFor(session);
 				state.pending = {
 					registration,
@@ -526,7 +526,7 @@ var SessionTitleService = class extends Service {
 		if (provider === null || typeof provider !== "object") throw new Error("session-title provider must be an object");
 		const candidate = provider;
 		if (typeof candidate.id !== "string" || candidate.id.length === 0) throw new Error("session-title provider id must be a non-empty string");
-		if (candidate.automatic !== "first-message" && candidate.automatic !== "all-user-messages") throw new Error("session-title provider automatic mode is invalid");
+		if (candidate.automatic !== "first-prompt" && candidate.automatic !== "all-prompts") throw new Error("session-title provider automatic mode is invalid");
 		if (typeof candidate.generate !== "function") throw new Error(`session-title provider "${candidate.id}" requires generate()`);
 	}
 	/**

package/lib/types/index.d.ts

@@ -90,7 +90,7 @@ export interface SessionTitleUserMessage {
     readonly text: string;
 }
 /** Automatic generation cadence owned by a registered provider. */
-export type SessionTitleAutomaticMode = 'first-message' | 'all-user-messages';
+export type SessionTitleAutomaticMode = 'first-prompt' | 'all-prompts';
 /** Immutable input supplied to one title-provider call. */
 export interface SessionTitleProviderRequest {
     /** Live session being titled. */

package/lib/types/index.js

@@ -294,7 +294,7 @@ export class SessionTitleService extends Service {
         const registration = this.registration;
         if (registration !== undefined && !registration.closing) {
             const messages = collectSessionTitleMessages(session.events, event.seq);
-            const shouldSchedule = registration.provider.automatic === 'all-user-messages'
+            const shouldSchedule = registration.provider.automatic === 'all-prompts'
                 || (session.header.parentSession === undefined && messages.length === 1 && this.get(session) === undefined);
             if (shouldSchedule) {
                 const state = this.stateFor(session);
@@ -534,7 +534,7 @@ export class SessionTitleService extends Service {
         if (typeof candidate.id !== 'string' || candidate.id.length === 0) {
             throw new Error('session-title provider id must be a non-empty string');
         }
-        if (candidate.automatic !== 'first-message' && candidate.automatic !== 'all-user-messages') {
+        if (candidate.automatic !== 'first-prompt' && candidate.automatic !== 'all-prompts') {
             throw new Error('session-title provider automatic mode is invalid');
         }
         if (typeof candidate.generate !== 'function') {

package/lib/types/normalize.d.ts

@@ -14,7 +14,7 @@ export declare function truncateTitleUtf8(input: string, maxBytes: number): stri
  */
 export declare function normalizeSessionTitle(input: string, maxBytes: number): string;
 /**
- * Derive the deterministic first-message fallback.
+ * Derive the deterministic first-prompt fallback.
  * @param input - text from the first eligible human message.
  * @param maxWords - positive whitespace-delimited word cap.
  * @param maxBytes - positive UTF-8 byte cap.

package/lib/types/normalize.js

@@ -57,7 +57,7 @@ export function normalizeSessionTitle(input, maxBytes) {
     return truncateTitleUtf8(cleanTitleText(input), maxBytes).trimEnd();
 }
 /**
- * Derive the deterministic first-message fallback.
+ * Derive the deterministic first-prompt fallback.
  * @param input - text from the first eligible human message.
  * @param maxWords - positive whitespace-delimited word cap.
  * @param maxBytes - positive UTF-8 byte cap.

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.0.1-rc.2",
+  "version": "0.0.1-rc.3",
   "publishConfig": {
     "access": "restricted"
   },
@@ -41,25 +41,25 @@
   ],
   "license": "BSD-3-Clause",
   "peerDependencies": {
-    "@deepseek-ai/dsh-brand": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.2"
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "dependencies": {
     "zod": "^4.4.3",
     "@deepseek-ai/schemastery": "^3.18.1-rc.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-brand": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session-persistence-sqlite": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-persistence-sqlite": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.3",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   }
 }