@deepseek-ai/dsh-session-title-llm 0.0.1-rc.1

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-llm/README.md
+README.md: db03205cabf9f723ee9bf6ad122026d75cb92113
+README.zh.md: a214caae84aeee7a3a5c90f55e8a01ea957b823f

package/README.md

@@ -0,0 +1,47 @@
+# @deepseek-ai/dsh-session-title-llm
+
+English | [中文](README.zh.md)
+
+Shared implementation policy for model-backed session-title providers. It resolves the auxiliary route, frames exact selected human messages as JSON, records the exact dispatchable request, applies a language-aware title instruction, enforces input and output budgets, composes timeout and caller cancellation, assembles the stream, and returns normalized text with exact source seqs plus the provider/model route used to generate it.
+
+This package is a library, not a Cordis plugin. The provider plugins call `registerSessionTitleLlmProvider()` with their cadence and message selector; it validates shared config and delegates each revision to `generateSessionTitleWithLlm()`, so registration, route, prompt, cancellation, and validation behavior cannot drift between them.
+
+## Route and failure contract
+
+`provider` and `model` overrides are optional but must be supplied together as non-empty strings. Without that pair, the helper uses the exact provider/model route captured from the current session's logged `request/header`; an explicit refresh before any route exists therefore needs overrides. The helper measures the final JSON-framed user prompt, including seq fields, wrappers, and JSON escaping, against `maxInputBytes` before logging or dispatch instead of truncating it. Timeout and caller cancellation are rechecked while consuming the stream and after it completes, so a late successful result cannot be accepted even if an interceptor or adapter ignores abort. Malformed or empty output, tool calls, and non-stop finish reasons also reject; the session-title service decides whether that rejection is an automatic warning or an explicit caller failure.
+
+After route and input validation, the helper appends a log-only `session/title-llm-request` event directly through `Session` before model dispatch. It contains the title-provider id, exact source seqs, route, system prompt, message list, and output-token cap used by the call. Persistence observes the record eagerly; the append does not need a title-specific marker, cast, settlement queue, or flush. The dispatched envelope is deep-frozen, carries `purpose: 'session-title'`, and deliberately lacks dsh-agent-loop's process-local request identity. Interceptors stay aligned with the record while loop-only reconstruction observers do not compare it with the conversation header. The DeepSeek adapter maps that purpose to thinking-disabled so the small output budget is reserved for visible title text; other adapters own their purpose-specific behavior. A later model failure leaves the request record intact; validation failures that never become dispatchable requests do not create one. The event stays outside derived model history.
+
+## Configuration
+
+Every field is required except the paired route override; there are no library defaults.
+
+| Key | Contract |
+|---|---|
+| `targetWords` | Positive target word count for non-CJK titles. |
+| `targetCjkCharacters` | Positive target character count for Chinese, Japanese, or Korean titles. |
+| `maxInputBytes` | Positive UTF-8 byte ceiling for the final JSON-framed user prompt. |
+| `maxOutputTokens` | Positive auxiliary generation token cap. |
+| `timeoutMs` | Positive end-to-end deadline within the runtime timer limit. |
+| `provider`, `model` | Optional explicit route; both or neither. |
+
+## Model Experience
+
+### Auxiliary title request
+
+#### What the model sees
+
+The title model receives a fixed system instruction to return one concise unadorned title in the input language, including the configured word and CJK-character targets. Its one user message contains a JSON array of the exact selected human messages and their seqs.
+
+#### Token effect
+
+The auxiliary request consumes tokens according to selected input size and `maxOutputTokens`. It is separate from the main agent request and does not add title text or framing to agent history. DeepSeek title calls disable thinking; the main conversation retains its configured thinking mode.
+
+#### KV Cache effect
+
+No main-request invalidation. Auxiliary cache reuse is provider-specific; the fixed instruction is reusable while the JSON message array changes with each revision.
+
+## Known Limitations and Deferred Work
+
+- The helper accepts text output only and rejects tool calls; structured-output adapters and provider-specific prompt variants are not exposed.
+- It enforces a byte ceiling for the whole framed user prompt rather than clipping individual messages or applying a retention policy.

package/README.zh.md

