@linxin666/dsh-pet 0.3.6 → 0.3.10

package/lib/index.js

@@ -1,5 +1,4 @@
 import { _ as RemarkPicker, a as AFFINITY_MAX, c as applyInteraction, d as emptyAffinity, f as rankOf, g as REMARK_LINE_MAX, h as REMARK_LINES_MAX, i as rowOf, l as applyTurnReward, m as REMARK_KINDS, n as animationForPhase, o as AFFINITY_RANKS, p as BUILTIN_REMARKS, r as defaultPetStateConfig, s as affinityViewOf, t as PetStateMachine, u as defaultAffinityConfig, v as builtinRemark, y as normalizePetRemarks } from "./state-NvDEoCln.js";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
 import { Service } from "@deepseek-ai/cordis";
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
@@ -8,6 +7,67 @@ import { homedir } from "node:os";
 import { isAbsolute as isAbsolute$1, join as join$1 } from "node:path/posix";
 import { fileURLToPath } from "node:url";
 import { readFile } from "node:fs/promises";
+//#region src/announce.ts
+/** Default freshness window. */
+const ANNOUNCE_DEFAULT_TTL_MS = 1e4;
+/**
+* Hard TTL ceiling. A repeating announcer (dsh-usage) declares its poll
+* cadence as the TTL, so an `always`-mode bubble stays continuous across
+* polls; the ceiling means a source that dies unmounts its bubble within at
+* most one missed refresh cycle rather than lingering forever.
+*/
+const ANNOUNCE_MAX_TTL_MS = 72e5;
+/** Hard bounds: lengths and the TTL range (1 s .. 60 s). */
+const TITLE_MAX = 80;
+const TEXT_MAX = 120;
+const SOURCE_MAX = 64;
+function boundedString(value, max) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	if (trimmed === "") return void 0;
+	return trimmed.length <= max ? trimmed : trimmed.slice(0, max);
+}
+/**
+* Validate one announce payload. Unknown fields are dropped, oversized text
+* is truncated, and anything structurally wrong resolves to undefined — a
+* malformed announcement never reaches the pet's bubble surface.
+* @param input - the payload a sibling plugin passed to `pet.announce`.
+* @param now - epoch ms the announcement arrived.
+*/
+function parseAnnouncement(input, now) {
+	if (typeof input !== "object" || input === null) return void 0;
+	const data = input;
+	const source = boundedString(data.source, SOURCE_MAX);
+	const title = boundedString(data.title, TITLE_MAX);
+	if (source === void 0 || title === void 0) return void 0;
+	const kind = data.kind === "balance" || data.kind === "cost" || data.kind === "plan" ? data.kind : void 0;
+	if (kind === void 0) return void 0;
+	const amount = boundedString(data.amount, TEXT_MAX);
+	const resetAt = boundedString(data.resetAt, TEXT_MAX);
+	const note = boundedString(data.note, TITLE_MAX);
+	const percent = typeof data.percent === "number" && Number.isFinite(data.percent) ? Math.max(0, Math.min(100, data.percent)) : void 0;
+	if ((kind === "balance" || kind === "cost") && amount === void 0) return void 0;
+	if (kind === "plan" && percent === void 0) return void 0;
+	const tone = data.tone === "warn" || data.tone === "low" ? data.tone : "ok";
+	const ttlMs = typeof data.ttlMs === "number" && Number.isFinite(data.ttlMs) ? Math.max(1e3, Math.min(ANNOUNCE_MAX_TTL_MS, data.ttlMs)) : ANNOUNCE_DEFAULT_TTL_MS;
+	return {
+		source,
+		kind,
+		title,
+		...amount !== void 0 ? { amount } : {},
+		...percent !== void 0 ? { percent } : {},
+		...resetAt !== void 0 ? { resetAt } : {},
+		...note !== void 0 ? { note } : {},
+		tone,
+		ttlMs,
+		at: now
+	};
+}
+/** Whether an announcement is still fresh at `now`. */
+function announcementFresh(announcement, now) {
+	return now - announcement.at < announcement.ttlMs;
+}
+//#endregion
 //#region src/chatter.ts
 /** While a scene persists, its copy advances on this cadence (ms). */
 const STATUS_ROTATE_MS = 4e3;
@@ -4090,6 +4150,8 @@ var PetService = class extends Service {
 	enabled;
 	/** Status-decoration master switch (M5, #567); mirrored from settings. */
 	decorationEnabled;
+	/** The freshest plugin-authored announcement (dsh-usage linkage). */
+	announcement;
 	disposeActivity;
 	/** Session whose most recent meaningful event currently drives the global pet. */
 	displaySession;
@@ -4167,6 +4229,18 @@ var PetService = class extends Service {
 	async state(currentSessionId) {
 		return this.view(currentSessionId);
 	}
+	/**
+	* RPC: one plugin-authored announcement bubble (dsh-usage linkage). The
+	* payload is validated into a bounded PetAnnouncement; a malformed one is
+	* dropped silently — a sibling plugin's bug must never surface as pet
+	* breakage. The announcement is in-memory only.
+	*/
+	announce(input) {
+		const parsed = parseAnnouncement(input, Date.now());
+		if (parsed === void 0) return { ok: false };
+		this.announcement = parsed;
+		return { ok: true };
+	}
 	/** Current persisted display config (read-only view). */
 	display() {
 		return { ...this.ledger.snapshot.display };
@@ -4646,6 +4720,7 @@ var PetService = class extends Service {
 			settleGameplay(state, gameplayDef, Date.now(), { sessionActive: snapshot.sessionActive });
 			gameplay = this.gameplayViewOf(state);
 		}
+		const announcement = this.announcement !== void 0 && announcementFresh(this.announcement, Date.now()) ? this.announcement : void 0;
 		return {
 			animation: snapshot.animation,
 			...snapshot.bubble === void 0 ? {} : { bubble: snapshot.bubble },
@@ -4653,6 +4728,7 @@ var PetService = class extends Service {
 			sessionActive: snapshot.sessionActive,
 			sessions,
 			...decoration === void 0 ? {} : { decoration },
+			...announcement === void 0 ? {} : { announcement },
 			affinity: this.ledger.affinityView(Date.now()),
 			display: { ...this.ledger.snapshot.display },
 			pet: {
@@ -5466,16 +5542,18 @@ function applyImpl(ctx, config = {}) {
 			disposeRoutes = void 0;
 		}
 	};
-	installSettingsSection(ctx, settingsNamespace("pet"), makePetSettingsSchema(service.selectedPetId()), base, {
-		setSource: (source) => {
-			current = source;
-		},
-		onChange: () => {
-			const section = current();
-			service.applySettingsSection(section);
-			service.setEnabled(section.enabled ?? true);
-			syncRoutes();
-		}
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.installSection(ctx, "pet", makePetSettingsSchema(service.selectedPetId()), base, {
+			setSource: (source) => {
+				current = source;
+			},
+			onChange: () => {
+				const section = current();
+				service.applySettingsSection(section);
+				service.setEnabled(section.enabled ?? true);
+				syncRoutes();
+			}
+		});
 	});
 	syncRoutes();
 }