@deepseek-ai/dsh-message-feedback 0.1.5-alpha.1 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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/feedback/message-feedback/README.md
-README.md: e1defa8d8fd6149f124267ffa0c382f4a82cf2ab
-README.zh.md: d16f8f4416288e5373e3221e8f43a8b2d84e5f80
+README.md: 4e75d167fe39c96002b32def24f447efdbc2be70
+README.zh.md: 0c21e26f9a4ffa40ce29412c652029d3af4e9fe0

package/README.md

@@ -1,5 +1,5 @@
 ---
-description: "Canonical Session-log ratings and notes for finalized assistant messages."
+description: "Canonical Session-log ratings, categories, and notes for finalized assistant messages."
 kind: "package-reference"
 ---
 
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-This service records positive or negative ratings and optional verbatim notes for finalized assistant messages. The canonical Session log owns every creation, edit, and deletion; `list`, `put`, and `delete` expose current feedback without constructing or waking an Agent. Feedback is log-only and does not enter model history.
+This service records positive or negative ratings, an optional category from the fixed feedback taxonomy, and optional verbatim notes for finalized assistant messages. The canonical Session log owns every creation, edit, and deletion; `list`, `put`, and `delete` expose current feedback without constructing or waking an Agent. Feedback is log-only and does not enter model history.
 
 ## Table of Contents
 
@@ -30,17 +30,17 @@ Mount `dsh-message-feedback` alongside `sessions` and `sessionPersistence`. It n
 |---|---|---|
 | `maxNoteBytes` | required | Positive safe-integer maximum UTF-8 bytes in one optional note. |
 