@@ -0,0 +1,47 @@
+# @deepseek-ai/dsh-session-title-llm
+
+[English](README.md) | 中文
+
+由模型支持的会话标题提供方的共享实现策略。它解析辅助路由，将精确选中的用户消息封装为 JSON，记录可分发的确切请求，应用语言感知的标题指令，强制执行输入和输出预算，组合超时与调用方取消，组装流，并返回规范化文本，同时给出确切来源 seq 以及生成该文本时使用的提供方／模型路由。
+
+此包是普通库，不是 Cordis 插件。提供方插件调用 `registerSessionTitleLlmProvider()`，传入各自节奏与消息选择器；该函数验证共享配置，并将每次修订委派给 `generateSessionTitleWithLlm()`，使各插件的注册、路由、提示词、取消与验证行为不会漂移。
+
+## 路由与失败约定
+
+`provider` 和 `model` 覆盖项都是可选的，但必须同时作为非空字符串提供。如果没有这一对取值，辅助模块会使用当前会话已记录 `request/header` 中捕获的确切提供方／模型路由；因此，在任何路由出现前显式刷新时必须提供覆盖项。辅助模块在记录或分发前，依据 `maxInputBytes` 检查最终 JSON 封装用户提示词的大小，包括 seq 字段、包装层与 JSON 转义，而不是将其截断。消费流期间和流完成后都会重新检查超时与调用方取消，因此即使 interceptor 或适配器忽略 abort，也不能接受迟到的成功结果。格式错误或空输出、工具调用和非 stop 结束原因同样会导致调用被拒绝；会话标题服务决定该拒绝属于自动警告还是显式调用方失败。
+
+路由与输入验证完成后，辅助模块会在模型分发前直接通过 `Session` 追加仅写入日志的 `session/title-llm-request` 事件。它包含标题提供方 id、确切来源 seq、路由、系统提示词、消息列表，以及该调用使用的输出 token 上限。持久化会立即观察到该记录；追加不需要标题专属标记、类型断言、结算队列或刷写。分发的请求封套会深度冻结，携带 `purpose: 'session-title'`，且有意不包含 dsh-agent-loop 的进程本地请求身份。拦截器会与记录保持一致，而循环专用重建观察者不会把它与对话请求头比较。DeepSeek 适配器会根据该用途禁用思考，使少量输出预算全部用于可见标题文本；其他适配器负责自身用途专用行为。后续模型失败会保留请求记录；从未成为可分发请求的验证失败不会创建记录。该事件始终位于派生模型历史之外。
+
+## 配置
+
+除成对的路由覆盖项外，每个字段都必填；库不提供默认值。
+
+| 键 | 约定 |
+|---|---|
+| `targetWords` | 非 CJK 标题的正整数目标词数。 |
+| `targetCjkCharacters` | 中文、日文或韩文标题的正整数目标字符数。 |
+| `maxInputBytes` | 最终 JSON 封装用户提示词的正整数 UTF-8 字节上限。 |
+| `maxOutputTokens` | 辅助生成的正整数 token 上限。 |
+| `timeoutMs` | 运行时定时器限制内的正数端到端时限。 |
+| `provider`, `model` | 可选显式路由；二者同时提供或同时省略。 |
+
+## 模型体验
+
+### 辅助标题请求
+
+#### 模型看到的内容
+
+标题模型会收到固定系统指令，要求以输入语言返回一个简洁且无装饰的标题；该指令包含所配置的词数与 CJK 字符数目标。它唯一的用户消息包含一个 JSON 数组，其中是精确选中的用户消息及其 seq。
+
+#### Token 影响
+
+辅助请求根据所选输入大小和 `maxOutputTokens` 消耗 token。它与主 agent（智能体）请求相互独立，不会向 agent 历史增加标题文本或封装内容。DeepSeek 标题调用会关闭思考；主对话保留自身配置的思考模式。
+
+#### KV Cache 影响
+
+不会使主请求的 KV Cache 失效。辅助缓存复用由提供方决定；固定指令可复用，而 JSON 消息数组会随每次修订变化。
+
+## 已知限制与暂缓事项
+
+- 辅助模块只接受文本输出，并拒绝工具调用；不公开结构化输出适配器或提供方专用提示词变体。
+- 它对整个封装用户提示词强制执行字节上限，不会剪裁单条消息或应用保留策略。

