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

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 @@
+<svg width="36" height="36" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" stroke-width="1"><path d="M2.37091 11.2501C1.58745 9.89288 1.32067 8.29835 1.61969 6.76006C1.91872 5.22177 2.76342 3.8433 3.99826 2.87846C5.2331 1.91362 6.77494 1.42737 8.33988 1.50925C9.90482 1.59113 11.3875 2.23562 12.5149 3.32406C13.6425 4.41269 14.3387 5.87206 14.4754 7.4334C14.612 8.99474 14.18 10.5529 13.2587 11.8209C12.3375 13.0888 10.9891 13.9813 9.46194 14.3337C8.18691 14.628 6.85895 14.5294 5.64989 14.0605C5.1712 13.8748 4.76962 13.4932 4.26534 13.3967C3.67413 13.2835 2.95257 13.5598 2.03794 14.3337" stroke="#658EFF"></path><path d="M8 5V11" stroke="#658EFF"></path><path d="M5 8H11" stroke="#658EFF"></path></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.2",
+  "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.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+  }
 }