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

package/README.i18n.yaml

@@ -24,8 +24,8 @@
   en: f72239b38a91783b
   zh: 07e22375c09906a6
 /deepseek-ai-dsh-session-title/use-this-package/adding-a-provider:
-  en: 2e1e7b56a1f26478
-  zh: 750800b2d9e73595
+  en: cda41e431e48f914
+  zh: c6347ef731b0036e
 /deepseek-ai-dsh-session-title/use-this-package/reading-titles:
   en: 34148c23c20ee6f4
   zh: b0d10677722f3f63
@@ -48,8 +48,8 @@
   en: 0fa22531683cc824
   zh: c6379873eb809e76
 /deepseek-ai-dsh-session-title/further-exploration:
-  en: 8b405b3bb2abf7cd
-  zh: 71e8a58bfae99a36
+  en: 80d2f64367af8bda
+  zh: cfdd94b628fc4d8d
 /deepseek-ai-dsh-session-title/model-experience:
   en: 215e7ba838619b7b
   zh: a311da3843709f90

package/README.md

@@ -54,7 +54,7 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
 
 ### Adding a provider
 
-One optional asynchronous provider may be registered through `ctx.sessionTitle.register(provider)`; a second registration throws. The shipped model-backed providers are [first-prompt](../session-title-first-prompt-llm/README.md) and [all-prompts](../session-title-all-prompts-llm/README.md), both using the shared [LLM generation policy](../session-title-llm/README.md). A provider starts only after a marked loop-built request's exact route matches the logged `request/header`, and a newer revision supersedes and aborts older work.
+One optional asynchronous provider may be registered through `ctx.sessionTitle.register(provider)`; a second registration throws until the first provider's disposal starts, so a replacement can activate while the previous provider drains, and the previous provider's late results never commit. The shipped model-backed providers are [first-prompt](../session-title-first-prompt-llm/README.md) and [all-prompts](../../experimental/session-title-all-prompts-llm/README.md), both using the shared [LLM execution module](../session-title-llm/README.md). Immediately before each call the service captures the latest accepted title snapshot, including the fallback it just ensured, and passes it as `request.currentTitle`; the provider owns whether and how to use it. A provider starts only after a marked loop-built request's exact route matches the logged `request/header`, and a newer revision supersedes and aborts older work. For unchanged routes, an active marked request starts pending automatic generation without a new header event; accepted human messages may follow the current `step/start`.
 
 ### Reading titles
 
@@ -104,9 +104,9 @@ Accepted titles are cleaned of terminal control sequences, directional and invis
 Read these pages when the service contract is not enough. They move from the subsystem reference to the model-backed providers that plug in here.
 
 - [Session title subsystem](../../../docs/subsystems/session-title.md) — durable title state and the provider vocabulary types.
-- [Shared LLM title policy](../session-title-llm/README.md) — the model-backed generation helper both shipped providers use.
+- [Shared LLM execution module](../session-title-llm/README.md) — the model-backed execution module both shipped providers use.
 - [First-message title provider](../session-title-first-prompt-llm/README.md) — titles from the first eligible human message.
-- [All-messages title provider](../session-title-all-prompts-llm/README.md) — titles from every eligible human message.
+- [All-messages title provider](../../experimental/session-title-all-prompts-llm/README.md) — titles from every eligible human message.
 - [Session package map](../README.md) — adjacent persistence, projection, title, and telemetry packages.
 
 -----

package/README.zh.md

@@ -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)与[全消息](../../experimental/session-title-all-prompts-llm/README.zh.md)，两者都使用共享的 [LLM（大语言模型）执行模块](../session-title-llm/README.zh.md)。每次调用前，服务会捕获最新已接纳标题快照（包括它刚刚确保的回退），并作为 `request.currentTitle` 传入；提供方自行决定是否以及如何使用。提供方只有在带标记、由循环构建的请求的确切路由与已记录 `request/header` 匹配时才启动，较新的修订会取代并中止旧工作。路由不变时，活跃步骤中带标记的请求会启动待处理的自动生成，无需新的 header 事件；已接受的人类消息可以位于当前 `step/start` 之后。
 
 ### 读取标题
 
@@ -104,9 +104,9 @@ kind: "package-reference"
 当服务约定不够用时阅读以下页面。它们从子系统参考逐步进入在此插拔的模型支持提供方。
 
 - [会话标题子系统](../../../docs/subsystems/session-title.zh.md)——持久标题状态与提供方词汇类型。
-- [共享 LLM 标题策略](../session-title-llm/README.zh.md)——两个随附提供方共用的模型生成辅助模块。
+- [共享 LLM 执行模块](../session-title-llm/README.zh.md)——两个随附提供方共用的模型执行模块。
 - [首消息标题提供方](../session-title-first-prompt-llm/README.zh.md)——根据第一条符合条件的用户消息生成标题。
-- [全消息标题提供方](../session-title-all-prompts-llm/README.zh.md)——根据所有符合条件的用户消息生成标题。
+- [全消息标题提供方](../../experimental/session-title-all-prompts-llm/README.zh.md)——根据所有符合条件的用户消息生成标题。
 - [会话包映射](../README.zh.md)——相邻的持久化、投影、标题与遥测包。
 
 -----

package/lib/index.js

