@linxin666/dsh-pet 0.1.20 → 0.2.0

package/lib/invariant.js

@@ -1,4 +1,4 @@
-import { a as AFFINITY_MAX, n as animationForPhase, o as AFFINITY_RANKS, u as defaultAffinityConfig } from "./state-Diiq8vjk.js";
+import { a as AFFINITY_MAX, n as animationForPhase, o as AFFINITY_RANKS, u as defaultAffinityConfig } from "./state-Ch3f4luZ.js";
 //#region src/invariant.ts
 /**
 * Package invariants — cheap structural checks run at import time on the

package/lib/{state-Diiq8vjk.js → state-Ch3f4luZ.js}

@@ -137,6 +137,11 @@ var RemarkPicker = class {
 		this.counters.set(kind, index + 1);
 		return pool[index];
 	}
+	/** Select a line from a stable external counter without changing local picker state. */
+	pickAt(kind, count) {
+		const pool = this.pools[kind];
+		return pool[Math.max(0, Math.floor(count)) % pool.length];
+	}
 };
 //#endregion
 //#region src/affinity.ts
@@ -220,6 +225,8 @@ function emptyAffinity() {
 		lastFeedAt: 0,
 		pets: 0,
 		feeds: 0,
+		petRejects: 0,
+		feedRejects: 0,
 		turns: 0
 	};
 }
