@linxin666/dsh-pet 0.3.19 → 0.3.20

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: f19d0d949df444336ce190e997225d1c055f44f0
-README.zh.md: 6cfd8504d95081b9399f1dc132c6854228515879
+README.md: 8b92fda99dc04c8f95ff2e42bf39b42a6a4c1f6f
+README.zh.md: d684b6381a9515c6bc7cef55f418ab4e3ab7ee0c

package/README.md

@@ -289,7 +289,7 @@ global React root (createRoot → document.body) <-- polling 2s -- pet-client (b
                                        PetSprite floating layer (portal + rAF)
 ```
 
-- **Status source**: the host projects official `turn/start`, `step/start`, `assistant/chunk`, `assistant/message`, `tool/call`, `tool/result`, and `turn/end` events into waiting/thinking/tool/review/done/failed states. Optional legacy `activity/status` events remain a compatibility input.
+- **Status source**: the host projects official `turn/start`, `step/start`, `assistant/message`, `tool/call`, `tool/result`, and `turn/end` events plus live `agent/assistant-stream` chunks into waiting/thinking/tool/review/done/failed states. Optional legacy `activity/status` events remain a compatibility input.
 - **Registry**: the host normalizes every manifest into a full render definition (geometry, per-row frame counts, per-track durations) and serves it over `/api/pet/pets`; the browser half renders any entry from that definition and carries no per-pet code.
 - **Selection & naming**: `petId` lives in the settings namespace; per-pet names live in `pet.json` under `names`, edited through the hover-panel rename of the active pet. Legacy installs migrate their flat `name` onto the whale girl.
 - **Multi-session semantics**: the API and browser mount are host-global and expose no foreground-session identity. Concurrent sessions each keep their own projected state: the most recent meaningful event drives the sprite animation, while every active TOP-LEVEL session reports its stage in its own bubble (the state view's sessions list, capped at 12 most-recent). Subagent children are tracked for animation, rewards, and the single display bubble but render no bubble of their own, so N conversations never multiply into an N-plus-subagents stack. Every session's completed turns are still rewarded independently; disposing a session removes its bubble, and disposing the display session falls back to the most recent remaining one.

package/README.zh.md

@@ -289,7 +289,7 @@ dsh-pet/
                                        PetSprite 浮层（portal + rAF）
 ```
 
-- **状态来源**：宿主把官方 `turn/start`、`step/start`、`assistant/chunk`、`assistant/message`、`tool/call`、`tool/result`、`turn/end` 事件投影为 waiting/thinking/tool/review/done/failed 状态。可选兼容 `activity/status` 事件仍作为输入。
+- **状态来源**：宿主把官方 `turn/start`、`step/start`、`assistant/message`、`tool/call`、`tool/result`、`turn/end` 事件与实时 `agent/assistant-stream` 增量投影为 waiting/thinking/tool/review/done/failed 状态。可选兼容 `activity/status` 事件仍作为输入。
 - **注册表**：宿主把每份 manifest 归一化为完整渲染定义（几何、每行帧数、每轨时长），经 `/api/pet/pets` 下发；浏览器半区用该定义渲染任意条目，不携带任何宠物专属代码。
 - **选择与命名**：`petId` 存于设置命名空间；每只宠物的名字存于 `pet.json` 的 `names`，通过悬浮面板对当前宠物改名编辑。旧版安装的平铺 `name` 自动迁移到鲸鱼娘名下。
 - **多会话语义**：API 与浏览器挂载都是宿主全局的，不暴露前台会话身份。并行会话各自保留投影状态：最近一次有意义事件驱动精灵动画，同时每个活动的顶层会话在独立气泡里报告自己的阶段（state 视图的 sessions 列表，最多保留最近 12 个）。子代理会话仍参与动画、计奖与单一显示气泡，但不占独立气泡位——N 个对话不会变成"N + 子代理数"的气泡堆。每个会话完成的轮次仍独立计奖；销毁会话移除它的气泡，销毁当前显示会话则回退到最近仍在活动的会话。

package/lib/client.js

@@ -2119,40 +2119,72 @@ window.__ModuleLoader__.load({
 				}
 				const decoding = /* @__PURE__ */ new Map();
 				const decodedAll = [];
-				const loadFrame = (url) => {
+				const FRAME_POOL_LIMIT = 8;
+				const frameQueue = [];
+				let activeFrames = 0;
+				const decodeFrame = async (url) => {
+					try {
+						const response = await fetch(url);
+						if (!response.ok) throw new Error("http " + response.status);
+						const bitmap = await createImageBitmap(await response.blob());
+						return {
+							source: bitmap,
+							width: bitmap.width,
+							height: bitmap.height
+						};
+					} catch {
+						return await new Promise((resolve) => {
+							try {
+								const pre = new Image();
+								pre.onload = () => {
+									resolve(pre.naturalWidth > 0 ? {
+										source: pre,
+										width: pre.naturalWidth,
+										height: pre.naturalHeight
+									} : void 0);
+								};
+								pre.onerror = () => resolve(void 0);
+								pre.src = url;
+							} catch {
+								resolve(void 0);
+							}
+						});
+					}
+				};
+				const pumpFrames = () => {
+					while (activeFrames < FRAME_POOL_LIMIT && frameQueue.length > 0) {
+						const queued = frameQueue.shift();
+						activeFrames += 1;
+						queued.release();
+					}
+				};
+				const loadFrame = (url, jump = false) => {
+					if (jump) {
+						const index = frameQueue.findIndex((queued) => queued.url === url);
+						if (index > 0) frameQueue.unshift(frameQueue.splice(index, 1)[0]);
+					}
 					const cached = decoding.get(url);
 					if (cached !== void 0) return cached;
-					const job = (async () => {
-						try {
-							const response = await fetch(url);
-							if (!response.ok) throw new Error("http " + response.status);
-							const bitmap = await createImageBitmap(await response.blob());
-							return {
-								source: bitmap,
-								width: bitmap.width,
-								height: bitmap.height
-							};
-						} catch {
-							return await new Promise((resolve) => {
-								try {
-									const pre = new Image();
-									pre.onload = () => {
-										resolve(pre.naturalWidth > 0 ? {
-											source: pre,
-											width: pre.naturalWidth,
-											height: pre.naturalHeight
-										} : void 0);
-									};
-									pre.onerror = () => resolve(void 0);
-									pre.src = url;
-								} catch {
-									resolve(void 0);
-								}
-							});
-						}
-					})();
+					let release;
+					const job = new Promise((resolve) => {
+						release = resolve;
+					}).then(() => disposed ? void 0 : decodeFrame(url));
+					job.then((frame) => {
+						if (frame === void 0) decoding.delete(url);
+					}, () => decoding.delete(url));
+					job.finally(() => {
+						activeFrames -= 1;
+						pumpFrames();
+					});
 					decoding.set(url, job);
 					decodedAll.push(job.then(() => void 0, () => void 0));
+					const entry = {
+						url,
+						release
+					};
+					if (jump) frameQueue.unshift(entry);
+					else frameQueue.push(entry);
+					pumpFrames();
 					return job;
 				};
 				let disposed = false;
@@ -2175,7 +2207,7 @@ window.__ModuleLoader__.load({
 				const paintCanvas = (url) => {
 					if (context2d === null || canvas === null) return;
 					const myToken = ++drawToken;
-					loadFrame(url).then((frame) => {
+					loadFrame(url, true).then((frame) => {
 						if (disposed || frame === void 0 || myToken !== drawToken) return;
 						if (lastDrawnUrl === url) return;
 						lastDrawnUrl = url;
@@ -2245,7 +2277,11 @@ window.__ModuleLoader__.load({
 					const expected = (def.durations[frameIndex] ?? 200) + WATCHDOG_MS;
 					if (Date.now() - lastAdvance > expected) tick();
 				}, WATCHDOG_MS);
-				for (const warmTrack of Object.values(config.tracks)) for (const warmUrl of warmTrack.frames) loadFrame(warmUrl);
+				const warmTrackIds = [.../* @__PURE__ */ new Set([...Object.values(config.phases), config.phases.idle])];
+				for (const warmTrack of [...warmTrackIds, ...Object.keys(config.tracks)].map((id) => config.tracks[id])) {
+					if (warmTrack === void 0) continue;
+					for (const warmUrl of warmTrack.frames) loadFrame(warmUrl);
+				}
 				play(track);
 				let disposedOnce = false;
 				const dispose = () => {
@@ -2255,6 +2291,7 @@ window.__ModuleLoader__.load({
 					unsubscribe();
 					if (timer !== void 0) clearTimeout(timer);
 					if (watchdog !== void 0) clearInterval(watchdog);
+					for (const queued of frameQueue.splice(0)) queued.release();
 					Promise.allSettled(decodedAll).then(() => {
 						for (const job of decoding.values()) job.then((frame) => {
 							try {
@@ -3619,7 +3656,7 @@ window.__ModuleLoader__.load({
 		/** The building package's version, when the bundle carries it. */
 		function bakedVersion() {
 			try {
-				return "0.3.19";
+				return "0.3.20";
 			} catch {
 				return;
 			}