@deepseek-ai/dsh-session-title-first-prompt-llm 0.0.1-rc.3

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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-first-prompt-llm/README.md
+README.md: fef0651e1c4ba0032e6a1854590d5ac023bd71d8
+README.zh.md: 377779467a091b2c68d91a8be1903702a0808d10

package/README.md

@@ -0,0 +1,28 @@
+# @deepseek-ai/dsh-session-title-first-prompt-llm
+
+English | [中文](README.zh.md)
+
+Optional `ctx.sessionTitle` provider that summarizes the first eligible human message through `ctx.llm`. It registers the `first-prompt` cadence, runs automatically only when a fresh non-fork session first creates its fallback, and attributes the result to that message's exact seq. An automatic failure retains the fallback and is retried only through `ctx.sessionTitle.refresh()`.
+
+The plugin uses the complete required [shared LLM configuration](../session-title-llm/README.md#configuration). Omit both `provider` and `model` to inherit the exact route from the current logged main request, or set both to route title generation independently.
+
+## Model Experience
+
+### First-message title request
+
+#### What the model sees
+
+The title model receives the shared title instruction and a JSON array containing only the first eligible human message. Later prompts and inherited fork history do not trigger another automatic call.
+
+#### Token effect
+
+At most one automatic auxiliary request is made for a fresh session, bounded by `maxInputBytes` and `maxOutputTokens`; explicit refreshes may make additional calls. The main agent request gains zero tokens.
+
+#### KV Cache effect
+
+No main-request invalidation. The auxiliary request uses the configured or logged route and has provider-specific cache behavior.
+
+## Known Limitations and Deferred Work
+
+- The first message alone may cease to represent a long-running session; use the all-messages provider when later prompts should retitle it.
+- A fork keeps its inherited title and never runs this provider automatically, even when its seeded first message came from the parent.

package/README.zh.md

@@ -0,0 +1,28 @@
+# @deepseek-ai/dsh-session-title-first-prompt-llm
+
+[English](README.md) | 中文
+
+可选的 `ctx.sessionTitle` 提供方，通过 `ctx.llm` 总结第一条符合条件的用户消息。它注册 `first-prompt` 节奏，只在全新非 fork 会话首次创建回退时自动运行，并将结果归因于该消息的确切 seq。自动失败会保留回退，之后只能通过 `ctx.sessionTitle.refresh()` 重试。
+
+该插件使用完整且必填的[共享 LLM（大语言模型）配置](../session-title-llm/README.md#configuration)。同时省略 `provider` 与 `model` 时，会继承当前已记录主请求的确切路由；也可以同时设置二者，使标题生成使用独立路由。
+
+## 模型体验
+
+### 首消息标题请求
+
+#### 模型看到的内容
+
+标题模型会收到共享标题指令，以及一个只包含第一条符合条件用户消息的 JSON 数组。后续提示词与继承的 fork 历史不会触发再次自动调用。
+
+#### Token 影响
+
+全新会话最多自动发出一次辅助请求，并受 `maxInputBytes` 和 `maxOutputTokens` 约束；显式刷新可能发出额外调用。主 agent（智能体）请求不会增加 token。
+
+#### KV Cache 影响
+
+不会使主请求的 KV Cache 失效。辅助请求使用已配置或已记录路由，其缓存行为由提供方决定。
+
+## 已知限制与暂缓事项
+
+- 对于长期会话，第一条消息可能不再具有代表性；如果后续提示词应触发重新生成标题，请使用全消息提供方。
+- fork 会保留继承的标题，绝不会自动运行此提供方，即使其预置的首消息来自父会话。

package/lib/index.js

@@ -0,0 +1,34 @@
+import z from "@deepseek-ai/schemastery";
+import { SessionTitleLlmConfigFields, registerSessionTitleLlmProvider } from "@deepseek-ai/dsh-session-title-llm";
+//#region lib/types/index.js
+/** First-human-message model provider for `ctx.sessionTitle`. */
+const name = "session-title-first-prompt-llm";
+const inject = [
+	"sessionTitle",
+	"llm",
+	"sessions"
+];
+/** Loader schema shared with the all-messages provider. */
+const Config = z.object({
+	targetWords: SessionTitleLlmConfigFields.targetWords,
+	targetCjkCharacters: SessionTitleLlmConfigFields.targetCjkCharacters,
+	maxInputBytes: SessionTitleLlmConfigFields.maxInputBytes,
+	maxOutputTokens: SessionTitleLlmConfigFields.maxOutputTokens,
+	timeoutMs: SessionTitleLlmConfigFields.timeoutMs,
+	provider: SessionTitleLlmConfigFields.provider,
+	model: SessionTitleLlmConfigFields.model
+});
+/**
+* Register the first-prompt model provider.
+* @param ctx - context exposing session-title, LLM, and session services.
+* @param config - required route, target, byte, token, and timeout policy.
+*/
+function apply(ctx, config) {
+	registerSessionTitleLlmProvider(ctx, config, name, "first-prompt", (messages) => {
+		const first = messages[0];
+		if (first === void 0) throw new Error("first-prompt title provider requires one human message");
+		return [first];
+	});
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-session-title-first-prompt-llm`.
+* @module @deepseek-ai/dsh-session-title-first-prompt-llm/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-session-title-first-prompt-llm";
+/** Cordis companion plugin name. */
+const name = "session-title-first-prompt-llm-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this thin provider delegates request and result validation to the shared
+* title service and LLM helper and retains no independent mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,17 @@
+/** First-human-message model provider for `ctx.sessionTitle`. */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { SessionTitleLlmConfig } from '@deepseek-ai/dsh-session-title-llm';
+export declare const name = "session-title-first-prompt-llm";
+export declare const inject: string[];
+/** Required LLM policy; this plugin adds no defaults. */
+export type Config = SessionTitleLlmConfig;
+/** Loader schema shared with the all-messages provider. */
+export declare const Config: z<Config>;
+/**
+ * Register the first-prompt model provider.
+ * @param ctx - context exposing session-title, LLM, and session services.
+ * @param config - required route, target, byte, token, and timeout policy.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-session-title-first-prompt-llm`.
+ * @module @deepseek-ai/dsh-session-title-first-prompt-llm/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "session-title-first-prompt-llm-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@deepseek-ai/dsh-session-title-first-prompt-llm",
+  "description": "First-message LLM provider plugin for DeepSeek Harness session titles",
+  "version": "0.0.1-rc.3",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session/session-title-first-prompt-llm"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "@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-title": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-session-title-llm": "^0.0.1-rc.3"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis-plugin-include": "^1.0.5-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-title": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-session-title-llm": "^0.0.1-rc.3"
+  }
+}