@shellraining/dsh-session-title-layout 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shellRaining
+
+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.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# dsh-session-title-layout
 
-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.
+会话标题版式提供者：`<type>：<摘要>`（如 `feat：重命名侧边栏会话标题`），分隔符、摘要语言、触发方式均可配。
+
+在 profile 或 home 的 cordis.patch.yml 覆盖配置：
+
+```yaml
+- id: session-title-layout
+  config:
+    preset: type-summary
+    separator: "："
+    summaryLanguage: 中文
+    automatic: all-prompts
+```
+
+## 安装
+
+```sh
+dsh plugin --profile web add @shellraining/dsh-session-title-layout
+```
+
+## 许可
+
+MIT

package/README.zh.md

@@ -0,0 +1,99 @@
+# dsh-session-title-layout
+
+[English](README.md) | 简体中文
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）的会话标题 provider。它让模型只生成标题中有意义的部分，再按你选的版式拼起来，例如：
+
+```text
+feat: add dark mode to settings
+feat：给设置页增加深色模式
+feat/261022/add dark mode to settings
+给设置页增加深色模式
+```
+
+标题最多由三段组成：
+
+| 段 | 由谁生成 | 说明 |
+|---|---|---|
+| `type` | 模型 | 从允许列表中选一个（`feat`、`fix` 等）。 |
+| `date` | 本插件 | 本地格式化，模型看不到。 |
+| `summary` | 模型 | 普通文本，不做 slug 化，语言可指定。 |
+
+只会向模型要求你用到的那几段。
+
+## 要求
+
+- dsh `>=0.2.1-rc.2 <0.3.0`
+- Node.js 20 及以上
+
+dsh 同一时间只允许一个异步标题 provider。本包的 bundle 会禁用自带的 `session-title-llm`，不要同时启用别的 provider（比如 all-prompts 那个 bundle）。
+
+## 安装
+
+在 Plugins 页面安装，或让 agent 调用 `plugin_manager` 的 `install_bundle`，目标为：
+
+```text
+git+https://github.com/shellRaining/dsh-session-title-layout.git
+```
+
+安装 bundle 会插入一行默认配置（`conventional` 版式）。要自定义，在 profile 的 `cordis.patch.yml` 里覆盖这一行：
+
+```yaml
+- id: session-title-layout
+  config:
+    preset: type-summary
+    separator: "："
+    summaryLanguage: 中文
+    automatic: all-prompts
+```
+
+如果你是按路径加载插件而不是安装 bundle，就自己插入这一行，`name` 指向 `lib/index.js`。两种方式不要同时用，否则行 id 会冲突。
+
+已安装包的代码更新后需要重启 dsh；配置变更按 profile 的 patch 重载模式生效。
+
+## 配置
+
+所有字段都可省略。
+
+| 字段 | 默认值 | 含义 |
+|---|---|---|
+| `preset` | `conventional` | `conventional` 为 `type/date/summary`，以 `/` 连接；`type-summary` 为 `type/summary`，以 `/` 连接；`summary` 只有摘要。 |
+| `segments` | 取自预设 | 有序列表，元素为 `type`、`date`、`summary`。必须含 `summary`，不可重复。 |
+| `separator` | 取自预设 | 段与段之间的文本，如 `": "` 或 `"："`。 |
+| `types` | `feat, fix, refactor, docs, chore, style, test, perf, build, ci, revert` | `type` 的允许值，比较时不区分大小写。 |
+| `dateFormat` | `YYMMDD` | 支持 `YYYY`、`YY`、`MM`、`DD`，使用本地时间。 |
+| `dateSource` | `session-created` | `session-created` 使重新生成标题时日期保持不变；`now` 用生成时刻。 |
+| `summaryMaxLength` | `40` | 摘要最多字符数，既写进 prompt 也对结果强制截断。 |
+| `summaryLanguage` | 跟随用户语言 | 摘要语言，如 `中文`、`English`。 |
+| `automatic` | `first-prompt` | `first-prompt` 只生成一次；`all-prompts` 随新消息重新生成。 |
+| `provider`、`model` | 会话主路由 | 生成标题用的辅助模型，要么都设要么都不设。 |
+| `maxInputChars` | `8000` | 发给模型的用户文本预算：第一条消息加能放下的最新几条，每条最多取 2000 字符。 |
+| `maxOutputTokens` | `2048` | 标题请求的输出 token 上限。 |
+| `timeoutMs` | `60000` | 标题请求的超时。 |
+
+配置无效时插件在激活阶段报错，并指出字段名。
+
+## 行为
+
+- 模型回复不可用（没有 JSON、没有 summary，或 `type` 不在允许列表）时本次调用失败，会话保留当前标题，不会猜一个。
+- 版式变更只影响之后生成的标题。已有标题以纯文本存于会话日志，不会被改写。
+- 标题仍会经过 dsh 自身的规范化和字节上限。
+
+## 隐私
+
+标题生成会把你的提示词发给所配置的模型路由。使用 `all-prompts` 时，每条新消息都会触发一次。请把 `provider` 和 `model` 指向你放心发送提示词的路由。
+
+## 开发
+
+```sh
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build   # 生成 lib/；lib/ 已提交，所以 git 安装无需构建
+```
+
+纯逻辑（配置、prompt、解析、渲染）在 `src/format.ts`，`src/index.ts` 只负责接到 dsh 上。
+
+## 许可证
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# DSH allows one asynchronous session-title provider at a time, so the
+# shipped model-backed provider is switched off in favour of this one.
+- id: session-title-llm
+  disabled: true
+
+- insert:
+    - id: session-title-layout
+      name: @shellraining/dsh-session-title-layout
+      config: {}

