@prettier-ai/dsh-client-ui-message-feedback 0.1.2-alpha.1

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Message feedback surface plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,26 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-message-feedback`.
+* @module @prettier-ai/dsh-client-ui-message-feedback/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-message-feedback";
+/** Cordis companion plugin name. */
+const name = "client-ui-feedback-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the plugin owns one slot registration and one
+* per-session controller map, both released by the same effect disposer. The
+* lifecycle spec proves the registration is withdrawn and every controller is
+* dropped when the owning fiber is disposed, so no second authority exists to
+* check at runtime.
+*/
+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/client/MessageFeedbackActions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Per-message feedback controls: a Like/Dislike pair plus an optional note.
+ * The buttons render inside the assistant message's IconActions row, so they
+ * reuse that row's chrome and sit between copy and branch. The note editor is
+ * a popover (portaled to `document.body`) anchored to the note trigger, not an
+ * inline expansion: a 260px textarea plus buttons cannot fit the row at any
+ * viewport, and an inline element pushed the branch action and clock out of the
+ * conversation column. Portaling out of the column also escapes its `overflow`
+ * clip, so the panel cannot be cropped or detached from the message it annotates.
+ * @module @prettier-ai/dsh-client-ui-message-feedback/client/MessageFeedbackActions
+ */
+import type { MessageFeedbackActionProps } from './slots.ts';
+/**
+ * One message's feedback controls.
+ * @param props - the owner's message identity, the injected verbs, and the
+ * shared feedback hook.
+ * @returns the rating buttons and the note trigger, with the note editor
+ * portal-open beneath the trigger while it is open.
+ */
+export declare function MessageFeedbackActions({ messageId, ensure, rate, toggle, clearNote, useFeedback, t }: MessageFeedbackActionProps): import("react").JSX.Element;
+//# sourceMappingURL=MessageFeedbackActions.d.ts.map

package/lib/types/client/controller.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Browser-local object layer over one Session's durable message-feedback
+ * sidecar. The Host owns per-item compare-and-set: every mutation carries the
+ * version this controller last observed, and a `version-conflict` reply carries
+ * the authoritative item, so a lost race reconciles from the reply itself
+ * instead of refetching the whole Session.
+ * @module @prettier-ai/dsh-client-ui-message-feedback/client/controller
+ */
+import type { RemoteResult } from '@prettier-ai/dsh-typert-protocol';
+import type { HostObservable } from '@prettier-ai/dsh-client-ui-slots';
+import type { MessageId } from '@prettier-ai/dsh-client-connection/client';
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+import type { MessageFeedbackDeleteResult, MessageFeedbackItem, MessageFeedbackListResult, MessageFeedbackPutResult, MessageFeedbackRating } from '@prettier-ai/dsh-message-feedback/types';
+/**
+ * The three Remote calls this controller needs. The generated face wraps every
+ * business result in {@link RemoteResult}: a carrier failure arrives as the
+ * `ok: false` branch rather than a rejection, so this controller reads one
+ * envelope and never wraps a call to recover a transport error.
+ */
+export interface MessageFeedbackRemote {
+    list: (request: {
+        sessionId: SessionId;
+    }) => Promise<RemoteResult<MessageFeedbackListResult>>;
+    put: (request: {
+        sessionId: SessionId;
+        messageId: MessageId;
+        rating: MessageFeedbackRating;
+        note?: string;
+        ifVersion: MessageFeedbackItem['version'] | null;
+    }) => Promise<RemoteResult<MessageFeedbackPutResult>>;
+    delete: (request: {
+        sessionId: SessionId;
+        messageId: MessageId;
+        ifVersion: MessageFeedbackItem['version'];
+    }) => Promise<RemoteResult<MessageFeedbackDeleteResult>>;
+}
+/** Load state of the one list read that seeds every per-message control. */
+export type MessageFeedbackStatus = 'cold' | 'loading' | 'ready' | 'error';
+/** Immutable view published to every per-message control in one Session. */
+export interface MessageFeedbackView {
+    status: MessageFeedbackStatus;
+    /** Current item per message, keyed by the addressed message id. */
+    items: ReadonlyMap<MessageId, MessageFeedbackItem>;
+    /** Reason the last load failed, cleared by the next successful load. */
+    error: string | null;
+}
+/** Settled action shape rendered by the message-level controls. */
+export type MessageFeedbackActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * Per-session feedback object layer. One instance backs every per-message
+ * control in that Session, so a single list read seeds them all.
+ */
+export declare class MessageFeedbackController implements HostObservable<MessageFeedbackView> {
+    private readonly remote;
+    private readonly sessionId;
+    private view;
+    private readonly listeners;
+    private loadPromise;
+    private operationTail;
+    private disposed;
+    /**
+     * @param remote - the messageFeedback Remote namespace.
+     * @param sessionId - Session owning every addressed assistant message.
+     */
+    constructor(remote: MessageFeedbackRemote, sessionId: SessionId);
+    /** Return the cached immutable view. */
+    getSnapshot: () => MessageFeedbackView;
+    /** Subscribe to view replacement. */
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * Load once; a failed load stays retryable.
+     * @returns the settled load result, shared by concurrent callers.
+     */
+    ensure(): Promise<MessageFeedbackActionResult>;
+    /**
+     * Re-read the authoritative list, collapsing concurrent callers onto one
+     * in-flight read.
+     *
+     * This is the unserialized read used to seed a cold controller, where no
+     * mutation can be in flight yet. A reconnect must use {@link resync} instead:
+     * an unserialized list response can otherwise arrive after a newer mutation's
+     * reply and overwrite the version that mutation just committed.
+     * @returns the settled reload result.
+     */
+    refresh(): Promise<MessageFeedbackActionResult>;
+    /**
+     * Re-read the list behind this Session's queued mutations, so a reconnect
+     * cannot resurrect a version an in-flight mutation already replaced.
+     * @returns the settled reload result.
+     */
+    resync(): Promise<MessageFeedbackActionResult>;
+    /**
+     * Create or replace feedback for one message, comparing against the version
+     * this controller last observed.
+     *
+     * The note is resolved here rather than by the caller: `mutate` awaits the
+     * one list read first, so this body always sees the committed item, while a
+     * control that rendered before that read completed would still be holding
+     * `undefined`. Omitting `note` therefore keeps whatever is stored; only
+     * {@link clearNote} removes one.
+     * @param messageId - target assistant message.
+     * @param rating - desired judgment.
+     * @param note - replacement explanation; omitted keeps the stored note.
+     * @returns the settled mutation result.
+     */
+    rate(messageId: MessageId, rating: MessageFeedbackRating, note?: string): Promise<MessageFeedbackActionResult>;
+    /**
+     * Replace one message's rating with the opposite judgment, or retract it when
+     * the committed rating already matches. The decision reads the committed item
+     * inside the serialized mutation, so a click that lands before the first list
+     * read still toggles against the stored value rather than the empty view a
+     * cold control rendered.
+     * @param messageId - target assistant message.
+     * @param rating - the judgment the human asked for.
+     * @returns the settled mutation result.
+     */
+    toggle(messageId: MessageId, rating: MessageFeedbackRating): Promise<MessageFeedbackActionResult>;
+    /**
+     * Drop the note while keeping the rating. Absent feedback needs no call.
+     * @param messageId - target assistant message.
+     * @returns the settled mutation result.
+     */
+    clearNote(messageId: MessageId): Promise<MessageFeedbackActionResult>;
+    /**
+     * Remove feedback for one message. A message with no known item is already
+     * in the requested state, so no call is made.
+     * @param messageId - target assistant message.
+     * @returns the settled mutation result.
+     */
+    clear(messageId: MessageId): Promise<MessageFeedbackActionResult>;
+    /** Commit one put against the observed version and reconcile a conflict. */
+    private putCommitted;
+    /** Commit one delete against the observed version and reconcile a conflict. */
+    private deleteCommitted;
+    /** Drop subscribers and refuse further work when the owning fiber unloads. */
+    dispose(): void;
+    /** Fetch the whole sidecar and publish it as the seeded view. */
+    private load;
+    /**
+     * Serialize one mutation behind this Session's prior mutation so queued
+     * operations always compare against the committed version, and translate a
+     * transport throw into the same settled shape the controls already render.
+     */
+    private mutate;
+    /**
+     * Replace one message's entry, keeping every other entry's identity. Only a
+     * `mutate` operation reaches this, and `mutate` refuses admission once the
+     * controller is disposed, so no disposal guard belongs here; `publish` is
+     * the single place that stops notifying after listeners are dropped.
+     */
+    private commit;
+    /** Replace the view and contain subscriber failures at the observable boundary. */
+    private publish;
+}
+//# sourceMappingURL=controller.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Message feedback plugin, browser half: the Like/Dislike entry in the
+ * conversation.chat.assistant-actions strip. One MessageFeedbackController per
+ * Session backs every message control in that Session, so a single list read
+ * seeds the whole transcript. Mutations go through the generated
+ * messageFeedback Remote; the Host owns per-item compare-and-set.
+ * @module @prettier-ai/dsh-client-ui-message-feedback/client
+ */
+import type { Context as ClientContext } from '@prettier-ai/cordis';
+export type { MessageFeedbackActionResult, MessageFeedbackStatus, MessageFeedbackView, MessageFeedbackRemote, } from './controller.ts';
+export type { MessageFeedbackActionProps, MessageFeedbackInjected } from './slots.ts';
+export type { MessageFeedbackKey } from './locales.ts';
+/** Required services: the slot registry, the Remote namespace, and the copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: the per-message feedback entry and its per-session
+ * object layer.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,42 @@
+/** `feedback` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'action.like': string;
+    'action.likeActive': string;
+    'action.dislike': string;
+    'action.dislikeActive': string;
+    'note.open': string;
+    'note.dialog': string;
+    'note.placeholder': string;
+    'note.save': string;
+    'note.cancel': string;
+    'note.aria': string;
+    'error.conflict': string;
+    'error.load': string;
+    'error.generic': string;
+};
+/** The feedback namespace key union. */
+export type MessageFeedbackKey = keyof typeof zh;
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The per-message feedback controls' copy. */
+        feedback: MessageFeedbackKey;
+    }
+}
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'action.like': string;
+    'action.likeActive': string;
+    'action.dislike': string;
+    'action.dislikeActive': string;
+    'note.open': string;
+    'note.dialog': string;
+    'note.placeholder': string;
+    'note.save': string;
+    'note.cancel': string;
+    'note.aria': string;
+    'error.conflict': string;
+    'error.load': string;
+    'error.generic': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/slots.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The feedback entry's injected face. The target
+ * 'conversation.chat.assistant-actions' slot is declared and typed by
+ * ui-conversation; this package only contributes the entry, so no SlotMap
+ * merge lives here. Live per-message state arrives through the `feedback`
+ * hook (the framework standard kit binds it into `useFeedback`); inject
+ * carries the two mutation verbs plus the lazy loader.
+ * @module @prettier-ai/dsh-client-ui-message-feedback/client/slots
+ */
+import type { HostObservable, InjectFace, PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+import type { MessageId } from '@prettier-ai/dsh-client-connection/client';
+import type { MessageFeedbackRating } from '@prettier-ai/dsh-message-feedback/types';
+import type { MessageFeedbackActionResult, MessageFeedbackView } from './controller.ts';
+/** Injected business face of one assistant-message feedback entry. */
+export interface MessageFeedbackInjected {
+    hooks: {
+        /** The owning Session's feedback view, shared by every message control. */
+        feedback: HostObservable<MessageFeedbackView>;
+    };
+    /** Load the Session's feedback once, on first interaction. */
+    ensure: () => Promise<MessageFeedbackActionResult>;
+    /**
+     * Create or replace this Session's feedback for one message.
+     * @param messageId - target assistant message.
+     * @param rating - desired judgment.
+     * @param note - optional explanation.
+     */
+    rate: (messageId: MessageId, rating: MessageFeedbackRating, note?: string) => Promise<MessageFeedbackActionResult>;
+    /**
+     * Apply the requested judgment, retracting instead when the committed rating
+     * already matches. The controller decides from the committed item, so a click
+     * before the first list read still toggles the stored value.
+     * @param messageId - target assistant message.
+     * @param rating - the judgment the human asked for.
+     */
+    toggle: (messageId: MessageId, rating: MessageFeedbackRating) => Promise<MessageFeedbackActionResult>;
+    /**
+     * Drop the note while keeping the rating.
+     * @param messageId - target assistant message.
+     */
+    clearNote: (messageId: MessageId) => Promise<MessageFeedbackActionResult>;
+    /**
+     * Remove this Session's feedback for one message.
+     * @param messageId - target assistant message.
+     */
+    clear: (messageId: MessageId) => Promise<MessageFeedbackActionResult>;
+}
+/** Full props of one assistant-message feedback entry. */
+export type MessageFeedbackActionProps = PropsRuntime<'conversation.chat.assistant-actions'> & InjectFace<MessageFeedbackInjected> & PropsLocale<'feedback'>;
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Message feedback surface plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-message-feedback`.
+ * @module @prettier-ai/dsh-client-ui-message-feedback/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-feedback-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,90 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-message-feedback",
+  "description": "Per-message feedback controls contributed to the assistant-message action strip, backed by the messageFeedback Host Remote",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-message-feedback"
+  },
+  "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"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-api-remotes",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-conversation",
+        "@prettier-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-message-feedback": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-message-feedback": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}