@deepseek-ai/dsh-experimental-session-titles-bundle 0.0.0-stage → 0.2.1-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,37 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/experimental/session-titles-bundle/README.md
+/:
+  en: fa9b9ced4806b14a
+  zh: faa2967665315c2a
+/deepseek-ai-dsh-experimental-session-titles-bundle:
+  en: 0a69d3a2266a0f4f
+  zh: b5e2dc60de97752f
+/deepseek-ai-dsh-experimental-session-titles-bundle/summary:
+  en: a56206d66c18d447
+  zh: 67cde874fd703b58
+/deepseek-ai-dsh-experimental-session-titles-bundle/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 988e839059414d27
+/deepseek-ai-dsh-experimental-session-titles-bundle/use-this-package:
+  en: 3a843c2d148f94f1
+  zh: e67b41828084eb86
+/deepseek-ai-dsh-experimental-session-titles-bundle/understand-the-implementation:
+  en: f4a8d06bd561f7e9
+  zh: de811cf2c131256c
+/deepseek-ai-dsh-experimental-session-titles-bundle/further-exploration:
+  en: 1367330eede4af7d
+  zh: df71e4b0a865d429
+/deepseek-ai-dsh-experimental-session-titles-bundle/model-experience:
+  en: bfd9e6b55f48afff
+  zh: cd3eb720bfc2cdf6
+/deepseek-ai-dsh-experimental-session-titles-bundle/model-experience/kv-cache-effect:
+  en: 1b2209bbbf869b1a
+  zh: 5b9de62271343e4e
+/deepseek-ai-dsh-experimental-session-titles-bundle/known-limitations-and-deferred-work:
+  en: 833386166a2ec27c
+  zh: a70ebec93a3be891
+/deepseek-ai-dsh-experimental-session-titles-bundle/known-limitations-and-deferred-work/dev-note:
+  en: 279d01435256cd2a
+  zh: 83780964e5de2f54

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+---
+description: "Refresh session titles as new human prompts arrive."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @deepseek-ai/dsh-experimental-session-titles-bundle
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Generate experimental session titles from the conversation's eligible human prompts. This replaces the first-prompt title provider and applies across presets. It ships switched off in Web and Desktop. Select it in Plugins to enable it.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+In Web or Desktop, open Plugins and enable **Conversation-following titles** in Official. Switch it off to remove its profile layer.
+
+The switch changes the title provider for existing and new Sessions. Eligible human prompts or explicit refresh trigger title requests; the model is asked to keep an existing generated title exactly while it still describes the main topic or task. Automatic updates preserve user-pinned titles. Agent tool catalogs remain unchanged.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation details — click to expand</summary>
+
+[`cordis.patch.yml`](cordis.patch.yml) contributes the provider on the host. Later profile patches can override its settings. The [profile composer](../../boot/app-boot/README.md) owns patch ordering and errors. The layer disables `session-title-llm` before selecting its replacement; deselection restores the default provider.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+[Capability implementation](../session-title-all-prompts-llm/README.md)
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through the [capability implementation](../session-title-all-prompts-llm/README.md), which owns model context and results.
+
+#### KV Cache effect
+
+The layer adds no request content directly; the capability implementation owns cache effects from tools, prompts, and results.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- Automatic title failures retain the previous title. The 4096-byte title-input budget includes the current generated title when supplied and rejects oversized input instead of truncating conversation history.
+
+-----
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Maintainer context — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,78 @@
+---
+description: "在收到新的用户提示时更新会话标题。"
+kind: "package-bundle"
+---
+
+# @deepseek-ai/dsh-experimental-session-titles-bundle
+
+[English](README.md) | 中文
+
+## 概述
+
+根据对话中符合条件的用户提示生成实验性会话标题。此功能替换首条提示标题提供者，并适用于所有预设。 Web 和 Desktop 随附此功能，默认关闭。在插件页选择它即可启用。
+
+## 目录
+
+- [使用此包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与暂缓工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用此包
+
+在 Web 或 Desktop 中打开插件页，在官方分组启用 **随对话更新的标题**。关闭后移除其配置层。
+
+开关会更改已有和新建 Session 的标题提供方。符合条件的用户提示词或显式刷新会触发标题请求；模型被要求在已有生成标题仍能描述主要主题或任务时逐字保留它。自动更新不会覆盖用户固定的标题。智能体的工具目录保持不变。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节 — 点击展开</summary>
+
+[`cordis.patch.yml`](cordis.patch.yml) 在 Host 上添加提供者。后续配置补丁可以覆盖其设置。[配置组合器](../../boot/app-boot/README.zh.md) 负责补丁顺序和错误处理。 此层禁用 `session-title-llm` 后选择替代提供者；取消选择会恢复默认提供者。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+[能力实现](../session-title-all-prompts-llm/README.zh.md)
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响，通过[能力实现](../session-title-all-prompts-llm/README.zh.md) 贡献模型上下文和结果。
+
+#### KV Cache 影响
+
+此配置层不直接添加请求内容；能力实现负责工具目录、提示和结果的缓存影响。
+
+## 已知限制与暂缓工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- 自动标题生成失败时保留旧标题。标题输入预算为 4096 字节，包含传入的当前生成标题，超限时拒绝输入而不截断对话历史。
+
+-----
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者上下文 — 点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+- id: session-title-llm
+  disabled: true
+
+- insert:
+    - id: optional-session-title-all-prompts
+      name: '@deepseek-ai/dsh-session-title-all-prompts-llm'
+      config:
+        targetWords: 5
+        targetCjkCharacters: 10
+        maxInputBytes: 4096
+        maxOutputTokens: 64
+        timeoutMs: 60000

package/icon.svg

@@ -0,0 +1,11 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="11.5" y="8" width="17" height="14" rx="2.5" fill="#7CB7FF" fill-opacity="0.55" />
+  <path d="M10 12H23C24.3807 12 25.5 13.1193 25.5 14.5V23.5C25.5 24.8807 24.3807 26 23 26H14.5L10.4 30.1Q10 30.5 10 29.93V26C8.61929 26 7.5 24.8807 7.5 23.5V14.5C7.5 13.1193 8.61929 12 10 12Z" fill="url(#session-title-bubble)" />
+  <path d="M13 16H20M16.5 16V22" stroke="#FFFFFF" stroke-width="1.6" />
+  <defs>
+    <linearGradient id="session-title-bubble" x1="9" y1="12" x2="24" y2="28" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#6FB2EE" />
+      <stop offset="1" stop-color="#3E58D6" />
+    </linearGradient>
+  </defs>
+</svg>

package/lib/index.js

@@ -0,0 +1 @@
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,3 @@
+/** Conversation-following titles profile layer; runtime entries are declared in cordis.patch.yml. */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Conversation-following titles",
+    "description": "Refresh session titles as new human prompts arrive."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "随对话更新的标题",
+    "description": "在收到新的用户提示时更新会话标题。"
+  }
+}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@deepseek-ai/dsh-experimental-session-titles-bundle",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Refresh session titles as new human prompts arrive.",
+  "version": "0.2.1-alpha.3",
+  "icon": "./icon.svg",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/experimental/session-titles-bundle"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "cordis.patch.yml",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-session-title-all-prompts-llm": "0.2.1-alpha.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
+  }
 }