package/icon.svg

@@ -0,0 +1,6 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="4" y="7" width="28" height="22" rx="4" fill="#2F3B52" />
+  <rect x="8" y="12" width="9" height="4" rx="2" fill="#7CE0B0" />
+  <rect x="19" y="12" width="9" height="4" rx="2" fill="#E8EEF7" fill-opacity="0.9" />
+  <rect x="8" y="20" width="20" height="3" rx="1.5" fill="#E8EEF7" fill-opacity="0.45" />
+</svg>

package/lib/format.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Pure title-format logic: configuration, preset expansion, the model prompt,
+ * model-output parsing, and rendering. Nothing here touches the Harness, so it
+ * is unit-testable without a Cordis context.
+ */
+/** Parts a title can be assembled from. `summary` is the only mandatory one. */
+export declare const SEGMENTS: readonly ["type", "date", "summary"];
+export type Segment = (typeof SEGMENTS)[number];
+/** Built-in layouts. A preset only supplies defaults for `segments` and `separator`. */
+export declare const PRESETS: {
+    /** `feat/261022/add login flow` */
+    readonly conventional: {
+        readonly segments: readonly ["type", "date", "summary"];
+        readonly separator: "/";
+    };
+    /** `feat/add login flow` */
+    readonly "type-summary": {
+        readonly segments: readonly ["type", "summary"];
+        readonly separator: "/";
+    };
+    /** `add login flow` */
+    readonly summary: {
+        readonly segments: readonly ["summary"];
+        readonly separator: " ";
+    };
+};
+export type PresetName = keyof typeof PRESETS;
+export declare const DEFAULT_TYPES: readonly string[];
+export type DateSource = "session-created" | "now";
+export type AutomaticMode = "first-prompt" | "all-prompts";
+/** User-facing plugin configuration; every field is optional. */
+export interface Config {
+    /** Layout defaults. Default `conventional`. */
+    preset?: PresetName;
+    /** Explicit segment order; overrides the preset. Must contain `summary`. */
+    segments?: Segment[];
+    /** Text placed between segments; overrides the preset. */
+    separator?: string;
+    /** Allowed values of the `type` segment. Ignored when `type` is not a segment. */
+    types?: string[];
+    /** Tokens: YYYY YY MM DD. Default `YYMMDD`. Ignored when `date` is not a segment. */
+    dateFormat?: string;
+    /** Which instant `date` shows. `session-created` keeps it stable across regenerations. */
+    dateSource?: DateSource;
+    /** Soft cap, in characters, requested for the summary and enforced on the result. */
+    summaryMaxLength?: number;
+    /** Language the summary is written in, e.g. `中文` or `English`. Default: the language the user wrote in. */
+    summaryLanguage?: string;
+    /** When new prompts trigger regeneration. */
+    automatic?: AutomaticMode;
+    /** Auxiliary model route; both or neither. Default: the session's main route. */
+    provider?: string;
+    model?: string;
+    /** Budget, in characters, of user text sent to the model. */
+    maxInputChars?: number;
+    maxOutputTokens?: number;
+    timeoutMs?: number;
+}
+export interface ResolvedConfig {
+    readonly segments: readonly Segment[];
+    readonly separator: string;
+    readonly types: readonly string[];
+    readonly dateFormat: string;
+    readonly dateSource: DateSource;
+    readonly summaryMaxLength: number;
+    readonly summaryLanguage: string | undefined;
+    readonly automatic: AutomaticMode;
+    readonly route: {
+        readonly provider: string;
+        readonly model: string;
+    } | undefined;
+    readonly maxInputChars: number;
+    readonly maxOutputTokens: number;
+    readonly timeoutMs: number;
+}
+/** Validate user configuration and expand the preset. Throws on any invalid field. */
+export declare function resolveConfig(config?: Config): ResolvedConfig;
+/** System prompt asking only for the model-written segments (`type`, `summary`). */
+export declare function buildSystemPrompt(config: ResolvedConfig): string;
+/** The model-written parts of a title. */
+export interface ModelParts {
+    readonly type: string | undefined;
+    readonly summary: string;
+}
+/**
+ * Parse the model reply. Throws when it is unusable, so the caller keeps the
+ * previous title instead of writing a guess.
+ */
+export declare function parseModelOutput(raw: string, config: ResolvedConfig): ModelParts;
+/** Format an epoch-millisecond instant in local time using YYYY, YY, MM, DD tokens. */
+export declare function formatDate(epochMs: number, format: string): string;
+/** Join the enabled segments in configured order. `date` is rendered by the caller's clock. */
+export declare function renderTitle(parts: ModelParts, dateText: string, config: ResolvedConfig): string;
+/**
+ * Choose which messages to send: the first one, then the newest that fit the
+ * character budget. Returned in log order.
+ */
+export declare function selectMessages<T extends {
+    readonly text: string;
+}>(messages: readonly T[], budget: number, perMessageLimit?: number): {
+    message: T;
+    text: string;
+}[];