@@ -246,6 +253,11 @@ function affinityViewOf(state, nowMs, config = defaultAffinityConfig) {
 function clamp(points) {
 	return Math.min(AFFINITY_MAX, Math.max(0, points));
 }
+/** Built-in reaction selected deterministically from a persisted counter. */
+function countedRemark(kind, count) {
+	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
@@ -255,36 +267,42 @@ function clamp(points) {
 function applyInteraction(state, kind, nowMs, config = defaultAffinityConfig) {
 	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
-		};
+		if (state.lastPetAt !== 0 && nowMs - state.lastPetAt < config.petCooldownMs) {
+			next.petRejects += 1;
+			return {
+				affinity: next,
+				delta: 0,
+				reaction: countedRemark("petCooldown", state.petRejects),
+				accepted: false
+			};
+		}
 		next.lastPetAt = nowMs;
 		next.pets += 1;
 		next.points = clamp(state.points + config.petReward);
 		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
-		};
+		if (state.lastFeedAt !== 0 && nowMs - state.lastFeedAt < config.feedCooldownMs) {
+			next.feedRejects += 1;
+			return {
+				affinity: next,
+				delta: 0,
+				reaction: countedRemark("feedCooldown", state.feedRejects),
+				accepted: false
+			};
+		}
 		next.lastFeedAt = nowMs;
 		next.feeds += 1;
 		next.points = clamp(state.points + config.feedReward);
 		return {
 			affinity: next,
 			delta: config.feedReward,
-			reaction: builtinRemark("feed"),
+			reaction: countedRemark("feed", state.feeds),
 			accepted: true
 		};
 	}
@@ -304,14 +322,17 @@ function applyTurnReward(state, config = defaultAffinityConfig) {
 }
 //#endregion
 //#region src/state.ts
-const defaultPetStateConfig = { celebrateMs: 2400 };
+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).
 */
 function animationForPhase(phase) {
@@ -341,26 +362,31 @@ 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.
 */
 var PetStateMachine = class {
-	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() : void 0;
+		this.failedAt = input.phase === "failed" ? this.now() : void 0;
 	}
 	/** A session became the active one (or a fresh session started). */
 	onSessionActive() {
@@ -373,14 +399,16 @@ var PetStateMachine = class {
 		this.line = void 0;
 		this.phrase = void 0;
 		this.doneAt = void 0;
+		this.failedAt = void 0;
 	}
 	/** Render the current animation decision. */
 	render() {
 		const nowMs = this.now();
 		let animation = animationForPhase(this.phase);
-		if (this.phase === "done" && this.doneAt !== void 0) if (nowMs - this.doneAt < this.config.celebrateMs) animation = "jumping";
-		else animation = "idle";
-		const bubble = this.phase === "idle" || this.phase === "done" && this.doneAt !== void 0 && nowMs - this.doneAt >= this.config.celebrateMs ? void 0 : this.phrase ?? this.line;
+		const doneSettled = this.phase === "done" && this.doneAt !== void 0 && nowMs - this.doneAt >= this.config.celebrateMs;
+		const failedSettled = this.phase === "failed" && this.failedAt !== void 0 && nowMs - this.failedAt >= this.config.failureMs;
+		if (doneSettled || failedSettled) animation = "idle";
+		const bubble = this.phase === "idle" || doneSettled || failedSettled ? void 0 : this.phrase ?? this.line;
 		return {
 			animation,
 			...bubble === void 0 ? {} : { bubble },

package/lib/types/affinity.d.ts

@@ -21,6 +21,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;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAc,CAAA;AAEvC;;;;8EAI8E;AAC9E,eAAO,MAAM,cAAc;aACvB,GAAG,EAAE,CAAC;aAAE,IAAI,EAAE,IAAI;aAAE,KAAK,EAAE,GAAG;;aAC9B,GAAG,EAAE,EAAE;aAAE,IAAI,EAAE,IAAI;aAAE,KAAK,EAAE,IAAI;;aAChC,GAAG,EAAE,EAAE;aAAE,IAAI,EAAE,IAAI;aAAE,KAAK,EAAE,KAAK;;aACjC,GAAG,EAAE,EAAE;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,MAAM;;aACpC,GAAG,EAAE,GAAG;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,OAAO;;aACtC,GAAG,EAAE,GAAG;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,QAAQ;;aACvC,GAAG,EAAE,IAAK;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,SAAS;;aAC1C,GAAG,EAAE,KAAM;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,UAAU;;aAC5C,GAAG,EAAE,MAAO;aAAE,IAAI,EAAE,MAAM;aAAE,KAAK,EAAE,WAAW;EACxC,CAAA;AAEV,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAA;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAA;IACvB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,8BAA8B;AAC9B,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAMtE;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAA;IACpB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,eAAe,CAYjB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA+BpB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,cAAsC,GAC7C,aAAa,CAKf"}
+{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"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"}

package/lib/types/affinity.js

@@ -7,7 +7,7 @@
  * built-in pool); the ledger layers per-pet custom remarks on top.
  * @module @linxin666/dsh-pet/affinity
  */
-import { builtinRemark } from './remarks.js';
+import { BUILTIN_REMARKS, builtinRemark } from './remarks.js';
 /**
  * Affinity points cap. Historically 100; removed so long-term companions
  * keep growing — the default limit is now the full 999,999,999 range.
@@ -37,7 +37,16 @@ export const defaultAffinityConfig = {
     feedCooldownMs: 30_000,
 };
 export function emptyAffinity() {
-    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,
+    };
 }
 /** Rank for a point total. */
 export function rankOf(points) {
@@ -65,6 +74,11 @@ export function affinityViewOf(state, nowMs, config = defaultAffinityConfig) {
 function clamp(points) {
     return Math.min(AFFINITY_MAX, Math.max(0, points));
 }
+/** Built-in reaction selected deterministically from a persisted counter. */
+function countedRemark(kind, count) {
+    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
@@ -75,7 +89,13 @@ export function applyInteraction(state, kind, nowMs, config = defaultAffinityCon
     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;
@@ -83,13 +103,19 @@ export function applyInteraction(state, kind, nowMs, config = defaultAffinityCon
         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;
@@ -97,7 +123,7 @@ export function applyInteraction(state, kind, nowMs, config = defaultAffinityCon
         return {
             affinity: next,
             delta: config.feedReward,
-            reaction: builtinRemark('feed'),
+            reaction: countedRemark('feed', state.feeds),
             accepted: true,
         };
     }

package/lib/types/chatter.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Pet chatter — the pet's voice while sessions work. Two speakers live here:
+ *
+ *  1. The status voice (session bubbles): big per-scene copy pools instead of
+ *     one fixed line per phase, a fine-grained tool-name → copy-family map,
+ *     and a compact real-argument hint ('跑跑 npm test'), in the spirit of
+ *     the working-activity plugin's status line. Lines rotate round-robin —
+ *     while a phase persists the copy advances every few seconds, so the pet
+ *     feels alive without flickering per streamed chunk.
+ *  2. The murmur engine (碎碎念): the pet's inner whispers, woken by the
+ *     model's own output — keyword moods (errors, test greens, plans,
+ *     self-corrections, victories...) plus an ambient pool earned by output
+ *     volume. A cooldown keeps whispers occasional.
+ *
+ * Pure and deterministic: round-robin everywhere (no Math.random), clocks are
+ * injected. The first line of each status pool is the legacy fixed copy the
+ * plugin has always shown, so existing installs keep their wording until the
+ * scene cycles. No emoji anywhere (repository rule); ～ is the whale-girl's
+ * signature.
+ * @module @linxin666/dsh-pet/chatter
+ */
+/** Status copy scenes — the situations a session bubble can report. */
+export type StatusScene = 'prepare' | 'waiting' | 'thinking' | 'review' | 'toolResult' | 'done' | 'failed' | 'toolFailed' | 'maxTokens' | 'interrupted' | 'blocked';
+/** While a scene persists, its copy advances on this cadence (ms). */
+export declare const STATUS_ROTATE_MS = 4000;
+/** Fixed-copy pools per status scene (first line = legacy wording). */
+export declare const STATUS_POOLS: Readonly<Record<StatusScene, readonly string[]>>;
+/** Tool families for friendlier per-tool status copy. */
+export type ToolCategory = 'read' | 'write' | 'edit' | 'shell' | 'grep' | 'find' | 'ls' | 'webSearch' | 'webFetch' | 'mcp' | 'memory' | 'subagent' | 'todo' | 'browser' | 'git' | 'ask' | 'generic';
+/** Map a raw tool name onto its copy family (working-activity style regexes). */
+export declare function toolCategory(toolName: string): ToolCategory;
+/**
+ * Per-family tool status pools. '{tool}' interpolates the compact tool name,
+ * '{hint}' the compact real-argument hint (both optional per line); the first
+ * entry of every pool is the legacy '正在使用 {tool}' wording.
+ */
+export declare const TOOL_POOLS: Readonly<Record<ToolCategory, readonly string[]>>;
+/** Pools for the parallel-tools line; '{n}' interpolates the running count. */
+export declare const TOOL_REMAINING_POOL: readonly string[];
+/**
+ * A compact, human-readable hint of what a tool call actually touches —
+ * the command, the path, the pattern, the query. Best-effort parse of the
+ * raw arguments JSON; unknown shapes stay hintless. Capped short so the
+ * bubble stays compact.
+ */
+export declare function toolArgHint(toolName: string, argumentsJson: string): string | undefined;
+/**
+ * Round-robin voice for status copy. Scene-keyed picks stay STABLE while the
+ * same scene repeats (streaming chunks re-emit the same phase many times per
+ * second, and rotating per chunk would make the bubble flicker), but advance
+ * once the scene has persisted past the rotation cadence, so a long thinking
+ * stretch keeps changing its wording.
+ */
+export declare class StatusVoice {
+    private readonly rotateMs;
+    private readonly counters;
+    private lastScene;
+    private lastLine;
+    private lastLineAt;
+    constructor(rotateMs?: number);
+    /** Draw the next line of one pool, advancing its round-robin cursor. */
+    private draw;
+    /** Reuse the stable line or advance when the cadence elapsed. */
+    private voice;
+    /** Status line for a phase scene. */
+    scene(scene: StatusScene, nowMs: number): string;
+    /** Status line for a tool call, with the real-argument hint when known. */
+    tool(toolName: string, displayName: string, hint: string | undefined, nowMs: number): string;
+    /** Status line while sibling tools still run (always reflects the count). */
+    toolRemaining(count: number, nowMs: number): string;
+}
+/** One murmur trigger: keywords in the model output wake a themed pool. */
+export interface WhisperRule {
+    /** Lowercase substrings that wake this pool (matched against chunk text). */
+    keywords: readonly string[];
+    /** Themed inner-whisper lines. */
+    pool: readonly string[];
+}
+/** Murmur pacing: cooldown between whispers and output volume that earns one. */
+export declare const WHISPER_COOLDOWN_MS = 9000;
+export declare const WHISPER_CHAR_BUDGET = 420;
+/** How long a whisper stays on screen (host-side expiry). */
+export declare const WHISPER_TTL_MS = 8000;
+/** Ambient inner-whisper pool (no keyword needed; earned by output volume). */
+export declare const WHISPER_GENERIC_POOL: readonly string[];
+/** Keyword-triggered whisper rules, most specific moods first. */
+export declare const WHISPER_RULES: readonly WhisperRule[];
+/**
+ * The murmur engine (碎碎念): watches the model's own output and lets the pet
+ * whisper its inner voice. Two ways to earn a whisper:
+ *  - a keyword rule matches the fresh chunk text (themed whisper);
+ *  - enough output volume flowed by without one (ambient whisper).
+ * A cooldown keeps whispers occasional; all picks are round-robin so tests
+ * reproduce exact lines.
+ */
+export declare class WhisperEngine {
+    private readonly cooldownMs;
+    private readonly charBudget;
+    private readonly counters;
+    private genericCursor;
+    private lastWhisperAt;
+    private charsSinceWhisper;
+    constructor(cooldownMs?: number, charBudget?: number);
+    /**
+     * Feed one model-output chunk (reasoning or text). Returns the whisper to
+     * show, or undefined when the moment stays quiet.
+     */
+    feed(text: string, nowMs: number): string | undefined;
+    private speak;
+}
+//# sourceMappingURL=chatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatter.d.ts","sourceRoot":"","sources":["../../src/chatter.ts"],"names":[],"mappings":"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"}