@linxin666/dsh-pet 0.3.3 → 0.3.4

package/lib/types/registry.js

@@ -38,6 +38,7 @@ import { PET_DECORATION_API_VERSION } from "./contracts/status-decoration.js";
 import { dshHome } from "./dsh-home.js";
 import { parsePetManifest } from "./manifest-v2.js";
 import { collectModel3References } from "./model3.js";
+import { DEFAULT_PET_ID } from "./defaults.js";
 /** Fixed row order of the 9-state animation contract. */
 export const PET_ROW_ORDER = [
     'idle',
@@ -367,6 +368,169 @@ function resolveLive2dEntry(manifest, dir, options) {
         ...(remarks === undefined ? {} : { remarks }),
     };
 }
+/** Filename-encoded frame duration tail ('<base>_<index>_<ms>.webp'). */
+const FRAMES2D_FILENAME_MS = /_(\d+)\.[^.]+$/;
+/** Trailing frame index, allowing an optional '_<ms>' duration tail after it. */
+const FRAMES2D_FRAME_INDEX = /(\d+)(?:_\d+)?\.[^.]+$/;
+/** Default per-frame duration when neither frameMs nor the filename encodes one. */
+const FRAMES2D_DEFAULT_FRAME_MS = 200;
+/** Image extensions a frames2d track directory may list. */
+const FRAMES2D_IMAGE_EXTENSIONS = new Set(['.webp', '.png', '.gif', '.jpg', '.jpeg']);
+/**
+ * Resolve a validated frames2d manifest into a renderable entry. Track frame
+ * lists come from the manifest's explicit list or from listing
+ * '<dir>/<track>/' in filename order; durations resolve frameMs[i] >
+ * filename-encoded '_<ms>' tail > defaultFrameMs. Missing frames warn and
+ * skip (the live2d closure discipline); a track left with zero frames is
+ * dropped, and if the idle-mapped track ends up empty the entry is rejected
+ * fail-closed. The sprite fields carry contract defaults: the chrome sizes
+ * frames2d pets off 'display.size', not the atlas.
+ */
+function resolveFrames2dEntry(manifest, dir, options) {
+    const assetPrefix = options.assetPrefix ?? '/pet';
+    const record = (level, message) => {
+        options.diagnostics?.push({ level, source: dir, message });
+        options.warnings?.push(message);
+    };
+    const block = manifest.frames2d;
+    if (block === undefined) {
+        record('error', 'pet ' + manifest.id + ': renderer frames2d requires a frames2d block');
+        return undefined;
+    }
+    const root = block.dir ?? '.';
+    const defaultMs = block.defaultFrameMs ?? FRAMES2D_DEFAULT_FRAME_MS;
+    const idleTrack = block.phases.idle;
+    const tracks = {};
+    const servable = [];
+    const firstFrameRel = {};
+    for (const [name, track] of Object.entries(block.tracks)) {
+        const trackDir = root === '.' ? name : root + '/' + name;
+        let relFrames = [];
+        if (track.frames !== undefined) {
+            for (const frame of track.frames) {
+                const rel = trackDir + '/' + frame;
+                if (!existsSync(join(dir, rel))) {
+                    record('warning', 'pet ' + manifest.id + ': frames2d frame missing: ' + rel);
+                    continue;
+                }
+                relFrames.push(rel);
+            }
+        }
+        else {
+            let files = [];
+            try {
+                files = readdirSync(join(dir, trackDir)).filter(file => {
+                    if (file.startsWith('.'))
+                        return false;
+                    const dot = file.lastIndexOf('.');
+                    return dot > 0 && FRAMES2D_IMAGE_EXTENSIONS.has(file.slice(dot).toLowerCase());
+                });
+            }
+            catch {
+                files = [];
+            }
+            // Natural frame order: the trailing index (before any _<ms> duration
+            // suffix) sorts numerically, so 'eat10' comes after 'eat9' — plain
+            // lexicographic order would break any track with 10+ frames.
+            files.sort((a, b) => {
+                const ia = FRAMES2D_FRAME_INDEX.exec(a)?.[1];
+                const ib = FRAMES2D_FRAME_INDEX.exec(b)?.[1];
+                if (ia !== undefined && ib !== undefined && ia !== ib)
+                    return Number(ia) - Number(ib);
+                return a < b ? -1 : a > b ? 1 : 0;
+            });
+            relFrames = files.map(file => trackDir + '/' + file);
+        }
+        if (relFrames.length === 0) {
+            record('warning', 'pet ' + manifest.id + ': frames2d track ' + JSON.stringify(name) + ' has no frames on disk; dropped');
+            continue;
+        }
+        const durations = relFrames.map((rel, index) => {
+            if (track.frameMs !== undefined)
+                return track.frameMs[index] ?? defaultMs;
+            const match = FRAMES2D_FILENAME_MS.exec(rel);
+            if (match !== null) {
+                const ms = Number(match[1]);
+                if (Number.isInteger(ms) && ms >= 16 && ms <= 5000)
+                    return ms;
+            }
+            return defaultMs;
+        });
+        const loop = track.loop ?? true;
+        const view = {
+            frames: relFrames.map(rel => assetUrl(assetPrefix, manifest.id, rel)),
+            durations,
+            loop,
+            ...(loop ? {} : { fallback: track.fallback ?? idleTrack }),
+        };
+        tracks[name] = view;
+        firstFrameRel[name] = relFrames[0];
+        servable.push(...relFrames);
+    }
+    if (tracks[idleTrack] === undefined) {
+        record('error', 'pet ' + manifest.id + ': frames2d idle track ' + JSON.stringify(idleTrack) + ' has no frames on disk');
+        return undefined;
+    }
+    const phases = { ...block.phases };
+    for (const [phase, target] of Object.entries(phases)) {
+        if (target !== undefined && tracks[target] === undefined) {
+            record('warning', 'pet ' + manifest.id + ': frames2d phase ' + phase + ' maps to dropped track ' + JSON.stringify(target) + '; using idle');
+            phases[phase] = idleTrack;
+        }
+    }
+    const remarks = normalizePetRemarks(manifest.remarks, message => record('warning', 'pet ' + manifest.id + ': ' + message));
+    // Gameplay layer: shop item icons are manifest-relative frame paths —
+    // verify them, promote them to browser URLs, and add them to the servable
+    // allow-list so the asset route can serve them.
+    let gameplay;
+    if (manifest.gameplay !== undefined) {
+        gameplay = manifest.gameplay;
+        if (gameplay.shop !== undefined) {
+            const items = [];
+            for (const item of gameplay.shop.items) {
+                if (item.image === undefined) {
+                    items.push(item);
+                    continue;
+                }
+                if (!existsSync(join(dir, item.image))) {
+                    record('warning', 'pet ' + manifest.id + ': gameplay shop item ' + item.id + ' image missing: ' + item.image);
+                    const { image, ...rest } = item;
+                    items.push(rest);
+                    continue;
+                }
+                servable.push(item.image);
+                items.push({ ...item, image: assetUrl(assetPrefix, manifest.id, item.image) });
+            }
+            gameplay = { ...gameplay, shop: { ...gameplay.shop, items } };
+        }
+    }
+    const flatTracks = buildTracks(DEFAULT_FRAME_COUNTS, DEFAULT_PET_COLUMNS, {}, message => record('warning', 'pet ' + manifest.id + ': ' + message));
+    if (flatTracks === undefined)
+        return undefined;
+    // The render box comes from the first idle frame when decodable.
+    const firstAbs = join(dir, firstFrameRel[idleTrack]);
+    const dims = existsSync(firstAbs) ? readImageDimensions(firstAbs) : undefined;
+    const cell = dims !== undefined && dims.width >= 1 && dims.height >= 1 ? dims : { ...DEFAULT_PET_CELL };
+    return {
+        id: manifest.id,
+        displayName: manifest.displayName,
+        description: manifest.description ?? '',
+        renderer: 'frames2d',
+        frames2d: { tracks, phases },
+        ...(gameplay === undefined ? {} : { gameplay }),
+        cell,
+        columns: DEFAULT_PET_COLUMNS,
+        rows: [...DEFAULT_FRAME_COUNTS],
+        atlasRows: DEFAULT_PET_ROW_COUNT,
+        tracks: flatTracks,
+        atlasUrl: tracks[idleTrack].frames[0],
+        manifestUrl: assetUrl(assetPrefix, manifest.id, 'pet.json'),
+        dir,
+        spritesheetPath: firstFrameRel[idleTrack],
+        servable,
+        ...(remarks === undefined ? {} : { remarks }),
+    };
+}
 /** Scan one directory of pet folders; entries come back in name order. */
 function scanPetDir(dir, options) {
     if (!existsSync(dir))
@@ -399,6 +563,9 @@ function scanPetDir(dir, options) {
         if (verdict.manifest.renderer === 'live2d') {
             entry = resolveLive2dEntry(verdict.manifest, entryDir, options);
         }
+        else if (verdict.manifest.renderer === 'frames2d') {
+            entry = resolveFrames2dEntry(verdict.manifest, entryDir, options);
+        }
         else {
             const legacy = flattenV2Sprite2d(verdict.manifest);
             if (legacy === undefined) {
@@ -695,7 +862,7 @@ export function loadPetRegistry(options) {
         warnings,
         diagnostics,
         byId: (id) => byId.get(id),
-        defaultEntry: () => entries.find(entry => builtinIds.has(entry.id)) ?? entries[0],
+        defaultEntry: () => entries.find(entry => (entry.id === DEFAULT_PET_ID && builtinIds.has(entry.id))) ?? entries.find(entry => builtinIds.has(entry.id)) ?? entries[0],
         ...(globalVoice === undefined ? {} : { globalVoice }),
         decorations,
         decorationById: (id) => decorationById.get(id),
@@ -733,6 +900,8 @@ export function petEntryView(entry, globalVoice) {
         description: entry.description,
         renderer: entry.renderer,
         ...(entry.live2d === undefined ? {} : { live2d: entry.live2d }),
+        ...(entry.frames2d === undefined ? {} : { frames2d: entry.frames2d }),
+        ...(entry.gameplay === undefined ? {} : { gameplay: entry.gameplay }),
         cell: entry.cell,
         columns: entry.columns,
         rows: entry.rows,

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

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAO9C,+CAA+C;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAMtC;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,yBAAyB;;IAEzB,iDAAiD;;IAEjD,8EAA8E;;CAEtE,CAAA;AAEV,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrF;AAwND,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAA8B,CAAA;AAe7D,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAmB,CAAA;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwMD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,GAAG,QAAQ,EAAE,CAwDjI;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAO9C,+CAA+C;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAMtC;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,yBAAyB;;IAEzB,iDAAiD;;IAEjD,8EAA8E;;CAEtE,CAAA;AAEV,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrF;AAwND,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAA8B,CAAA;AAe7D,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAmB,CAAA;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwMD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,GAAG,QAAQ,EAAE,CA2EjI;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/lib/types/routes.js

@@ -539,6 +539,28 @@ export function makePetRoutes(deps) {
                 return Promise.reject(new Error('invalid-pet'));
             return service.setPetId(petId);
         }),
+        // Gameplay verbs (miku-pet generalization): touch rolls a named zone's
+        // branch; the omitted-zone form is the plain-click boost during a touch
+        // animation. Mode/tick/buy drive the work, sleep and shop loops.
+        postRoute(ctx, PET_API_PREFIX + '/gameplay/touch', (body) => {
+            const zone = body.zone;
+            if (zone !== undefined && typeof zone !== 'string')
+                return Promise.reject(new Error('invalid-zone'));
+            return service.gameplayTouch(zone);
+        }),
+        postRoute(ctx, PET_API_PREFIX + '/gameplay/mode', (body) => {
+            const mode = body.mode;
+            if (mode !== null && mode !== 'work' && mode !== 'sleep')
+                return Promise.reject(new Error('invalid-mode'));
+            return service.gameplaySetMode(mode);
+        }),
+        postRoute(ctx, PET_API_PREFIX + '/gameplay/work-tick', () => service.gameplayWorkTick()),
+        postRoute(ctx, PET_API_PREFIX + '/gameplay/buy', (body) => {
+            const item = body.item;
+            if (typeof item !== 'string')
+                return Promise.reject(new Error('invalid-item'));
+            return service.gameplayBuy(item);
+        }),
     ];
     const assetRoute = {
         kind: 'prefix',

package/lib/types/service.d.ts

@@ -133,9 +133,39 @@ export interface PetStateView {
      * browser half renders no ornament.
      */
     decoration?: DecorationView;
+    /**
+     * The selected pet's gameplay view (miku-pet generalization), present
+     * when the pet declares a gameplay block. Read-only projection: polling
+     * settles the view in memory but never writes pet.json.
+     */
+    gameplay?: PetGameplayStateView;
 }
 /** Result of `pet.interact`. */
 export type PetInteractResult = LedgerInteractionResult;
+/** The gameplay slice of the state view (dynamic state only; defs ride the pet definition). */
+export interface PetGameplayStateView {
+    /** Stat values rounded for display. */
+    stats: Record<string, number>;
+    mode: 'work' | 'sleep' | null;
+}
+/** Result of the gameplay verbs (touch / setMode / workTick / buy). */
+export interface PetGameplayVerbResult {
+    ok: boolean;
+    error?: string;
+    /** Touch: whether a branch hit, plus its presentation. */
+    hit?: boolean;
+    state?: string;
+    stateMs?: number;
+    phrase?: string;
+    /** Work tick outcome. */
+    outcome?: 'success' | 'fail';
+    /** Shop purchase: the drawn prize, when the item was a lottery. */
+    prize?: {
+        amount: number;
+        currency: string;
+    };
+    view?: PetGameplayStateView;
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         pet: PetService;
@@ -233,6 +263,32 @@ export declare class PetService extends Service {
     private applyActivity;
     /** RPC: pet or feed the pet. */
     interact(kind: PetInteraction): Promise<PetInteractResult>;
+    /** The active pet's gameplay block, if it declares one. */
+    private gameplayDef;
+    /** The persisted (or fresh) gameplay state of the selected pet. */
+    private gameplayState;
+    /** Display view of one gameplay state (rounded stats; treats ride the shared treat ledger). */
+    private gameplayViewOf;
+    /**
+     * Move gameplay 'treats' currency (the unified post-wallet currency) from
+     * the engine's settle work area into the shared treat ledger, capped by
+     * the stock cap. The engine keeps its generic currency record for settle
+     * math; this drain is the only bridge to the wallet-free economy.
+     */
+    private drainGameplayTreats;
+    /** Persist the mutated gameplay state of one verb call. */
+    private commitGameplay;
+    /**
+     * RPC: a touch on the pet. 'zone' names a touch zone (roll a branch);
+     * omitted means a plain click while a touch animation holds (clickBoost).
+     */
+    gameplayTouch(zone?: string): Promise<PetGameplayVerbResult>;
+    /** RPC: enter or leave a gameplay mode ('work' | 'sleep' | null). */
+    gameplaySetMode(mode: 'work' | 'sleep' | null): Promise<PetGameplayVerbResult>;
+    /** RPC: one work-round adjudication (only while the work mode holds). */
+    gameplayWorkTick(): Promise<PetGameplayVerbResult>;
+    /** RPC: buy one shop item (effects, currency swap, or a lottery draw). */
+    gameplayBuy(itemId: string): Promise<PetGameplayVerbResult>;
     /** RPC: show or hide the pet. */
     setVisible(visible: boolean): Promise<{
         ok: true;

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

@@ -19,6 +19,9 @@ import { DEFAULT_DECORATION_ID, decorationView, loadPetRegistry, petEntryView, p
 import { WHISPER_TTL_MS } from "./chatter.js";
 import { mergeVoicePacks } from "./voice-pack.js";
 import { defaultPetStateConfig, PetStateMachine, } from "./state.js";
+import { applyGameplayEffects, drawLotteryTier, initialGameplayState, rollTouchBranch, rollWorkOutcome, settleGameplay, } from "./gameplay.js";
+/** The unified gameplay currency: the shared treat (小鱼干) ledger. */
+const GAMEPLAY_TREATS_CURRENCY = 'treats';
 /** Settings namespace of the pet capability. Spelled here rather than imported: the browser half spells the same value. */
 export const PET_SETTINGS_NAMESPACE = 'pet';
 /** Hard cap on simultaneously displayed session bubbles (most recent first). */
@@ -295,6 +298,174 @@ export class PetService extends Service {
             this.flush();
         return result;
     }
+    /* ---------------------------------------------------------------- *
+     * Gameplay verbs (miku-pet generalization). The manifest block lives
+     * on the registry entry; dynamic state persists per pet id. Verbs
+     * settle and persist; the state view projects without writing.
+     * ---------------------------------------------------------------- */
+    /** The active pet's gameplay block, if it declares one. */
+    gameplayDef() {
+        return this.activeEntry().gameplay;
+    }
+    /** The persisted (or fresh) gameplay state of the selected pet. */
+    gameplayState(def, now) {
+        const petId = this.selectedPetId();
+        const stored = this.ledger.snapshot.gameplay[petId];
+        return {
+            petId,
+            state: stored === undefined
+                ? initialGameplayState(def, now)
+                : { stats: { ...stored.stats }, currencies: { ...stored.currencies }, mode: stored.mode, settledAt: stored.settledAt },
+        };
+    }
+    /** Display view of one gameplay state (rounded stats; treats ride the shared treat ledger). */
+    gameplayViewOf(state) {
+        const stats = {};
+        for (const [name, value] of Object.entries(state.stats))
+            stats[name] = Math.round(value);
+        return { stats, mode: state.mode };
+    }
+    /**
+     * Move gameplay 'treats' currency (the unified post-wallet currency) from
+     * the engine's settle work area into the shared treat ledger, capped by
+     * the stock cap. The engine keeps its generic currency record for settle
+     * math; this drain is the only bridge to the wallet-free economy.
+     */
+    drainGameplayTreats(state) {
+        const pending = Math.floor(state.currencies[GAMEPLAY_TREATS_CURRENCY] ?? 0);
+        delete state.currencies[GAMEPLAY_TREATS_CURRENCY];
+        if (pending > 0)
+            this.ledger.grantTreats(pending);
+    }
+    /** Persist the mutated gameplay state of one verb call. */
+    commitGameplay(petId, state) {
+        this.ledger.setGameplay(petId, state);
+        if (this.ledger.takeDirty())
+            this.flush();
+    }
+    /**
+     * RPC: a touch on the pet. 'zone' names a touch zone (roll a branch);
+     * omitted means a plain click while a touch animation holds (clickBoost).
+     */
+    async gameplayTouch(zone) {
+        const def = this.gameplayDef();
+        if (def === undefined)
+            return { ok: false, error: 'no-gameplay' };
+        const now = Date.now();
+        const { petId, state } = this.gameplayState(def, now);
+        settleGameplay(state, def, now, { sessionActive: this.machine.render().sessionActive });
+        if (zone === undefined) {
+            const boost = def.touch?.clickBoost;
+            if (boost === undefined)
+                return { ok: false, error: 'no-touch' };
+            const amount = boost.min + Math.floor(Math.random() * (boost.max - boost.min + 1));
+            if (amount > 0)
+                applyGameplayEffects(state, def, [{ stat: boost.stat, amount }]);
+            this.drainGameplayTreats(state);
+            this.commitGameplay(petId, state);
+            return { ok: true, hit: false, view: this.gameplayViewOf(state) };
+        }
+        const target = def.touch?.zones.find(entry => entry.name === zone);
+        if (target === undefined)
+            return { ok: false, error: 'unknown-zone' };
+        const branch = rollTouchBranch(target, Math.random);
+        if (branch === undefined) {
+            this.drainGameplayTreats(state);
+            this.commitGameplay(petId, state);
+            return { ok: true, hit: false, view: this.gameplayViewOf(state) };
+        }
+        if (branch.effects !== undefined)
+            applyGameplayEffects(state, def, branch.effects);
+        const phrase = branch.phrases !== undefined && branch.phrases.length > 0
+            ? branch.phrases[Math.floor(Math.random() * branch.phrases.length)]
+            : undefined;
+        this.drainGameplayTreats(state);
+        this.commitGameplay(petId, state);
+        return {
+            ok: true,
+            hit: true,
+            ...(branch.state === undefined ? {} : { state: branch.state }),
+            ...(branch.stateMs === undefined ? {} : { stateMs: branch.stateMs }),
+            ...(phrase === undefined ? {} : { phrase }),
+            view: this.gameplayViewOf(state),
+        };
+    }
+    /** RPC: enter or leave a gameplay mode ('work' | 'sleep' | null). */
+    async gameplaySetMode(mode) {
+        const def = this.gameplayDef();
+        if (def === undefined)
+            return { ok: false, error: 'no-gameplay' };
+        if (mode === 'work' && def.work === undefined)
+            return { ok: false, error: 'no-work' };
+        if (mode === 'sleep' && def.sleep === undefined)
+            return { ok: false, error: 'no-sleep' };
+        const now = Date.now();
+        const { petId, state } = this.gameplayState(def, now);
+        settleGameplay(state, def, now, { sessionActive: this.machine.render().sessionActive });
+        state.mode = mode;
+        this.drainGameplayTreats(state);
+        this.commitGameplay(petId, state);
+        return { ok: true, view: this.gameplayViewOf(state) };
+    }
+    /** RPC: one work-round adjudication (only while the work mode holds). */
+    async gameplayWorkTick() {
+        const def = this.gameplayDef();
+        if (def?.work === undefined)
+            return { ok: false, error: 'no-work' };
+        const now = Date.now();
+        const { petId, state } = this.gameplayState(def, now);
+        if (state.mode !== 'work')
+            return { ok: false, error: 'not-working' };
+        settleGameplay(state, def, now, { sessionActive: this.machine.render().sessionActive });
+        const outcome = rollWorkOutcome(def.work, Math.random);
+        const effects = outcome === 'success' ? def.work.success?.effects : def.work.fail?.effects;
+        if (effects !== undefined)
+            applyGameplayEffects(state, def, effects);
+        this.drainGameplayTreats(state);
+        this.commitGameplay(petId, state);
+        return { ok: true, outcome, view: this.gameplayViewOf(state) };
+    }
+    /** RPC: buy one shop item (effects, currency swap, or a lottery draw). */
+    async gameplayBuy(itemId) {
+        const def = this.gameplayDef();
+        if (def === undefined)
+            return { ok: false, error: 'no-gameplay' };
+        const item = def.shop?.items.find(entry => entry.id === itemId);
+        if (item === undefined)
+            return { ok: false, error: 'unknown-item' };
+        const now = Date.now();
+        const { petId, state } = this.gameplayState(def, now);
+        settleGameplay(state, def, now, { sessionActive: this.machine.render().sessionActive });
+        // The unified currency is the shared treat ledger (wallet removed): shop
+        // prices and prizes ride the same balance the panel shows and feeding
+        // consumes, capped by the stock cap.
+        const treats = item.currency === GAMEPLAY_TREATS_CURRENCY;
+        const balance = treats ? this.ledger.snapshot.treats.treats : (state.currencies[item.currency] ?? 0);
+        if (balance < item.price) {
+            return { ok: false, error: 'insufficient-funds', view: this.gameplayViewOf(state) };
+        }
+        if (treats)
+            this.ledger.spendTreats(item.price);
+        else
+            state.currencies[item.currency] = balance - item.price;
+        if (item.effects !== undefined)
+            applyGameplayEffects(state, def, item.effects);
+        let prize;
+        if (item.lottery !== undefined) {
+            if (item.lottery.effects !== undefined)
+                applyGameplayEffects(state, def, item.lottery.effects);
+            const tier = drawLotteryTier(item.lottery, Math.random);
+            const prizeCurrency = tier.currency ?? item.lottery.currency ?? item.currency;
+            if (prizeCurrency === GAMEPLAY_TREATS_CURRENCY)
+                this.ledger.grantTreats(tier.prize);
+            else
+                state.currencies[prizeCurrency] = (state.currencies[prizeCurrency] ?? 0) + tier.prize;
+            prize = { amount: tier.prize, currency: prizeCurrency };
+        }
+        this.drainGameplayTreats(state);
+        this.commitGameplay(petId, state);
+        return { ok: true, ...(prize === undefined ? {} : { prize }), view: this.gameplayViewOf(state) };
+    }
     /** RPC: show or hide the pet. */
     async setVisible(visible) {
         this.ledger.setDisplay({ ...this.ledger.snapshot.display, visible });
@@ -411,6 +582,15 @@ export class PetService extends Service {
             ? whisper.text
             : undefined;
         const decoration = this.activeDecoration();
+        // Gameplay view: a read-only projection. The settle runs on a copy, so
+        // polling never writes pet.json (verbs settle and persist).
+        const gameplayDef = this.gameplayDef();
+        let gameplay;
+        if (gameplayDef !== undefined) {
+            const { state } = this.gameplayState(gameplayDef, Date.now());
+            settleGameplay(state, gameplayDef, Date.now(), { sessionActive: snapshot.sessionActive });
+            gameplay = this.gameplayViewOf(state);
+        }
         // Read-only: the ledger settles on economic events only, never on a read,
         // so polling the state cannot trigger pet.json writes.
         return {
@@ -433,6 +613,7 @@ export class PetService extends Service {
                 stocked: this.ledger.snapshot.treats.treats,
                 max: this.ledger.treatMax,
             },
+            ...(gameplay === undefined ? {} : { gameplay }),
         };
     }
     flush() {

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.3.3",
+  "version": "0.3.4",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -31,7 +31,10 @@
     "lib/**/*.d.ts.map",
     "src",
     "cordis.patch.yml",
-    "assets",
+    "assets/whale",
+    "assets/whale-refined",
+    "assets/ouo-neko",
+    "assets/decorations",
     "contracts"
   ],
   "license": "Apache-2.0",

package/src/client/PetDockEntry.test.tsx

@@ -79,6 +79,12 @@ function injected(): PetInjected {
     rename: vi.fn(),
     openSession: vi.fn(),
     feedbackDone: vi.fn(),
+    gameplay: {
+      touch: vi.fn(),
+      setMode: vi.fn(),
+      workTick: vi.fn(),
+      buy: vi.fn(),
+    },
   }
 }
 

package/src/client/PetDockEntry.tsx

@@ -11,12 +11,14 @@
  * @module @linxin666/dsh-pet/client/PetDockEntry
  */
 
-import { useEffect, useSyncExternalStore, type ReactElement } from 'react'
+import { useEffect, useRef, useSyncExternalStore, type ReactElement } from 'react'
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots'
 import type { PetDisplayConfig } from '../persist.ts'
 import type { PetStoreInstance } from './pet-store.ts'
 import { PetSprite } from './PetSprite.tsx'
 import { PetRendererSwitch } from './renderers/PetRendererSwitch.tsx'
+import { createDragStream, type DragStream } from './drag-stream.ts'
+import { GameplayHud, type GameplayApi, type GameplayBus } from './gameplay-hud.tsx'
 import { NS } from './locales.ts'
 import styles from './pet.module.css'
 
@@ -42,6 +44,8 @@ export interface PetInjected {
   openSession: (sessionId: string) => void
   /** Clear the reaction bubble. */
   feedbackDone: () => void
+  /** Gameplay verb API (miku-pet generalization); wired but unused for pets without a gameplay block. */
+  gameplay: GameplayApi
 }
 
 /** Composed props of the global pet entry (locale + injected; no slot runtime share). */
@@ -70,6 +74,15 @@ export function PetDockEntry(props: PetDockEntryProps): ReactElement {
     ensure()
   }, [ensure])
 
+  // Per-pet gameplay wiring: the coordination bus (HUD taps <-> chrome,
+  // HUD track overrides <-> frames2d mount) and the shared drag stream.
+  const auxRef = useRef<{ id: string; bus: GameplayBus; drag: DragStream } | null>(null)
+  if (definition !== null && (auxRef.current === null || auxRef.current.id !== definition.id)) {
+    auxRef.current = { id: definition.id, bus: {}, drag: createDragStream() }
+  }
+  const aux = auxRef.current
+  const gameplay = definition?.gameplay
+
   if (visible) {
     return (
       <span data-pet-dock data-testid="pet-dock">
@@ -80,6 +93,7 @@ export function PetDockEntry(props: PetDockEntryProps): ReactElement {
               definition={definition}
               phase={snapshot?.phase ?? 'idle'}
               onPet={props.pet}
+              {...(aux === null ? {} : { drag: aux.drag, bus: aux.bus })}
               t={props.t}
             >
               <PetSprite
@@ -94,6 +108,23 @@ export function PetDockEntry(props: PetDockEntryProps): ReactElement {
                 onRename={props.rename}
                 onOpenSession={props.openSession}
                 onFeedbackDone={props.feedbackDone}
+                dragDisabled={snapshot.gameplay?.mode === 'work'}
+                {...(gameplay === undefined || aux === null
+                  ? {}
+                  : {
+                      onGameplayTap: (fx: number, fy: number) => aux.bus.tap?.(fx, fy),
+                      onGameplayMenu: () => aux.bus.openCard?.(),
+                      hud: (
+                        <GameplayHud
+                          definition={definition}
+                          store={store}
+                          api={props.gameplay}
+                          bus={aux.bus}
+                          drag={aux.drag}
+                          t={props.t}
+                        />
+                      ),
+                    })}
                 t={props.t}
               />
             </PetRendererSwitch>