package/lib/index.js

@@ -0,0 +1,252 @@
+import z from "@deepseek-ai/schemastery";
+import { BlockAssembler, createUserMessage, deepFreeze } from "@deepseek-ai/dsh-llm";
+import { MAX_TIMER_DELAY_MS, deadline } from "@deepseek-ai/dsh-timeout";
+import { SessionTitleProviderId, normalizeSessionTitle } from "@deepseek-ai/dsh-session-title";
+//#region lib/types/index.js
+/**
+* Shared route, framing, timeout, assembly, and validation policy for
+* model-backed session-title providers.
+* @module @deepseek-ai/dsh-session-title-llm
+*/
+var __addDisposableResource = function(env, value, async) {
+	if (value !== null && value !== void 0) {
+		if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+		var dispose, inner;
+		if (async) {
+			if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+			dispose = value[Symbol.asyncDispose];
+		}
+		if (dispose === void 0) {
+			if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+			dispose = value[Symbol.dispose];
+			if (async) inner = dispose;
+		}
+		if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+		if (inner) dispose = function() {
+			try {
+				inner.call(this);
+			} catch (e) {
+				return Promise.reject(e);
+			}
+		};
+		env.stack.push({
+			value,
+			dispose,
+			async
+		});
+	} else if (async) env.stack.push({ async: true });
+	return value;
+};
+var __disposeResources = (function(SuppressedError) {
+	return function(env) {
+		function fail(e) {
+			env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+			env.hasError = true;
+		}
+		var r, s = 0;
+		function next() {
+			while (r = env.stack.pop()) try {
+				if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+				if (r.dispose) {
+					var result = r.dispose.call(r.value);
+					if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) {
+						fail(e);
+						return next();
+					});
+				} else s |= 1;
+			} catch (e) {
+				fail(e);
+			}
+			if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+			if (env.hasError) throw env.error;
+		}
+		return next();
+	};
+})(typeof SuppressedError === "function" ? SuppressedError : function(error, suppressed, message) {
+	var e = new Error(message);
+	return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+/** Capability-owned timeout reason code for auxiliary title requests. */
+const SESSION_TITLE_TIMEOUT_CODE = "SESSION_TITLE_TIMEOUT";
+/** Shared Loader field schemas with no library defaults. */
+const SessionTitleLlmConfigFields = {
+	targetWords: z.number().step(1).min(1).required(),
+	targetCjkCharacters: z.number().step(1).min(1).required(),
+	maxInputBytes: z.number().step(1).min(1).required(),
+	maxOutputTokens: z.number().step(1).min(1).required(),
+	timeoutMs: z.number().step(1).min(1).max(MAX_TIMER_DELAY_MS).required(),
+	provider: z.string(),
+	model: z.string()
+};
+/** Shared Loader schema with no library defaults. */
+const SessionTitleLlmConfigSchema = z.object(SessionTitleLlmConfigFields);
+/** Complete configuration key set for direct construction validation. */
+const CONFIG_KEYS = new Set([
+	"targetWords",
+	"targetCjkCharacters",
+	"maxInputBytes",
+	"maxOutputTokens",
+	"timeoutMs",
+	"provider",
+	"model"
+]);
+/** Validate one positive integer limit. */
+function assertPositiveInteger(name, value) {
+	if (!Number.isInteger(value) || value <= 0) throw new Error(`session-title-llm: ${name} must be a positive integer`);
+}
+/**
+* Validate and detach required model-provider configuration.
+* @param config - untrusted plugin configuration.
+* @returns immutable policy with optional route absence preserved.
+*/
+function resolveSessionTitleLlmConfig(config) {
+	const candidate = config;
+	if (candidate === null || typeof candidate !== "object") throw new Error("session-title-llm: configuration is required");
+	const value = candidate;
+	for (const key of Object.keys(value)) if (!CONFIG_KEYS.has(key)) throw new Error(`session-title-llm: unknown config key "${key}"`);
+	assertPositiveInteger("targetWords", value.targetWords);
+	assertPositiveInteger("targetCjkCharacters", value.targetCjkCharacters);
+	assertPositiveInteger("maxInputBytes", value.maxInputBytes);
+	assertPositiveInteger("maxOutputTokens", value.maxOutputTokens);
+	assertPositiveInteger("timeoutMs", value.timeoutMs);
+	if (value.timeoutMs > MAX_TIMER_DELAY_MS) throw new Error(`session-title-llm: timeoutMs must not exceed ${MAX_TIMER_DELAY_MS}`);
+	const hasProvider = value.provider !== void 0;
+	if (hasProvider !== (value.model !== void 0)) throw new Error("session-title-llm: provider and model must be supplied together");
+	if (hasProvider && (typeof value.provider !== "string" || value.provider.length === 0 || typeof value.model !== "string" || value.model.length === 0)) throw new Error("session-title-llm: provider and model overrides must be non-empty strings");
+	return deepFreeze({ ...value });
+}
+/**
+* Register one model-backed provider through the shared configuration and call policy.
+* @param ctx - context exposing the title and LLM services.
+* @param config - untrusted required deployment policy.
+* @param id - stable plugin id recorded with generated titles.
+* @param automatic - provider-owned automatic generation cadence.
+* @param selectMessages - exact source-message selection for one revision.
+*/
+function registerSessionTitleLlmProvider(ctx, config, id, automatic, selectMessages) {
+	const resolved = resolveSessionTitleLlmConfig(config);
+	const titleProvider = SessionTitleProviderId(id);
+	ctx.sessionTitle.register({
+		id: titleProvider,
+		automatic,
+		async generate(request) {
+			return generateSessionTitleWithLlm(ctx, resolved, request, selectMessages(request.messages), titleProvider);
+		}
+	});
+}
+/** Resolve the explicit pair or the exact route captured from `request/header`. */
+function resolveRoute(config, request) {
+	if (config.provider !== void 0 && config.model !== void 0) return {
+		provider: config.provider,
+		model: config.model
+	};
+	if (request.route === void 0) throw new Error("session-title-llm: no logged request route is available; configure provider and model together");
+	return request.route;
+}
+/** Stable language-aware system instruction shared by both provider plugins. */
+function systemPrompt(config) {
+	return [
+		"Create a concise title for an AI coding-assistant session from the supplied human messages.",
+		"Return only the title on one line, **in plain text of natural language**, with no quotes, prefix, explanation, Markdown, XML, or terminal control codes. No code is allowed.",
+		"Use the language of the messages.",
+		`Aim for about ${config.targetWords} words in non-CJK languages or ${config.targetCjkCharacters} CJK characters.`
+	].join("\n");
+}
+/** Frame exact messages as JSON so user text cannot break structural delimiters. */
+function frameMessages(messages) {
+	return `Generate the session title from this JSON array of human messages:\n${JSON.stringify(messages)}`;
+}
+/** Translate terminal finish reasons into an auxiliary-call failure. */
+function finishError(finish) {
+	switch (finish.kind) {
+		case "stop": return;
+		case "error":
+		case "aborted": {
+			const error = new Error(finish.failure.message);
+			error.code = finish.failure.code;
+			return error;
+		}
+		case "max-tokens": return /* @__PURE__ */ new Error("session-title-llm: title output reached maxOutputTokens");
+		case "tool-calls": return /* @__PURE__ */ new Error("session-title-llm: title model unexpectedly requested a tool");
+		default: return /* @__PURE__ */ new Error(`session-title-llm: unsupported finish reason "${String(finish.kind)}"`);
+	}
+}
+/**
+* Generate one title through the shared auxiliary LLM call.
+* @param ctx - context exposing the registered LLM service.
+* @param config - validated model-provider policy.
+* @param request - service-owned session, route, message snapshot, and cancellation.
+* @param selectedMessages - exact provider-selected subset to frame and attribute.
+* @param titleProvider - registered title-provider identity recorded with the request.
+* @returns normalized non-empty title, exact source seqs, and used model route.
+*/
+async function generateSessionTitleWithLlm(ctx, config, request, selectedMessages, titleProvider) {
+	const env_1 = {
+		stack: [],
+		error: void 0,
+		hasError: false
+	};
+	try {
+		request.signal.throwIfAborted();
+		if (selectedMessages.length === 0) throw new Error("session-title-llm: at least one source message is required");
+		const framedInput = frameMessages(selectedMessages);
+		const inputBytes = Buffer.byteLength(framedInput, "utf8");
+		if (inputBytes > config.maxInputBytes) throw new Error(`session-title-llm: input is ${inputBytes} bytes, exceeding maxInputBytes ${config.maxInputBytes}`);
+		const route = resolveRoute(config, request);
+		const messages = [createUserMessage({
+			content: [{
+				type: "text",
+				text: framedInput
+			}],
+			source: {
+				kind: "plugin",
+				plugin: "dsh-session-title-llm"
+			}
+		})];
+		const system = systemPrompt(config);
+		const callDeadline = __addDisposableResource(env_1, deadline(request.signal, config.timeoutMs, SESSION_TITLE_TIMEOUT_CODE), false);
+		const options = deepFreeze({
+			provider: route.provider,
+			model: route.model,
+			messages,
+			system,
+			maxTokens: config.maxOutputTokens,
+			sessionId: request.session.id,
+			purpose: "session-title",
+			signal: callDeadline.signal
+		});
+		request.session.append("session/title-llm-request", {
+			titleProvider,
+			messageSeqs: selectedMessages.map((message) => message.seq),
+			route,
+			system,
+			messages,
+			maxTokens: config.maxOutputTokens
+		});
+		callDeadline.signal.throwIfAborted();
+		const assembler = new BlockAssembler();
+		for await (const chunk of ctx.llm.stream(options)) {
+			callDeadline.signal.throwIfAborted();
+			assembler.push(chunk);
+		}
+		callDeadline.signal.throwIfAborted();
+		const terminalError = finishError(assembler.finish);
+		if (terminalError !== void 0) throw terminalError;
+		const blocks = assembler.blocks();
+		if (blocks.some((block) => block.type === "tool-call")) throw new Error("session-title-llm: title output must contain text only");
+		const title = normalizeSessionTitle(blocks.filter((block) => block.type === "text").map((block) => block.text).join(" "), Number.MAX_SAFE_INTEGER);
+		if (title.length === 0) throw new Error("session-title-llm: title model produced no text");
+		return {
+			title,
+			messageSeqs: selectedMessages.map((message) => message.seq),
+			model: route
+		};
+	} catch (e_1) {
+		env_1.error = e_1;
+		env_1.hasError = true;
+	} finally {
+		__disposeResources(env_1);
+	}
+}
+//#endregion
+export { SESSION_TITLE_TIMEOUT_CODE, SessionTitleLlmConfigFields, SessionTitleLlmConfigSchema, generateSessionTitleWithLlm, registerSessionTitleLlmProvider, resolveSessionTitleLlmConfig };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-session-title-llm`.
+* @module @deepseek-ai/dsh-session-title-llm/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-session-title-llm";
+/** Cordis companion plugin name. */
+const name = "session-title-llm-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this stateless helper validates and freezes each auxiliary request before
+* dispatch; deadline, stream, cited message seqs, and provider/model fields are checked synchronously and by tests.
+*/
+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,93 @@
+/**
+ * Shared route, framing, timeout, assembly, and validation policy for
+ * model-backed session-title providers.
+ * @module @deepseek-ai/dsh-session-title-llm
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { Message } from '@deepseek-ai/dsh-llm';
+import { SessionTitleProviderId } from '@deepseek-ai/dsh-session-title';
+import type { SessionTitleAutomaticMode, SessionTitleModelProvenance, SessionTitleProviderRequest, SessionTitleProviderResult, SessionTitleUserMessage } from '@deepseek-ai/dsh-session-title';
+/** Exact model-visible request recorded before one auxiliary title dispatch. */
+export interface SessionTitleLlmRequestEventData {
+    /** Registered title-provider identity responsible for the request. */
+    readonly titleProvider: SessionTitleProviderId;
+    /** Exact human `user/message` seqs represented in `messages`. */
+    readonly messageSeqs: number[];
+    /** Exact auxiliary LLM route. */
+    readonly route: SessionTitleModelProvenance;
+    /** Exact auxiliary system prompt. */
+    readonly system: string;
+    /** Exact auxiliary message list. */
+    readonly messages: Message[];
+    /** Exact auxiliary output-token cap. */
+    readonly maxTokens: number;
+}
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        /** Log-only pre-dispatch record of one session-title model request. */
+        'session/title-llm-request': SessionTitleLlmRequestEventData;
+    }
+}
+/** Capability-owned timeout reason code for auxiliary title requests. */
+export declare const SESSION_TITLE_TIMEOUT_CODE = "SESSION_TITLE_TIMEOUT";
+/** Required deployment policy for one model-backed title plugin. */
+export interface SessionTitleLlmConfig {
+    /** Target word count for non-CJK titles. */
+    readonly targetWords: number;
+    /** Target character count for Chinese, Japanese, or Korean titles. */
+    readonly targetCjkCharacters: number;
+    /** Maximum UTF-8 bytes in the final JSON-framed user prompt. */
+    readonly maxInputBytes: number;
+    /** Auxiliary generation output-token cap. */
+    readonly maxOutputTokens: number;
+    /** End-to-end auxiliary request deadline in milliseconds. */
+    readonly timeoutMs: number;
+    /** Optional explicit provider route; must be paired with `model`. */
+    readonly provider?: string;
+    /** Optional explicit model id; must be paired with `provider`. */
+    readonly model?: string;
+}
+/** Validated immutable model-provider policy. */
+export interface ResolvedSessionTitleLlmConfig extends SessionTitleLlmConfig {
+}
+/** Shared Loader field schemas with no library defaults. */
+export declare const SessionTitleLlmConfigFields: {
+    targetWords: z<number, number>;
+    targetCjkCharacters: z<number, number>;
+    maxInputBytes: z<number, number>;
+    maxOutputTokens: z<number, number>;
+    timeoutMs: z<number, number>;
+    provider: z<string, string>;
+    model: z<string, string>;
+};
+/** Shared Loader schema with no library defaults. */
+export declare const SessionTitleLlmConfigSchema: z<SessionTitleLlmConfig>;
+/**
+ * Validate and detach required model-provider configuration.
+ * @param config - untrusted plugin configuration.
+ * @returns immutable policy with optional route absence preserved.
+ */
+export declare function resolveSessionTitleLlmConfig(config: SessionTitleLlmConfig): ResolvedSessionTitleLlmConfig;
+/** Select the provider-owned message subset from one fixed service revision. */
+export type SessionTitleLlmMessageSelector = (messages: readonly SessionTitleUserMessage[]) => readonly SessionTitleUserMessage[];
+/**
+ * Register one model-backed provider through the shared configuration and call policy.
+ * @param ctx - context exposing the title and LLM services.
+ * @param config - untrusted required deployment policy.
+ * @param id - stable plugin id recorded with generated titles.
+ * @param automatic - provider-owned automatic generation cadence.
+ * @param selectMessages - exact source-message selection for one revision.
+ */
+export declare function registerSessionTitleLlmProvider(ctx: Context, config: SessionTitleLlmConfig, id: string, automatic: SessionTitleAutomaticMode, selectMessages: SessionTitleLlmMessageSelector): void;
+/**
+ * Generate one title through the shared auxiliary LLM call.
+ * @param ctx - context exposing the registered LLM service.
+ * @param config - validated model-provider policy.
+ * @param request - service-owned session, route, message snapshot, and cancellation.
+ * @param selectedMessages - exact provider-selected subset to frame and attribute.
+ * @param titleProvider - registered title-provider identity recorded with the request.
+ * @returns normalized non-empty title, exact source seqs, and used model route.
+ */
+export declare function generateSessionTitleWithLlm(ctx: Context, config: ResolvedSessionTitleLlmConfig, request: SessionTitleProviderRequest, selectedMessages: readonly SessionTitleUserMessage[], titleProvider: SessionTitleProviderId): Promise<SessionTitleProviderResult>;
+//# 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-llm`.
+ * @module @deepseek-ai/dsh-session-title-llm/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "session-title-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,53 @@
+{
+  "name": "@deepseek-ai/dsh-session-title-llm",
+  "description": "Shared LLM generation policy for DeepSeek Harness session-title providers",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session/session-title-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"
+    },
+    "./src/*": "./src/*",
+    "./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.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  }
+}