-A supplied note must contain a non-whitespace character and fit the configured byte limit. Blank notes return `note-blank`; oversized notes return `note-too-large`. Accepted text is preserved exactly, including surrounding whitespace. Omitting a note clears it. Note validation precedes Session lookup.
+A supplied note must contain a non-whitespace character and fit the configured byte limit. Blank notes return `note-blank`; oversized notes return `note-too-large`. Accepted text is preserved exactly, including surrounding whitespace. Omitting a note clears it. Note validation precedes Session lookup. A supplied category must be one of the [fixed feedback categories](../command-feedback/README.md#the-web-feedback-dialog); the Remote schema rejects any other value, and omitting the category clears it.
 
 ### Reading and changing feedback
 
 | Operation | Request | Success | Business failures |
 |---|---|---|---|
 | `list` | Session id | Current items in creation order | Session not found |
-| `put` | Session, message, rating, optional note, expected version | Current item | Session or target not found, version conflict, invalid note |
+| `put` | Session, message, rating, optional note, optional category, expected version | Current item | Session or target not found, version conflict, invalid note |
 | `delete` | Session, message, expected version | Item absent | Session not found, version conflict |
 
-Create with `ifVersion: null`; edit or delete with the returned version. Stale mutations return `version-conflict` and the current item. Each material put mints a fresh token and preserves the original creation time. A matching no-op put returns the same item without appending an event. Deleting an absent item succeeds regardless of the supplied version, without appending an event. Recreating a deleted item starts a new creation time and ordering position.
+Create with `ifVersion: null`; edit or delete with the returned version. Stale mutations return `version-conflict` and the current item. Each material put mints a fresh token and preserves the original creation time. A put that repeats the stored rating, note, and category is a no-op: it returns the same item without appending an event. Deleting an absent item succeeds regardless of the supplied version, without appending an event. Recreating a deleted item starts a new creation time and ordering position.
 
 Targets must be non-empty assistant messages produced by append-origin events. User messages, empty assistant placeholders, and replacement-origin messages return `target-not-found`. Feedback survives restart; a fork starts without owned feedback even when its inherited prefix contains parent feedback.
 

package/README.zh.md

@@ -1,5 +1,5 @@
 ---
-description: "在权威 Session 日志中保存已完成 assistant 消息的评分与备注。"
+description: "在权威 Session 日志中保存已完成 assistant 消息的评分、分类与备注。"
 kind: "package-reference"
 ---
 
@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-本服务为已完成的 assistant 消息记录好评、差评及可选的原样备注。每次创建、编辑和删除都由权威 Session 日志保存；`list`、`put` 和 `delete` 提供当前反馈，不会构造或唤醒 Agent。反馈仅写入日志，不进入模型历史。
+本服务为已完成的 assistant 消息记录好评、差评、固定反馈分类表中的可选分类，以及可选的原样备注。每次创建、编辑和删除都由权威 Session 日志保存；`list`、`put` 和 `delete` 提供当前反馈，不会构造或唤醒 Agent。反馈仅写入日志，不进入模型历史。
 
 ## 目录
 
@@ -30,17 +30,17 @@ kind: "package-reference"
 |---|---|---|
 | `maxNoteBytes` | 必填 | 单条可选备注的 UTF-8 字节上限，必须为正安全整数。 |
 
-提交的备注必须包含非空白字符，且不超过配置的字节上限。空白备注返回 `note-blank`；过长备注返回 `note-too-large`。通过校验的文本会完整保留，包括首尾空白。省略备注会清除它。备注校验先于 Session 查找。
+提交的备注必须包含非空白字符，且不超过配置的字节上限。空白备注返回 `note-blank`；过长备注返回 `note-too-large`。通过校验的文本会完整保留，包括首尾空白。省略备注会清除它。备注校验先于 Session 查找。提交的分类必须是[固定反馈分类](../command-feedback/README.zh.md#the-web-feedback-dialog)之一；Remote schema 拒绝其他值，省略分类会清除它。
 
 ### 读取与修改反馈
 
 | 操作 | 请求 | 成功 | 业务失败 |
 |---|---|---|---|
 | `list` | Session id | 按创建顺序返回当前条目 | Session 不存在 |
-| `put` | Session、消息、评分、可选备注、预期版本 | 当前条目 | Session 或目标不存在、版本冲突、备注无效 |
+| `put` | Session、消息、评分、可选备注、可选分类、预期版本 | 当前条目 | Session 或目标不存在、版本冲突、备注无效 |
 | `delete` | Session、消息、预期版本 | 条目不存在 | Session 不存在、版本冲突 |
 
-创建时传入 `ifVersion: null`；编辑或删除时使用返回的版本。陈旧修改返回 `version-conflict` 及当前条目。每次实质 put 都生成新 token，并保留原始创建时间。匹配的无变化 put 返回相同条目，不追加事件。删除不存在的条目始终成功，不受所传版本影响，也不追加事件。重新创建已删除条目会产生新的创建时间和排序位置。
+创建时传入 `ifVersion: null`；编辑或删除时使用返回的版本。陈旧修改返回 `version-conflict` 及当前条目。每次实质 put 都生成新 token，并保留原始创建时间。重复已存评分、备注与分类的 put 是无变化操作：返回相同条目，不追加事件。删除不存在的条目始终成功，不受所传版本影响，也不追加事件。重新创建已删除条目会产生新的创建时间和排序位置。
 
 目标必须是由 append 来源事件产生的非空 assistant 消息。用户消息、空 assistant 占位及 replacement 来源消息返回 `target-not-found`。反馈跨重启保留；fork 即使继承了包含父会话反馈的前缀，也从没有自有反馈开始。
 

package/lib/index.js

@@ -4,6 +4,7 @@ import { isDeepStrictEqual } from "node:util";
 import { Service } from "@deepseek-ai/cordis";
 import s from "@deepseek-ai/schemastery";
 import { z } from "zod";
+import { FEEDBACK_CATEGORIES } from "@deepseek-ai/dsh-command-feedback";
 import { SessionSeq } from "@deepseek-ai/dsh-session/types";
 import { deriveEventMessage, isAppendSurfaceEvent } from "@deepseek-ai/dsh-session/surface";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
@@ -55,6 +56,7 @@ const itemSchema = z.object({
 	messageId: z.string().min(1),
 	rating: z.enum(["positive", "negative"]),
 	note: z.string().refine((note) => note.trim().length > 0).optional(),
+	category: z.enum(FEEDBACK_CATEGORIES).optional(),
 	version: z.uuid(),
 	createdAt: timestamp,
 	updatedAt: timestamp
@@ -199,7 +201,7 @@ let MessageFeedbackService = (() => {
 				});
 				const existing = items.find((item) => item.messageId === request.messageId);
 				if (request.ifVersion !== (existing?.version ?? null)) return rejected(this.versionConflict(existing ?? null));
-				if (existing !== void 0 && existing.rating === request.rating && existing.note === note.value) {
+				if (existing !== void 0 && existing.rating === request.rating && existing.note === note.value && existing.category === request.category) {
 					await append();
 					return success(snapshotItem(existing));
 				}
@@ -208,6 +210,7 @@ let MessageFeedbackService = (() => {
 					messageId: request.messageId,
 					rating: request.rating,
 					...note.value === void 0 ? {} : { note: note.value },
+					...request.category === void 0 ? {} : { category: request.category },
 					version: randomUUID(),
 					createdAt: existing?.createdAt ?? now,
 					updatedAt: existing === void 0 ? now : Math.max(now, existing.updatedAt)

package/lib/typert.host.js

@@ -22,6 +22,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_delete_result$schema = z
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -38,6 +39,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_list_result$schema = z.u
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -55,6 +57,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_parameter_0$schema =
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'ifVersion': z.union([z.literal(null), z.intersection(z.string(), z.unknown())]).readonly(),
 })
 const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.union([z.object({
@@ -63,6 +66,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.un
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -82,6 +86,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.un
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -124,7 +129,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackDeleteResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_delete_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":203,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":207,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-message-feedback#messageFeedback/list',
@@ -149,7 +154,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackListResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_list_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":153,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":155,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-message-feedback#messageFeedback/put',
@@ -174,7 +179,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackPutResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":165,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":167,"column":3},
     },
   ],
   model: {
@@ -214,6 +219,10 @@ export const TYPERT = {
             "name": "Branded",
             "declaration": "export type Branded<B extends string> = string & { readonly [BRAND]: B; };"
           },
+          {
+            "name": "FeedbackCategory",
+            "declaration": "export type FeedbackCategory = 'task-result' | 'instruction-following' | 'product-interaction' | 'service-stability' | 'resource-cost' | 'security-privacy-permission' | 'other';"
+          },
           {
             "name": "MessageFeedbackDeleteRequest",
             "declaration": "export interface MessageFeedbackDeleteRequest {\n    readonly sessionId: SessionId;\n    readonly messageId: MessageId;\n    readonly ifVersion: MessageFeedbackVersion;\n}"
@@ -232,7 +241,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageFeedbackItem",
-            "declaration": "export interface MessageFeedbackItem {\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly version: MessageFeedbackVersion;\n    readonly createdAt: number;\n    readonly updatedAt: number;\n}"
+            "declaration": "export interface MessageFeedbackItem {\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly category?: FeedbackCategory;\n    readonly version: MessageFeedbackVersion;\n    readonly createdAt: number;\n    readonly updatedAt: number;\n}"
           },
           {
             "name": "MessageFeedbackListRequest",
@@ -256,7 +265,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageFeedbackPutRequest",
-            "declaration": "export interface MessageFeedbackPutRequest {\n    readonly sessionId: SessionId;\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly ifVersion: MessageFeedbackVersion | null;\n}"
+            "declaration": "export interface MessageFeedbackPutRequest {\n    readonly sessionId: SessionId;\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly category?: FeedbackCategory;\n    readonly ifVersion: MessageFeedbackVersion | null;\n}"
           },
           {
             "name": "MessageFeedbackPutResult",

package/lib/typert.remote-client.js

@@ -22,6 +22,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_delete_result$schema = z
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -38,6 +39,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_list_result$schema = z.u
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -55,6 +57,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_parameter_0$schema =
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'ifVersion': z.union([z.literal(null), z.intersection(z.string(), z.unknown())]).readonly(),
 })
 const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.union([z.object({
@@ -63,6 +66,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.un
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -82,6 +86,7 @@ const _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema = z.un
   'messageId': z.intersection(z.string(), z.unknown()).readonly(),
   'rating': z.union([z.literal("positive"), z.literal("negative")]).readonly(),
   'note': z.string().readonly().optional(),
+  'category': z.union([z.literal("other"), z.literal("task-result"), z.literal("instruction-following"), z.literal("product-interaction"), z.literal("service-stability"), z.literal("resource-cost"), z.literal("security-privacy-permission")]).readonly().optional(),
   'version': z.intersection(z.string(), z.unknown()).readonly(),
   'createdAt': z.number().readonly(),
   'updatedAt': z.number().readonly(),
@@ -121,7 +126,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackDeleteResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_delete_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":203,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":207,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-message-feedback#messageFeedback/list',
@@ -146,7 +151,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackListResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_list_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":153,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":155,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-message-feedback#messageFeedback/put',
@@ -171,7 +176,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-message-feedback/types#MessageFeedbackPutResult',
         schema: _deepseek_ai_dsh_message_feedback_messageFeedback_put_result$schema,
       },
-      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":165,"column":3},
+      sourceLocation: {"file":"packages/feedback/message-feedback/src/index.ts","line":167,"column":3},
     },
   ],
 }

package/lib/types/index.js

@@ -42,6 +42,7 @@ import { isDeepStrictEqual } from 'node:util';
 import { Service } from '@deepseek-ai/cordis';
 import s from '@deepseek-ai/schemastery';
 import { z } from 'zod';
+import { FEEDBACK_CATEGORIES } from '@deepseek-ai/dsh-command-feedback';
 import { SessionSeq } from '@deepseek-ai/dsh-session/types';
 import { deriveEventMessage, isAppendSurfaceEvent } from '@deepseek-ai/dsh-session/surface';
 import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol';
@@ -50,6 +51,7 @@ const itemSchema = z.object({
     messageId: z.string().min(1),
     rating: z.enum(['positive', 'negative']),
     note: z.string().refine(note => note.trim().length > 0).optional(),
+    category: z.enum(FEEDBACK_CATEGORIES).optional(),
     version: z.uuid(),
     createdAt: timestamp,
     updatedAt: timestamp,
@@ -160,7 +162,8 @@ let MessageFeedbackService = (() => {
                 if (request.ifVersion !== (existing?.version ?? null)) {
                     return rejected(this.versionConflict(existing ?? null));
                 }
-                if (existing !== undefined && existing.rating === request.rating && existing.note === note.value) {
+                if (existing !== undefined && existing.rating === request.rating && existing.note === note.value
+                    && existing.category === request.category) {
                     await append();
                     return success(snapshotItem(existing));
                 }
@@ -169,6 +172,7 @@ let MessageFeedbackService = (() => {
                     messageId: request.messageId,
                     rating: request.rating,
                     ...(note.value === undefined ? {} : { note: note.value }),
+                    ...(request.category === undefined ? {} : { category: request.category }),
                     version: randomUUID(),
                     createdAt: existing?.createdAt ?? now,
                     updatedAt: existing === undefined ? now : Math.max(now, existing.updatedAt),

package/lib/types/types.d.ts

@@ -7,6 +7,7 @@
 import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { MessageId } from '@deepseek-ai/dsh-llm/brand';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { FeedbackCategory } from '@deepseek-ai/dsh-command-feedback/types';
 /** Opaque compare-and-set token for one exact feedback item revision. */
 export type MessageFeedbackVersion = Branded<'MessageFeedbackVersion'>;
 /** The human's overall judgment of one assistant message. */
@@ -19,6 +20,8 @@ export interface MessageFeedbackItem {
     readonly rating: MessageFeedbackRating;
     /** Optional explanation, preserved verbatim after validation. */
     readonly note?: string;
+    /** Category the human filed a negative judgment under. */
+    readonly category?: FeedbackCategory;
     /** Equality-only token replaced by every material create or update. */
     readonly version: MessageFeedbackVersion;
     /** Host-assigned creation time in Unix epoch milliseconds. */
@@ -68,6 +71,8 @@ export interface MessageFeedbackPutRequest {
     readonly rating: MessageFeedbackRating;
     /** Optional non-blank explanation. */
     readonly note?: string;
+    /** Optional category; absent keeps the item uncategorized. */
+    readonly category?: FeedbackCategory;
     /** Observed item version, or `null` to require that no item exists. */
     readonly ifVersion: MessageFeedbackVersion | null;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-message-feedback",
   "description": "Canonical Session-log ratings and notes for finalized assistant messages",
-  "version": "0.1.5-alpha.1",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -44,12 +44,13 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-command-feedback": "^0.1.5-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2"
   },
   "dependencies": {
     "zod": "^4.4.3",
@@ -58,12 +59,13 @@
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-alpha.1"
+    "@deepseek-ai/dsh-command-feedback": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-alpha.2"
   }
 }