package/lib/format.js

@@ -0,0 +1,203 @@
+/**
+ * Pure title-format logic: configuration, preset expansion, the model prompt,
+ * model-output parsing, and rendering. Nothing here touches the Harness, so it
+ * is unit-testable without a Cordis context.
+ */
+/** Parts a title can be assembled from. `summary` is the only mandatory one. */
+export const SEGMENTS = ["type", "date", "summary"];
+/** Built-in layouts. A preset only supplies defaults for `segments` and `separator`. */
+export const PRESETS = {
+    /** `feat/261022/add login flow` */
+    conventional: { segments: ["type", "date", "summary"], separator: "/" },
+    /** `feat/add login flow` */
+    "type-summary": { segments: ["type", "summary"], separator: "/" },
+    /** `add login flow` */
+    summary: { segments: ["summary"], separator: " " },
+};
+export const DEFAULT_TYPES = [
+    "feat",
+    "fix",
+    "refactor",
+    "docs",
+    "chore",
+    "style",
+    "test",
+    "perf",
+    "build",
+    "ci",
+    "revert",
+];
+function positiveInt(value, fallback, label) {
+    const resolved = value ?? fallback;
+    if (!Number.isSafeInteger(resolved) || resolved < 1) {
+        throw new Error(`session-title-layout: ${label} must be a positive safe integer`);
+    }
+    return resolved;
+}
+/** Validate user configuration and expand the preset. Throws on any invalid field. */
+export function resolveConfig(config = {}) {
+    const presetName = config.preset ?? "conventional";
+    const preset = Object.hasOwn(PRESETS, presetName) ? PRESETS[presetName] : undefined;
+    if (preset === undefined) {
+        throw new Error(`session-title-layout: unknown preset "${String(presetName)}"`);
+    }
+    const segments = config.segments ?? preset.segments;
+    if (segments.length === 0 || new Set(segments).size !== segments.length) {
+        throw new Error("session-title-layout: segments must be non-empty and unique");
+    }
+    for (const segment of segments) {
+        if (!SEGMENTS.includes(segment)) {
+            throw new Error(`session-title-layout: unknown segment "${String(segment)}"`);
+        }
+    }
+    if (!segments.includes("summary")) {
+        throw new Error('session-title-layout: segments must include "summary"');
+    }
+    const types = (config.types ?? DEFAULT_TYPES).map((type) => type.trim().toLowerCase());
+    if (segments.includes("type") && (types.length === 0 || types.some((type) => type === ""))) {
+        throw new Error("session-title-layout: types must contain non-empty strings");
+    }
+    const automatic = config.automatic ?? "first-prompt";
+    if (automatic !== "first-prompt" && automatic !== "all-prompts") {
+        throw new Error('session-title-layout: automatic must be "first-prompt" or "all-prompts"');
+    }
+    const summaryLanguage = config.summaryLanguage?.trim();
+    if (config.summaryLanguage !== undefined && summaryLanguage === "") {
+        throw new Error("session-title-layout: summaryLanguage must not be empty");
+    }
+    const dateSource = config.dateSource ?? "session-created";
+    if (dateSource !== "session-created" && dateSource !== "now") {
+        throw new Error('session-title-layout: dateSource must be "session-created" or "now"');
+    }
+    if ((config.provider === undefined) !== (config.model === undefined)) {
+        throw new Error("session-title-layout: provider and model must be set together");
+    }
+    return {
+        segments,
+        separator: config.separator ?? preset.separator,
+        types,
+        dateFormat: config.dateFormat ?? "YYMMDD",
+        dateSource,
+        summaryMaxLength: positiveInt(config.summaryMaxLength, 40, "summaryMaxLength"),
+        summaryLanguage,
+        automatic,
+        route: config.provider !== undefined && config.model !== undefined
+            ? { provider: config.provider, model: config.model }
+            : undefined,
+        maxInputChars: positiveInt(config.maxInputChars, 8000, "maxInputChars"),
+        maxOutputTokens: positiveInt(config.maxOutputTokens, 2048, "maxOutputTokens"),
+        timeoutMs: positiveInt(config.timeoutMs, 60_000, "timeoutMs"),
+    };
+}
+/** System prompt asking only for the model-written segments (`type`, `summary`). */
+export function buildSystemPrompt(config) {
+    const wantsType = config.segments.includes("type");
+    const shape = wantsType ? '{"type": "...", "summary": "..."}' : '{"summary": "..."}';
+    const lines = [
+        "Generate a title for an AI coding-assistant session from the user's messages.",
+        `Reply with ONLY one JSON object of exactly this shape, with no code fence and no commentary: ${shape}`,
+    ];
+    if (wantsType) {
+        lines.push(`- "type" is exactly one of: ${config.types.join(", ")}.`);
+    }
+    lines.push(`- "summary" is a short plain phrase, at most ${config.summaryMaxLength} characters, that lets a reader tell what the session is about.`, config.summaryLanguage === undefined
+        ? '- Write "summary" in the language the user wrote in. No Markdown, no surrounding quotes, no trailing punctuation.'
+        : `- Write "summary" in ${config.summaryLanguage}, whatever language the user wrote in. No Markdown, no surrounding quotes, no trailing punctuation.`, "Do not reason or explain. Output the JSON object immediately.");
+    return lines.join("\n");
+}
+function truncateChars(input, max) {
+    const chars = Array.from(input);
+    return chars.length <= max ? input : chars.slice(0, max).join("").trimEnd();
+}
+function cleanSummary(input, max) {
+    const collapsed = input.replace(/\s+/gu, " ").trim();
+    const unquoted = collapsed.replace(/^["'`“”‘’]+|["'`“”‘’]+$/gu, "").trim();
+    return truncateChars(unquoted, max);
+}
+/**
+ * Parse the model reply. Throws when it is unusable, so the caller keeps the
+ * previous title instead of writing a guess.
+ */
+export function parseModelOutput(raw, config) {
+    const start = raw.indexOf("{");
+    const end = raw.lastIndexOf("}");
+    if (start === -1 || end <= start) {
+        throw new Error("session-title-layout: model reply contains no JSON object");
+    }
+    let value;
+    try {
+        value = JSON.parse(raw.slice(start, end + 1));
+    }
+    catch {
+        throw new Error("session-title-layout: model reply is not valid JSON");
+    }
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("session-title-layout: model reply is not a JSON object");
+    }
+    const record = value;
+    const summary = typeof record["summary"] === "string"
+        ? cleanSummary(record["summary"], config.summaryMaxLength)
+        : "";
+    if (summary === "") {
+        throw new Error("session-title-layout: model reply has no summary");
+    }
+    let type;
+    if (config.segments.includes("type")) {
+        const candidate = typeof record["type"] === "string" ? record["type"].trim().toLowerCase() : "";
+        if (!config.types.includes(candidate)) {
+            throw new Error(`session-title-layout: model reply type "${candidate}" is not allowed`);
+        }
+        type = candidate;
+    }
+    return { type, summary };
+}
+/** Format an epoch-millisecond instant in local time using YYYY, YY, MM, DD tokens. */
+export function formatDate(epochMs, format) {
+    const date = new Date(epochMs);
+    const year = String(date.getFullYear());
+    const values = {
+        YYYY: year,
+        YY: year.slice(-2),
+        MM: String(date.getMonth() + 1).padStart(2, "0"),
+        DD: String(date.getDate()).padStart(2, "0"),
+    };
+    return format.replace(/YYYY|YY|MM|DD/gu, (token) => values[token] ?? token);
+}
+/** Join the enabled segments in configured order. `date` is rendered by the caller's clock. */
+export function renderTitle(parts, dateText, config) {
+    const pieces = config.segments.map((segment) => {
+        switch (segment) {
+            case "type":
+                return parts.type ?? "";
+            case "date":
+                return dateText;
+            case "summary":
+                return parts.summary;
+        }
+    });
+    return pieces.join(config.separator);
+}
+/**
+ * Choose which messages to send: the first one, then the newest that fit the
+ * character budget. Returned in log order.
+ */
+export function selectMessages(messages, budget, perMessageLimit = 2000) {
+    const clip = (message) => ({ message, text: message.text.slice(0, perMessageLimit) });
+    const first = messages[0];
+    if (first === undefined)
+        return [];
+    const chosen = [clip(first)];
+    let used = chosen[0]?.text.length ?? 0;
+    const tail = [];
+    for (let index = messages.length - 1; index > 0; index -= 1) {
+        const message = messages[index];
+        if (message === undefined)
+            continue;
+        const entry = clip(message);
+        if (used + entry.text.length > budget)
+            break;
+        used += entry.text.length;
+        tail.unshift(entry);
+    }
+    return [...chosen, ...tail];
+}

package/lib/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session-title provider that asks the model for the meaningful parts of a
+ * title (an optional `type` and a plain-language `summary`) and assembles them
+ * with the segments, separator and date format the user configured.
+ *
+ * When the model reply is unusable the call throws, and the session service
+ * keeps whatever title it already has.
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import { type Config } from "./format.ts";
+export type { Config } from "./format.ts";
+export declare const name = "session-title-layout";
+export declare const inject: string[];
+export declare function apply(ctx: Context, rawConfig?: Config): void;

package/lib/index.js

@@ -0,0 +1,72 @@
+import { buildSystemPrompt, formatDate, parseModelOutput, renderTitle, resolveConfig, selectMessages, } from "./format.js";
+export const name = "session-title-layout";
+export const inject = ["sessionTitle", "llm"];
+// The brand constructor is an identity function; a cast keeps the built output
+// free of runtime imports from Harness packages.
+const PROVIDER_ID = name;
+async function collectText(stream) {
+    let text = "";
+    for await (const chunk of stream) {
+        if (chunk.type === "text-delta") {
+            text += chunk.text;
+        }
+        else if (chunk.type === "finish") {
+            const reason = chunk.reason;
+            if (reason.kind === "error" || reason.kind === "aborted") {
+                throw new Error(`${name}: title model call failed: ${reason.failure.message}`);
+            }
+            if (reason.kind !== "stop" && reason.kind !== "max-tokens") {
+                throw new Error(`${name}: unexpected finish reason "${reason.kind}"`);
+            }
+        }
+    }
+    return text;
+}
+function resolveRoute(config, request) {
+    const route = config.route ?? request.route;
+    if (route === undefined) {
+        throw new Error(`${name}: no model route; set provider and model in the plugin config`);
+    }
+    return { provider: route.provider, model: route.model };
+}
+async function generate(ctx, config, request) {
+    const route = resolveRoute(config, request);
+    const selected = selectMessages(request.messages, config.maxInputChars);
+    if (selected.length === 0) {
+        throw new Error(`${name}: no eligible messages`);
+    }
+    const input = {
+        role: "user",
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(selected.map((entry) => ({ text: entry.text }))),
+            },
+        ],
+    };
+    const stream = ctx.llm.stream({
+        provider: route.provider,
+        model: route.model,
+        messages: [input],
+        system: buildSystemPrompt(config),
+        maxTokens: config.maxOutputTokens,
+        sessionId: request.session.id,
+        purpose: "session-title",
+        signal: AbortSignal.any([request.signal, AbortSignal.timeout(config.timeoutMs)]),
+    });
+    const parts = parseModelOutput(await collectText(stream), config);
+    const dateInstant = config.dateSource === "now" ? Date.now() : request.session.header.createdAt;
+    return {
+        title: renderTitle(parts, formatDate(dateInstant, config.dateFormat), config),
+        messageSeqs: selected.map((entry) => entry.message.seq),
+        model: route,
+    };
+}
+export function apply(ctx, rawConfig = {}) {
+    const config = resolveConfig(rawConfig);
+    ctx.effect(() => ctx.sessionTitle.register({
+        id: PROVIDER_ID,
+        automatic: config.automatic,
+        generate: (request) => generate(ctx, config, request),
+    }), `${name}: provider`);
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Session title layout",
+    "description": "Names sessions with a configurable layout such as \"feat: summary\", in the language you choose."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "会话标题版式",
+    "description": "按可配置的版式（如“feat：摘要”）为会话命名，摘要语言可指定。"
+  }
+}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@shellraining/dsh-session-title-layout",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "DeepSeek Harness session-title provider with a configurable layout (type, date, summary), separator and summary language.",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "session-title"
+  ],
+  "author": "shellRaining",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shellRaining/dsh-plugins.git",
+    "directory": "plugins/session-title-layout"
+  },
+  "homepage": "https://github.com/shellRaining/dsh-plugins/tree/main/plugins/session-title-layout#readme",
+  "bugs": "https://github.com/shellRaining/dsh-plugins/issues",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-title": "0.2.1-rc.2",
+    "@types/node": "^24.19.2",
+    "typescript": "5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "node --test test/*.test.ts"
+  }
 }