@linxin666/dsh-pet 0.1.20 → 0.2.1

package/lib/types/routes.js

@@ -12,6 +12,7 @@ import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { petEntryView } from './registry.js';
+import { isLoopbackRequest } from './loopback.js';
 /** Browser-facing base path of the pet API. */
 export const PET_API_PREFIX = '/api/pet';
 /** Browser-facing base path of the pet asset routes ('/pet/<id>/...'). */
@@ -75,12 +76,21 @@ function readJsonBody(req) {
         req.on('error', reject);
     });
 }
+/** Shared route fence: the browser UI is a loopback client; LAN hosts stay out. */
+function guard(req, res) {
+    if (isLoopbackRequest(req))
+        return true;
+    json(res, 403, { ok: false, error: 'forbidden: loopback-only' });
+    return false;
+}
 /** Wrap one async service call as a GET JSON route. */
 function getRoute(path, run) {
     return {
         kind: 'exact',
         path,
         handler: (req, res) => {
+            if (!guard(req, res))
+                return;
             if (!requireMethod(req, res, 'GET'))
                 return;
             run().then((value) => json(res, 200, value), (error) => {
@@ -95,6 +105,8 @@ function postRoute(path, run) {
         kind: 'exact',
         path,
         handler: (req, res) => {
+            if (!guard(req, res))
+                return Promise.resolve();
             if (!requireMethod(req, res, 'POST'))
                 return Promise.resolve();
             return readJsonBody(req).then((body) => {
@@ -127,6 +139,8 @@ function dirAliases(registry) {
 function assetHandler(registry) {
     const aliases = dirAliases(registry);
     return (req, res) => {
+        if (!guard(req, res))
+            return;
         if (req.method !== 'GET' && req.method !== 'HEAD') {
             res.writeHead(405);
             res.end();

package/lib/types/service.d.ts

@@ -113,6 +113,12 @@ export interface PetStateView {
         /** Stock cap. */
         max: number;
     };
+    /**
+     * The display session's fresh inner whisper (碎碎念), when one is within
+     * its TTL — short inner-voice copy woken by the model's own output,
+     * rendered by the client as a distinct whisper bubble.
+     */
+    whisper?: string;
 }
 /** Result of `pet.interact`. */
 export type PetInteractResult = LedgerInteractionResult;

package/lib/types/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQ9C,OAAO,EAAgC,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EASL,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAA;AACrB,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAGL,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAA;AAEnB,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAClC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC/B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,2HAA2H;AAC3H,eAAO,MAAM,sBAAsB,QAAQ,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;IACxC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CACjC;AAED,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAChC,aAAa,EAAE,OAAO,CAAA;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAC3B,gCAAgC;IAChC,QAAQ,EAAE,eAAe,CAAA;IACzB,6BAA6B;IAC7B,OAAO,EAAE,gBAAgB,CAAA;IACzB,4CAA4C;IAC5C,GAAG,EAAE;QACH,mBAAmB;QACnB,EAAE,EAAE,MAAM,CAAA;QACV,iDAAiD;QACjD,WAAW,EAAE,MAAM,CAAA;QACnB,4BAA4B;QAC5B,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,MAAM,EAAE;QACN,0BAA0B;QAC1B,OAAO,EAAE,MAAM,CAAA;QACf,iBAAiB;QACjB,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;CACF;AAED,gCAAgC;AAChC,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAEvD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,GAAG,EAAE,UAAU,CAAA;KAChB;CACF;AAUD;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,OAAO;IACrC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAK;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAA0B;IACjD,kFAAkF;IAClF,OAAO,CAAC,cAAc,CAAqB;IAC3C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE,YAAY,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,SAAc,EA6B/C;IAED,uEAAuE;IACvE,SAAS,IAAI,OAAO,CAEnB;IAED,uCAAuC;IACjC,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAEnC;IAED,yDAAyD;IACzD,OAAO,IAAI,gBAAgB,CAE1B;IAED,2EAA2E;IACrE,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAErC;IAED,gEAAgE;IAChE,gBAAgB,IAAI,WAAW,CAE9B;IAED,yCAAyC;IACzC,WAAW,IAAI,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAEzD;IAED,6CAA6C;IAC7C,aAAa,IAAI,MAAM,CAEtB;IAED,yEAAyE;IACzE,OAAO,CAAC,KAAK,GAAE,MAA6B,GAAG,MAAM,CAIpD;IAED,4EAA4E;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAQjG;IAED,uEAAuE;IACvE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGjC;IAED,OAAO,CAAC,YAAY;IA4DpB,0EAA0E;IAC1E,OAAO,CAAC,UAAU;IAYlB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoBrB,gCAAgC;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK/D;IAED,iCAAiC;IAC3B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAKnF;IAED,wFAAwF;IAClF,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC,CASlG;IAED,2EAA2E;IACrE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAO9F;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAiBtD;IAED,oFAAoF;IACpF,OAAO,CAAC,mBAAmB;IAe3B,qFAAqF;IACrF,OAAO,CAAC,UAAU;IAIlB,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;IA6CZ,OAAO,CAAC,KAAK;CAOd"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}

package/lib/types/service.js

@@ -16,6 +16,7 @@ import { emptyProjectionRuntime, isActivityPhase, projectOfficialEvent, } from '
 import { PetLedger } from './ledger.js';
 import { DEFAULT_PET_NAME, DISPLAY_INSET_MAX, DISPLAY_SIZE_MAX, DISPLAY_SIZE_MIN, PET_NAME_MAX_LENGTH, loadPetPersist, petHomeDir, savePetPersist, } from './persist.js';
 import { loadPetRegistry, petEntryView, petPackageRoot, } from './registry.js';
+import { WHISPER_TTL_MS } from './chatter.js';
 import { defaultPetStateConfig, PetStateMachine, } from './state.js';
 /** Settings namespace of the pet capability. Spelled here rather than imported: the browser half spells the same value. */
 export const PET_SETTINGS_NAMESPACE = 'pet';
@@ -159,7 +160,7 @@ export class PetService extends Service {
                     if (transition === undefined)
                         return;
                     runtime.officialEventsSeen = true;
-                    this.applyActivity(session, transition.input);
+                    this.applyActivity(session, transition.input, transition.whisper);
                     if (transition.completedTurn !== undefined) {
                         this.rewardTurn(String(session.id), transition.completedTurn);
                     }
@@ -206,9 +207,11 @@ export class PetService extends Service {
      * the session becomes the host-global display session (most recent
      * meaningful event wins the sprite animation).
      */
-    applyActivity(session, input) {
+    applyActivity(session, input, whisper) {
         const activity = this.activityOf(session);
         activity.lastInput = input;
+        if (whisper !== undefined)
+            activity.whisper = { text: whisper, at: Date.now() };
         activity.machine.onActivityStatus(input);
         activity.machine.onSessionActive();
         // Move to the tail so map order reads most-recent-last, then trim the
@@ -339,6 +342,15 @@ export class PetService extends Service {
                 phase: perSession.phase,
             });
         }
+        // The display session's inner whisper rides the global view while fresh;
+        // an expired whisper simply stops appearing (the client's 2s poll drops it).
+        const displayActivity = this.displaySession === undefined
+            ? undefined
+            : this.sessionActivity.get(this.displaySession);
+        const whisper = displayActivity?.whisper;
+        const freshWhisper = whisper !== undefined && Date.now() - whisper.at < WHISPER_TTL_MS
+            ? whisper.text
+            : undefined;
         // Read-only: the ledger settles on economic events only, never on a read,
         // so polling the state cannot trigger pet.json writes.
         return {
@@ -347,6 +359,7 @@ export class PetService extends Service {
             phase: snapshot.phase,
             sessionActive: snapshot.sessionActive,
             sessions,
+            ...(freshWhisper === undefined ? {} : { whisper: freshWhisper }),
             affinity: this.ledger.affinityView(Date.now()),
             display: { ...this.ledger.snapshot.display },
             pet: {

package/lib/types/state.d.ts

@@ -39,6 +39,8 @@ export interface PetStateSnapshot {
 export interface PetStateConfig {
     /** Celebration window after `done` before settling to idle, ms (default 2400). */
     celebrateMs: number;
+    /** Failure display window before settling to idle, ms (default 2400). */
+    failureMs: number;
 }
 export declare const defaultPetStateConfig: PetStateConfig;
 /**
@@ -47,7 +49,7 @@ export declare const defaultPetStateConfig: PetStateConfig;
  * - review → `review` while answer text is streaming.
  * - waiting → `waiting` (expectant pose, needs user input).
  * - done → `jumping` (celebration), then back to `idle` after the window.
- * - failed → `failed` until another activity event arrives.
+ * - failed → `failed` briefly, then back to `idle`.
  * - idle → `idle` (calm breathing loop).
  */
 export declare function animationForPhase(phase: ActivityPhase): PetAnimation;
@@ -55,17 +57,18 @@ export declare function animationForPhase(phase: ActivityPhase): PetAnimation;
 export declare function rowOf(animation: PetAnimation): number;
 /**
  * PetStateMachine — one instance per host process. Holds only the latest
- * input snapshot and the celebration timing; no storage, no side effects.
+ * input snapshot and terminal-state timing; no storage, no side effects.
  */
 export declare class PetStateMachine {
-    private readonly config;
     private readonly now;
     private phase;
     private line;
     private phrase;
     private sessionActive;
     private doneAt;
-    constructor(config?: PetStateConfig, now?: () => number);
+    private failedAt;
+    private readonly config;
+    constructor(config?: Partial<PetStateConfig>, now?: () => number);
     /** Consume one projected activity update. */
     onActivityStatus(input: PetStateInput): void;
     /** A session became the active one (or a fresh session started). */

package/lib/types/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEnG,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,cAAc,GACd,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,CAAA;AAEZ,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,KAAK,EAAE,aAAa,CAAA;IACpB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAA;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,oEAAoE;IACpE,KAAK,EAAE,aAAa,CAAA;IACpB,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAsC,CAAA;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAUpE;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAarD;AAED;;;GAGG;AACH,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAElC,YACmB,MAAM,GAAE,cAAsC,EAC9C,GAAG,GAAE,MAAM,MAAiB,EAC3C;IAEJ,6CAA6C;IAC7C,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAK3C;IAED,oEAAoE;IACpE,eAAe,IAAI,IAAI,CAEtB;IAED,sDAAsD;IACtD,iBAAiB,IAAI,IAAI,CAMxB;IAED,6CAA6C;IAC7C,MAAM,IAAI,gBAAgB,CAuBzB;CACF"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEnG,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,cAAc,GACd,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,CAAA;AAEZ,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,KAAK,EAAE,aAAa,CAAA;IACpB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAA;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,oEAAoE;IACpE,KAAK,EAAE,aAAa,CAAA;IACpB,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAuD,CAAA;AAE3F;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAUpE;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAarD;AAED;;;GAGG;AACH,qBAAa,eAAe;IAWxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAVtB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YACE,MAAM,GAAE,OAAO,CAAC,cAAc,CAAyB,EACtC,GAAG,GAAE,MAAM,MAAiB,EAG9C;IAED,6CAA6C;IAC7C,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAM3C;IAED,oEAAoE;IACpE,eAAe,IAAI,IAAI,CAEtB;IAED,sDAAsD;IACtD,iBAAiB,IAAI,IAAI,CAOxB;IAED,6CAA6C;IAC7C,MAAM,IAAI,gBAAgB,CAqBzB;CACF"}

package/lib/types/state.js

@@ -9,14 +9,14 @@
  * function of (input, nowMs); persistence and RPC live in the service.
  * @module @linxin666/dsh-pet/state
  */
-export const defaultPetStateConfig = { celebrateMs: 2400 };
+export const defaultPetStateConfig = { celebrateMs: 2400, failureMs: 2400 };
 /**
  * Map one activity phase onto the animation contract.
  * - thinking → `running` and tool → `running-right` (focused work).
  * - review → `review` while answer text is streaming.
  * - waiting → `waiting` (expectant pose, needs user input).
  * - done → `jumping` (celebration), then back to `idle` after the window.
- * - failed → `failed` until another activity event arrives.
+ * - failed → `failed` briefly, then back to `idle`.
  * - idle → `idle` (calm breathing loop).
  */
 export function animationForPhase(phase) {
@@ -47,27 +47,28 @@ export function rowOf(animation) {
 }
 /**
  * PetStateMachine — one instance per host process. Holds only the latest
- * input snapshot and the celebration timing; no storage, no side effects.
+ * input snapshot and terminal-state timing; no storage, no side effects.
  */
 export class PetStateMachine {
-    config;
     now;
     phase = 'idle';
     line;
     phrase;
     sessionActive = false;
     doneAt;
+    failedAt;
+    config;
     constructor(config = defaultPetStateConfig, now = Date.now) {
-        this.config = config;
         this.now = now;
+        this.config = { ...defaultPetStateConfig, ...config };
     }
     /** Consume one projected activity update. */
     onActivityStatus(input) {
         this.phase = input.phase;
         this.line = input.line;
         this.phrase = input.phrase;
-        if (input.phase === 'done')
-            this.doneAt = this.now();
+        this.doneAt = input.phase === 'done' ? this.now() : undefined;
+        this.failedAt = input.phase === 'failed' ? this.now() : undefined;
     }
     /** A session became the active one (or a fresh session started). */
     onSessionActive() {
@@ -80,24 +81,23 @@ export class PetStateMachine {
         this.line = undefined;
         this.phrase = undefined;
         this.doneAt = undefined;
+        this.failedAt = undefined;
     }
     /** Render the current animation decision. */
     render() {
         const nowMs = this.now();
         let animation = animationForPhase(this.phase);
-        // Celebration window: after `done`, jump for celebrateMs then settle idle.
-        if (this.phase === 'done' && this.doneAt !== undefined) {
-            if (nowMs - this.doneAt < this.config.celebrateMs) {
-                animation = 'jumping';
-            }
-            else {
-                animation = 'idle';
-            }
-        }
-        // Settled sessions never bubble: idle (e.g. an aborted/stopped turn)
-        // and done past its celebration window both fall silent.
-        const settled = this.phase === 'idle'
-            || (this.phase === 'done' && this.doneAt !== undefined && nowMs - this.doneAt >= this.config.celebrateMs);
+        const doneSettled = this.phase === 'done'
+            && this.doneAt !== undefined
+            && nowMs - this.doneAt >= this.config.celebrateMs;
+        const failedSettled = this.phase === 'failed'
+            && this.failedAt !== undefined
+            && nowMs - this.failedAt >= this.config.failureMs;
+        if (doneSettled || failedSettled)
+            animation = 'idle';
+        // Settled sessions never bubble: idle (e.g. an aborted/stopped turn),
+        // completed celebration expiry, and failed display expiry all fall silent.
+        const settled = this.phase === 'idle' || doneSettled || failedSettled;
         const bubble = settled ? undefined : this.phrase ?? this.line;
         return {
             animation,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "Multi-pet companion plugin for the dsh web GUI: a registry-driven floating pet that reacts to model activity, with per-pet naming, petting/feeding interactions and an affinity score",
-  "version": "0.1.20",
+  "version": "0.2.1",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -58,14 +58,14 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",

package/src/affinity.test.ts

@@ -26,8 +26,9 @@ describe('applyInteraction', () => {
     const second = applyInteraction(first.affinity, 'pet', now + defaultAffinityConfig.petCooldownMs - 1)
     expect(second.accepted).toBe(false)
     expect(second.delta).toBe(0)
-    expect(second.affinity).toBe(first.affinity) // same reference: no mutation
+    expect(second.affinity).not.toBe(first.affinity)
     expect(second.affinity.pets).toBe(1)
+    expect(second.affinity.petRejects).toBe(1)
   })
 
   it('accepts a pet again after the cooldown elapsed', () => {
@@ -44,8 +45,9 @@ describe('applyInteraction', () => {
     const second = applyInteraction(first.affinity, 'feed', now + defaultAffinityConfig.feedCooldownMs - 1)
     expect(second.accepted).toBe(false)
     expect(second.delta).toBe(0)
-    expect(second.affinity).toBe(first.affinity)
+    expect(second.affinity).not.toBe(first.affinity)
     expect(second.affinity.feeds).toBe(1)
+    expect(second.affinity.feedRejects).toBe(1)
   })
 
   it('clamps points at AFFINITY_MAX', () => {

package/src/affinity.ts

@@ -8,7 +8,7 @@
  * @module @linxin666/dsh-pet/affinity
  */
 
-import { builtinRemark } from './remarks.ts'
+import { BUILTIN_REMARKS, builtinRemark } from './remarks.ts'
 
 /** One interaction the user can perform on the pet. */
 export type PetInteraction = 'pet' | 'feed'
@@ -25,6 +25,10 @@ export interface AffinityState {
   pets: number
   /** Total feed count (lifetime). */
   feeds: number
+  /** Total pet attempts rejected by cooldown (lifetime). */
+  petRejects: number
+  /** Total feed attempts rejected by cooldown (lifetime). */
+  feedRejects: number
   /** Total completed turns witnessed (lifetime). */
   turns: number
 }
@@ -75,7 +79,16 @@ export const defaultAffinityConfig: AffinityConfig = {
 }
 
 export function emptyAffinity(): AffinityState {
-  return { points: 0, lastPetAt: 0, lastFeedAt: 0, pets: 0, feeds: 0, turns: 0 }
+  return {
+    points: 0,
+    lastPetAt: 0,
+    lastFeedAt: 0,
+    pets: 0,
+    feeds: 0,
+    petRejects: 0,
+    feedRejects: 0,
+    turns: 0,
+  }
 }
 
 /** Outcome of one interaction. */
@@ -136,6 +149,12 @@ function clamp(points: number): number {
   return Math.min(AFFINITY_MAX, Math.max(0, points))
 }
 
+/** Built-in reaction selected deterministically from a persisted counter. */
+function countedRemark(kind: 'pet' | 'petCooldown' | 'feed' | 'feedCooldown', count: number): string {
+  const pool = BUILTIN_REMARKS[kind]
+  return pool[Math.max(0, Math.floor(count)) % pool.length] ?? builtinRemark(kind)
+}
+
 /**
  * Apply one interaction to a copy of the state (immutable style: returns a
  * new object; the caller replaces the persisted state). Cooldowns only
@@ -151,7 +170,13 @@ export function applyInteraction(
   const next = { ...state }
   if (kind === 'pet') {
     if (state.lastPetAt !== 0 && nowMs - state.lastPetAt < config.petCooldownMs) {
-      return { affinity: state, delta: 0, reaction: builtinRemark('petCooldown'), accepted: false }
+      next.petRejects += 1
+      return {
+        affinity: next,
+        delta: 0,
+        reaction: countedRemark('petCooldown', state.petRejects),
+        accepted: false,
+      }
     }
     next.lastPetAt = nowMs
     next.pets += 1
@@ -159,13 +184,19 @@ export function applyInteraction(
     return {
       affinity: next,
       delta: config.petReward,
-      reaction: builtinRemark('pet'),
+      reaction: countedRemark('pet', state.pets),
       accepted: true,
     }
   }
   if (kind === 'feed') {
     if (state.lastFeedAt !== 0 && nowMs - state.lastFeedAt < config.feedCooldownMs) {
-      return { affinity: state, delta: 0, reaction: builtinRemark('feedCooldown'), accepted: false }
+      next.feedRejects += 1
+      return {
+        affinity: next,
+        delta: 0,
+        reaction: countedRemark('feedCooldown', state.feedRejects),
+        accepted: false,
+      }
     }
     next.lastFeedAt = nowMs
     next.feeds += 1
@@ -173,7 +204,7 @@ export function applyInteraction(
     return {
       affinity: next,
       delta: config.feedReward,
-      reaction: builtinRemark('feed'),
+      reaction: countedRemark('feed', state.feeds),
       accepted: true,
     }
   }

package/src/chatter.test.ts

@@ -0,0 +1,154 @@
+/**
+ * Chatter unit tests: the status voice (scene-stable lines, cadence rotation,
+ * per-tool families, argument hints) and the murmur engine (keyword moods,
+ * cooldown, output-volume budget). Everything is deterministic round-robin,
+ * so exact lines are asserted.
+ */
+import { describe, expect, it } from 'vitest'
+import {
+  STATUS_POOLS,
+  StatusVoice,
+  TOOL_POOLS,
+  toolArgHint,
+  toolCategory,
+  WHISPER_GENERIC_POOL,
+  WHISPER_RULES,
+  WhisperEngine,
+} from './chatter.ts'
+
+describe('StatusVoice', () => {
+  it('opens every scene with its legacy fixed line', () => {
+    // The first pool line is the wording the plugin has always shown.
+    expect(STATUS_POOLS.prepare[0]).toBe('准备开始')
+    expect(STATUS_POOLS.waiting[0]).toBe('等待模型响应')
+    expect(STATUS_POOLS.thinking[0]).toBe('正在思考')
+    expect(STATUS_POOLS.review[0]).toBe('整理回复中')
+    expect(STATUS_POOLS.toolResult[0]).toBe('处理工具结果')
+    expect(STATUS_POOLS.done[0]).toBe('完成啦')
+    expect(STATUS_POOLS.failed[0]).toBe('执行失败')
+    expect(STATUS_POOLS.toolFailed[0]).toBe('工具执行失败')
+  })
+
+  it('keeps the line stable while a scene repeats within the rotation window', () => {
+    const voice = new StatusVoice()
+    // Streamed chunks re-emit the same scene many times a second: the copy
+    // must not flicker per chunk.
+    expect(voice.scene('thinking', 1000)).toBe('正在思考')
+    expect(voice.scene('thinking', 2000)).toBe('正在思考')
+    expect(voice.scene('thinking', 4999)).toBe('正在思考')
+  })
+
+  it('advances the line once the scene persists past the rotation cadence', () => {
+    const voice = new StatusVoice()
+    expect(voice.scene('thinking', 1000)).toBe('正在思考')
+    expect(voice.scene('thinking', 5001)).toBe(STATUS_POOLS.thinking[1])
+    expect(voice.scene('thinking', 9002)).toBe(STATUS_POOLS.thinking[2])
+  })
+
+  it('rotates round-robin when a scene is revisited after another scene', () => {
+    const voice = new StatusVoice()
+    expect(voice.scene('thinking', 0)).toBe(STATUS_POOLS.thinking[0])
+    expect(voice.scene('review', 100)).toBe(STATUS_POOLS.review[0])
+    expect(voice.scene('thinking', 200)).toBe(STATUS_POOLS.thinking[1])
+  })
+
+  it('interpolates the tool name and argument hint into tool lines', () => {
+    const voice = new StatusVoice()
+    expect(voice.tool('bash', 'bash', 'npm test', 0)).toBe('正在使用 bash')
+    // Same family within the window: the pool line repeats but the CURRENT
+    // call's name/hint are interpolated, so copy never goes stale.
+    expect(voice.tool('bash', 'bash', 'pnpm build', 100)).toBe('正在使用 bash')
+    // Past the cadence the shell family rotates to a hint-carrying line.
+    const rotated = voice.tool('bash', 'bash', 'npm test', 5000)
+    expect(rotated).toBe(TOOL_POOLS.shell[1]!.replace('{hint}', 'npm test'))
+  })
+
+  it('falls back to the tool name when no argument hint is available', () => {
+    const voice = new StatusVoice()
+    const line = voice.tool('grep', 'grep', undefined, 5000)
+    expect(line).not.toContain('{hint}')
+    expect(line).not.toContain('{tool}')
+  })
+
+  it('interpolates the running count into the remaining-tools line', () => {
+    const voice = new StatusVoice()
+    expect(voice.toolRemaining(1, 0)).toBe('还有 1 个工具运行中')
+    expect(voice.toolRemaining(3, 5000)).toContain('3')
+  })
+})
+
+describe('toolCategory', () => {
+  it('maps the common tool vocabulary onto copy families', () => {
+    expect(toolCategory('read')).toBe('read')
+    expect(toolCategory('write')).toBe('write')
+    expect(toolCategory('edit')).toBe('edit')
+    expect(toolCategory('str_replace_editor')).toBe('edit')
+    expect(toolCategory('run_code')).toBe('shell')
+    expect(toolCategory('bash')).toBe('shell')
+    expect(toolCategory('grep')).toBe('grep')
+    expect(toolCategory('glob')).toBe('find')
+    expect(toolCategory('web_search')).toBe('webSearch')
+    expect(toolCategory('browserFetch')).toBe('webFetch')
+    expect(toolCategory('mcp__mem0__search_memories')).toBe('memory')
+    expect(toolCategory('subagent')).toBe('subagent')
+    expect(toolCategory('todo_write')).toBe('todo')
+    expect(toolCategory('some_future_tool')).toBe('generic')
+  })
+})
+
+describe('toolArgHint', () => {
+  it('extracts the shell command', () => {
+    expect(toolArgHint('bash', '{"command":"npm test"}')).toBe('npm test')
+    expect(toolArgHint('run_code', '{"code":"console.log(1)"}')).toBe('console.log(1)')
+  })
+
+  it('reduces file paths to their basename', () => {
+    expect(toolArgHint('read', '{"file_path":"/repo/src/client/PetSprite.tsx"}')).toBe('PetSprite.tsx')
+  })
+
+  it('extracts search patterns and web queries', () => {
+    expect(toolArgHint('grep', '{"pattern":"bubbleStack"}')).toBe('bubbleStack')
+    expect(toolArgHint('web_search', '{"query":"dsh 插件"}')).toBe('dsh 插件')
+  })
+
+  it('stays hintless for unparseable or shapeless arguments', () => {
+    expect(toolArgHint('bash', 'not json')).toBeUndefined()
+    expect(toolArgHint('bash', '[]')).toBeUndefined()
+    expect(toolArgHint('bash', '{"timeout":1000}')).toBeUndefined()
+  })
+
+  it('caps long hints so the bubble stays compact', () => {
+    const hint = toolArgHint('bash', JSON.stringify({ command: 'x'.repeat(60) }))
+    expect(hint).toBeDefined()
+    expect(hint!.length).toBeLessThanOrEqual(28)
+    expect(hint!.endsWith('...')).toBe(true)
+  })
+})
+
+describe('WhisperEngine', () => {
+  it('wakes a themed whisper from a keyword in the model output', () => {
+    const engine = new WhisperEngine()
+    expect(engine.feed('这里有个错误需要处理', 0)).toBe(WHISPER_RULES[1]!.pool[0])
+  })
+
+  it('suppresses whispers during the cooldown, then rotates the pool', () => {
+    const engine = new WhisperEngine()
+    expect(engine.feed('出现一个错误', 0)).toBe(WHISPER_RULES[1]!.pool[0])
+    expect(engine.feed('又一个错误', 1000)).toBeUndefined()
+    expect(engine.feed('还有一个错误', 9000)).toBe(WHISPER_RULES[1]!.pool[1])
+  })
+
+  it('earns an ambient whisper from output volume alone', () => {
+    const engine = new WhisperEngine(0, 10)
+    expect(engine.feed('aaaaaaaa', 0)).toBeUndefined()
+    expect(engine.feed('bbbb', 1)).toBe(WHISPER_GENERIC_POOL[0])
+    // The counter resets after speaking: another budget must accumulate.
+    expect(engine.feed('cccc', 2)).toBeUndefined()
+    expect(engine.feed('dddddddddd', 3)).toBe(WHISPER_GENERIC_POOL[1])
+  })
+
+  it('ignores empty chunks', () => {
+    const engine = new WhisperEngine(0, 0)
+    expect(engine.feed('', 0)).toBeUndefined()
+  })
+})