@@ -350,13 +350,14 @@ var SessionTitleService = class extends Service {
 	}
 	/**
 	* Register the sole optional title provider. Disposal aborts its pending and
-	* active work before another provider may register.
+	* active work; a replacement may register once disposal has started, and the
+	* closing provider's late results never commit.
 	* @param provider - provider identity, cadence, and generation function.
 	* @returns exact Cordis effect disposer, which settles after active calls quiesce.
 	*/
 	register(provider) {
 		this.validateProvider(provider);
-		if (this.registration !== void 0) throw new Error(`session-title provider "${this.registration.provider.id}" is already registered`);
+		if (this.registration !== void 0 && !this.registration.closing) throw new Error(`session-title provider "${this.registration.provider.id}" is already registered`);
 		const registration = {
 			provider,
 			active: /* @__PURE__ */ new Set(),
@@ -422,7 +423,7 @@ var SessionTitleService = class extends Service {
 		if (session === void 0 || state === void 0 || pending === void 0) return;
 		const boundary = this.ctx.sessionProjections.stateOf(session, "turnBoundary")?.lastStepBoundary;
 		const route = session.requestHeader()?.config;
-		if (boundary?.kind !== "start" || boundary.seq <= pending.throughSeq || route?.provider !== options.provider || route.model !== options.model) return;
+		if (boundary?.kind !== "start" || route?.provider !== options.provider || route.model !== options.model) return;
 		this.startPending(session, state, pending, {
 			provider: options.provider,
 			model: options.model
@@ -453,11 +454,14 @@ var SessionTitleService = class extends Service {
 			this.assertCurrent(session, work);
 			await this.ensureFallback(session);
 			this.assertCurrent(session, work);
-			const messages = collectSessionTitleMessages(session.snapshotEvents(), work.throughSeq);
+			const events = session.snapshotEvents();
+			const messages = collectSessionTitleMessages(events, work.throughSeq);
+			const currentTitle = foldSessionTitle(events);
 			const result = await work.registration.provider.generate({
 				session,
 				messages,
 				...route === void 0 ? {} : { route },
+				...currentTitle === void 0 ? {} : { currentTitle },
 				signal: work.signal
 			});
 			this.assertCurrent(session, work);

package/lib/types/index.d.ts

@@ -61,6 +61,12 @@ export interface SessionTitleProviderRequest {
     readonly messages: readonly SessionTitleUserMessage[];
     /** Exact current logged main-request route, when one has been recorded. */
     readonly route?: SessionTitleModelIdentity;
+    /**
+     * Latest accepted title captured at invocation, including an accepted
+     * fallback whose event may follow the last eligible message. Absent before
+     * any title is accepted. The provider decides whether and how to use it.
+     */
+    readonly currentTitle?: SessionTitleSnapshot;
     /** Cancellation for supersession, disposal, timeout composition, or the explicit caller. */
     readonly signal: AbortSignal;
 }
@@ -81,7 +87,7 @@ export interface SessionTitleProvider {
     readonly automatic: SessionTitleAutomaticMode;
     /**
      * Produce one title revision.
-     * @param request - message snapshot, current route, session, and cancellation.
+     * @param request - message snapshot, current title, current route, session, and cancellation.
      * @returns proposed title plus exact input seqs and the optional provider/model route used to generate it.
      */
     generate(request: SessionTitleProviderRequest): Promise<SessionTitleProviderResult>;
@@ -143,7 +149,8 @@ export declare class SessionTitleService extends Service {
     refresh(session: Session, signal?: AbortSignal): Promise<SessionTitleSnapshot | undefined>;
     /**
      * Register the sole optional title provider. Disposal aborts its pending and
-     * active work before another provider may register.
+     * active work; a replacement may register once disposal has started, and the
+     * closing provider's late results never commit.
      * @param provider - provider identity, cadence, and generation function.
      * @returns exact Cordis effect disposer, which settles after active calls quiesce.
      */

package/lib/types/index.js

@@ -315,13 +315,14 @@ export class SessionTitleService extends Service {
     }
     /**
      * Register the sole optional title provider. Disposal aborts its pending and
-     * active work before another provider may register.
+     * active work; a replacement may register once disposal has started, and the
+     * closing provider's late results never commit.
      * @param provider - provider identity, cadence, and generation function.
      * @returns exact Cordis effect disposer, which settles after active calls quiesce.
      */
     register(provider) {
         this.validateProvider(provider);
-        if (this.registration !== undefined) {
+        if (this.registration !== undefined && !this.registration.closing) {
             throw new Error(`session-title provider "${this.registration.provider.id}" is already registered`);
         }
         const registration = {
@@ -404,7 +405,6 @@ export class SessionTitleService extends Service {
         const boundary = this.ctx.sessionProjections.stateOf(session, 'turnBoundary')?.lastStepBoundary;
         const route = session.requestHeader()?.config;
         if (boundary?.kind !== 'start'
-            || boundary.seq <= pending.throughSeq
             || route?.provider !== options.provider
             || route.model !== options.model)
             return;
@@ -441,12 +441,17 @@ export class SessionTitleService extends Service {
             this.assertCurrent(session, work);
             await this.ensureFallback(session);
             this.assertCurrent(session, work);
+            // One snapshot supplies both inputs: messages stop at the scheduled
+            // watermark, while the current title is not bounded by that watermark.
             // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
-            const messages = collectSessionTitleMessages(session.snapshotEvents(), work.throughSeq);
+            const events = session.snapshotEvents();
+            const messages = collectSessionTitleMessages(events, work.throughSeq);
+            const currentTitle = foldSessionTitle(events);
             const result = await work.registration.provider.generate({
                 session,
                 messages,
                 ...route === undefined ? {} : { route },
+                ...currentTitle === undefined ? {} : { currentTitle },
                 signal: work.signal,
             });
             this.assertCurrent(session, work);

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.2.1-alpha.1",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,25 +37,25 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2"
   },
   "dependencies": {
-    "zod": "^4.4.3",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2"
   }
 }