@linxin666/dsh-pet 0.2.3 → 0.2.5

package/lib/types/service.d.ts

@@ -17,6 +17,7 @@ import type { TreatConfig } from './treats.ts';
 import { type LedgerInteractionResult } from './ledger.ts';
 import { type PetDisplayConfig } from './persist.ts';
 import { type PetDefinition, type PetManifest, type PetRegistry, type PetRegistryDiagnostic } from './registry.ts';
+import type { DecorationView } from './contracts/status-decoration.ts';
 import { type PetStateConfig, type PetStateSnapshot } from './state.ts';
 /** Plugin configuration. */
 export interface PetConfig {
@@ -30,6 +31,8 @@ export interface PetConfig {
     persistDir?: string;
     /** Master switch for the plugin (browser half + host routes). */
     enabled?: boolean;
+    /** Status-decoration master switch (pet-center M5, #567); defaults to on. */
+    decorationEnabled?: boolean;
     /** Prebuilt registry (tests); defaults to scanning the package + user dirs. */
     registry?: PetRegistry;
     /** Extra manifest entries composed by the embedding application. */
@@ -55,6 +58,11 @@ export interface PetSettingsSection {
     bottom: number;
     /** Master switch for the plugin (browser half + host routes). */
     enabled?: boolean;
+    /**
+     * Status-decoration master switch (pet-center M5, #567). Defaults to on;
+     * the settings surface mirrors this field and can turn it off.
+     */
+    decorationEnabled?: boolean;
 }
 /** Settings namespace of the pet capability. Spelled here rather than imported: the browser half spells the same value. */
 export declare const PET_SETTINGS_NAMESPACE = "pet";
@@ -119,6 +127,12 @@ export interface PetStateView {
      * rendered by the client as a distinct whisper bubble.
      */
     whisper?: string;
+    /**
+     * The active status decoration (pet-center M5, #567), when the master
+     * switch is on and the default decoration entry exists. Absent means the
+     * browser half renders no ornament.
+     */
+    decoration?: DecorationView;
 }
 /** Result of `pet.interact`. */
 export type PetInteractResult = LedgerInteractionResult;
@@ -141,9 +155,17 @@ export declare class PetService extends Service {
     private readonly registry;
     private readonly persistDir;
     private enabled;
+    /** Status-decoration master switch (M5, #567); mirrored from settings. */
+    private decorationEnabled;
     private disposeActivity;
     /** Session whose most recent meaningful event currently drives the global pet. */
     private displaySession;
+    /**
+     * Effective voice-pack overrides for the currently selected pet (M4,
+     * #677). Cached per pet id; the registry is an immutable snapshot, so the
+     * global pack and each entry's pack cannot change behind the cache.
+     */
+    private voiceCache;
     /**
      * Per-session activity, most recent last (Map insertion order). Bounded by
      * MAX_SESSION_BUBBLES so a burst of sessions cannot grow it without bound;
@@ -151,6 +173,12 @@ export declare class PetService extends Service {
      */
     private readonly sessionActivity;
     constructor(ctx: Context, config?: PetConfig);
+    /**
+     * The draw-time voice-pool provider handed to every projection runtime.
+     * It re-resolves when the selected pet changes, so live engines re-voice
+     * on the next draw without being rebuilt (M4, #677).
+     */
+    private voicePools;
     /** Whether the pet service consumes session activity while enabled. */
     isEnabled(): boolean;
     /** RPC: current pet state snapshot. */
@@ -165,6 +193,11 @@ export declare class PetService extends Service {
     diagnostics(): Promise<{
         diagnostics: PetRegistryDiagnostic[];
     }>;
+    /**
+     * The active status decoration view (M5, #567): the default 'whale' entry
+     * (user directories override built-ins by id), gated by the master switch.
+     */
+    private activeDecoration;
     /** The selected pet's registry entry. */
     activeEntry(): NonNullable<PetRegistry['entries'][number]>;
     /** Currently selected pet id (persisted). */

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

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

package/lib/types/service.js

@@ -15,8 +15,9 @@ import { Service } from '@deepseek-ai/cordis';
 import { emptyProjectionRuntime, isActivityPhase, projectOfficialEvent, } from './event-projection.js';
 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 { DEFAULT_DECORATION_ID, decorationView, loadPetRegistry, petEntryView, petPackageRoot, } from './registry.js';
 import { WHISPER_TTL_MS } from './chatter.js';
+import { mergeVoicePacks } from './voice-pack.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';
@@ -36,9 +37,17 @@ export class PetService extends Service {
     registry;
     persistDir;
     enabled;
+    /** Status-decoration master switch (M5, #567); mirrored from settings. */
+    decorationEnabled;
     disposeActivity;
     /** Session whose most recent meaningful event currently drives the global pet. */
     displaySession;
+    /**
+     * Effective voice-pack overrides for the currently selected pet (M4,
+     * #677). Cached per pet id; the registry is an immutable snapshot, so the
+     * global pack and each entry's pack cannot change behind the cache.
+     */
+    voiceCache;
     /**
      * Per-session activity, most recent last (Map insertion order). Bounded by
      * MAX_SESSION_BUBBLES so a burst of sessions cannot grow it without bound;
@@ -72,8 +81,25 @@ export class PetService extends Service {
         this.stateConfig = { ...defaultPetStateConfig, ...(config.state ?? {}) };
         this.machine = new PetStateMachine(this.stateConfig);
         this.enabled = config.enabled ?? true;
+        this.decorationEnabled = config.decorationEnabled ?? true;
         this.syncActivity();
     }
+    /**
+     * The draw-time voice-pool provider handed to every projection runtime.
+     * It re-resolves when the selected pet changes, so live engines re-voice
+     * on the next draw without being rebuilt (M4, #677).
+     */
+    voicePools() {
+        return () => {
+            const entry = this.activeEntry();
+            if (this.voiceCache !== undefined && this.voiceCache.petId === entry.id) {
+                return this.voiceCache.overrides;
+            }
+            const overrides = mergeVoicePacks(this.registry.globalVoice, entry.voice)?.overrides ?? {};
+            this.voiceCache = { petId: entry.id, overrides };
+            return overrides;
+        };
+    }
     /** Whether the pet service consumes session activity while enabled. */
     isEnabled() {
         return this.enabled;
@@ -88,7 +114,7 @@ export class PetService extends Service {
     }
     /** RPC: the registry entries the browser half renders and selects from. */
     async pets() {
-        return this.registry.entries.map(petEntryView);
+        return this.registry.entries.map(entry => petEntryView(entry, this.registry.globalVoice));
     }
     /** The loaded registry (the asset routes serve its entries). */
     registrySnapshot() {
@@ -98,6 +124,16 @@ export class PetService extends Service {
     async diagnostics() {
         return { diagnostics: this.registry.diagnostics };
     }
+    /**
+     * The active status decoration view (M5, #567): the default 'whale' entry
+     * (user directories override built-ins by id), gated by the master switch.
+     */
+    activeDecoration() {
+        if (!this.decorationEnabled)
+            return undefined;
+        const entry = this.registry.decorationById?.(DEFAULT_DECORATION_ID);
+        return entry === undefined ? undefined : decorationView(entry);
+    }
     /** The selected pet's registry entry. */
     activeEntry() {
         return this.registry.byId(this.selectedPetId()) ?? this.registry.defaultEntry();
@@ -199,7 +235,7 @@ export class PetService extends Service {
         let activity = this.sessionActivity.get(session);
         if (activity === undefined) {
             activity = {
-                runtime: emptyProjectionRuntime(),
+                runtime: emptyProjectionRuntime(this.voicePools()),
                 machine: new PetStateMachine(this.stateConfig),
             };
             this.sessionActivity.set(session, activity);
@@ -277,6 +313,7 @@ export class PetService extends Service {
      * @param section - the resolved settings section.
      */
     applySettingsSection(section) {
+        this.decorationEnabled = section.decorationEnabled ?? true;
         const selected = typeof section.petId === 'string' ? this.registry.byId(section.petId) : undefined;
         if (selected !== undefined) {
             this.ledger.setPetId(selected.id);
@@ -355,6 +392,7 @@ export class PetService extends Service {
         const freshWhisper = whisper !== undefined && Date.now() - whisper.at < WHISPER_TTL_MS
             ? whisper.text
             : undefined;
+        const decoration = this.activeDecoration();
         // Read-only: the ledger settles on economic events only, never on a read,
         // so polling the state cannot trigger pet.json writes.
         return {
@@ -364,6 +402,7 @@ export class PetService extends Service {
             sessionActive: snapshot.sessionActive,
             sessions,
             ...(freshWhisper === undefined ? {} : { whisper: freshWhisper }),
+            ...(decoration === undefined ? {} : { decoration }),
             affinity: this.ledger.affinityView(Date.now()),
             display: { ...this.ledger.snapshot.display },
             pet: {

package/lib/types/voice-pack.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Voice-pack normalization and merge (pet-center M4, issue #677).
+ *
+ * A voice pack is the optional 'voice.json' inside a pet directory, or the
+ * global '$DSH_HOME/pets/.voice.json' override file — pure JSON content that
+ * layers pet copy over the built-in pools. Two halves:
+ *
+ *  - 'overrides': the chatter pools (status / tools / toolRemaining /
+ *    whispers) handed to the chatter engines through a VoicePoolsProvider;
+ *  - 'panel': the hover-panel chrome (button labels, stat formats, action
+ *    subset) served to the browser half through PetDefinition.panel.
+ *
+ * Discipline split matches the registry: STRUCTURE is fail-closed per file
+ * (a non-object root drops the whole pack with a warning), CONTENT is
+ * warn-and-drop per slot — one bad line never breaks a pet. The JSON Schema
+ * twin lives at contracts/voice-pack-v1.schema.json for documentation and
+ * external tooling; this hand-rolled normalizer is authoritative (the
+ * repository ships no schema-validator runtime).
+ *
+ * Placeholder policy (each pool kind whitelists its own tokens):
+ *  - status / whisper pools / panel labels: no placeholders allowed — a line
+ *    carrying any '{...}' token is dropped with a warning;
+ *  - tools: {tool} and {hint}; toolRemaining: {n}; panel stats:
+ *    {rank} / {n} / {points}.
+ *
+ * This file is imported directly by scripts/dsh-pet under node's strip-only
+ * TypeScript mode: keep it erasable-syntax-only.
+ * @module @linxin666/dsh-pet/voice-pack
+ */
+import { type VoicePackOverrides, type WhisperRule } from './chatter.ts';
+/** Schema version this module normalizes (optional field; missing = 1). */
+export declare const VOICE_PACK_V1: 1;
+/** Hover-panel action buttons a pack can show or hide (canonical order). */
+export declare const PANEL_ACTIONS: readonly ['feed', 'rename', 'hide'];
+export type PanelAction = (typeof PANEL_ACTIONS)[number];
+/** Panel label slots (unset slots keep the client's i18n dictionary copy). */
+export declare const PANEL_LABEL_KEYS: readonly ['feed', 'rename', 'hide', 'confirm'];
+export type PanelLabelKey = (typeof PANEL_LABEL_KEYS)[number];
+/** Panel stat slots ({rank}/{n}/{points} interpolate the live values). */
+export declare const PANEL_STAT_KEYS: readonly ['rank', 'treats', 'points'];
+export type PanelStatKey = (typeof PANEL_STAT_KEYS)[number];
+/** Hover-panel chrome overrides served to the browser half. */
+export interface PetPanelView {
+    /** Button / input labels; unset slots keep the i18n dictionary copy. */
+    labels?: Partial<Record<PanelLabelKey, string>>;
+    /** Stat line formats; unset slots keep the i18n dictionary copy. */
+    stats?: Partial<Record<PanelStatKey, string>>;
+    /** Actions to render in canonical order; absent = all three; [] = none. */
+    actions?: PanelAction[];
+}
+/** One normalized voice pack (a pet's voice.json or the global override). */
+export interface VoicePack {
+    /** Chatter pool overrides (draw-time merged with the built-in pools). */
+    overrides: VoicePackOverrides;
+    /** Hover-panel chrome, when the pack declares any. */
+    panel?: PetPanelView;
+}
+/** Hard caps shared by every pool slot (mirrors the remarks discipline). */
+export declare const VOICE_POOL_LINES_MAX = 64;
+export declare const VOICE_LINE_MAX = 160;
+export declare const VOICE_KEYWORDS_PER_RULE_MAX = 16;
+export declare const VOICE_KEYWORD_MAX = 40;
+export declare const VOICE_RULES_MAX = 32;
+export declare const VOICE_LABEL_MAX = 40;
+export declare const VOICE_STAT_MAX = 80;
+type PoolKind = 'status' | 'tools' | 'toolRemaining' | 'whisperGeneric' | 'whisperRule' | 'label' | 'stat';
+/**
+ * Normalize one pool slot. Accepts a single line or an array; non-string
+ * entries warn and drop, empty lines drop silently, lines over the length
+ * cap truncate, illegal placeholders drop the line, and pools over the line
+ * cap keep their first lines. An explicit empty pool normalizes to [] (the
+ * whisper channels read that as mute) while an absent slot normalizes to
+ * undefined (the slot keeps the built-in pool).
+ */
+export declare function normalizePool(raw: unknown, kind: PoolKind, onWarning?: (message: string) => void): string[] | undefined;
+/** Normalize the ordered keyword-rule list ([] disables the keyword channel). */
+export declare function normalizeWhisperRules(raw: unknown, onWarning?: (message: string) => void): WhisperRule[] | undefined;
+/** Normalize the panel block (labels / stats / actions; warn-and-drop). */
+export declare function normalizePanel(raw: unknown, onWarning?: (message: string) => void): PetPanelView | undefined;
+/** Voice-pack top-level fields ('$schema' mirrors the schema twin; drift-locked in tests). */
+export declare const VOICE_PACK_KEYS: Set<string>;
+/** Allowed whisper-section fields (drift-locked in tests). */
+export declare const WHISPER_KEYS: Set<string>;
+/**
+ * Normalize one raw voice.json document into a VoicePack, or undefined when
+ * the file cannot serve as a pack at all (non-object root — structure is
+ * fail-closed per file). Every slot issue is a warning, never a throw.
+ */
+export declare function normalizeVoicePack(raw: unknown, onWarning?: (message: string) => void): VoicePack | undefined;
+/**
+ * Merge voice-pack layers into one pack; later layers win per slot. The
+ * built-in pools are NOT a layer here — the chatter engines fall back to
+ * them per key at draw time. Merge order for a selected pet:
+ * mergeVoicePacks(registry.globalVoice, entry.voice).
+ */
+export declare function mergeVoicePacks(...layers: (VoicePack | undefined)[]): VoicePack | undefined;
+export {};
+//# sourceMappingURL=voice-pack.d.ts.map

package/lib/types/voice-pack.d.ts.map

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