@khorsheed/dsh-game 0.1.0 → 0.1.1

package/lib/typert.remote-client.js

@@ -197,6 +197,26 @@ const _khorsheed_dsh_game_game_finalizeParams_result$schema = () => (_khorsheed_
 }), z.object({
   'ok': z.literal(true).readonly(),
 })]))
+let _khorsheed_dsh_game_game_liveVersion_parameter_0$schema$value
+const _khorsheed_dsh_game_game_liveVersion_parameter_0$schema = () => (_khorsheed_dsh_game_game_liveVersion_parameter_0$schema$value ??= z.string())
+let _khorsheed_dsh_game_game_liveVersion_result$schema$value
+const _khorsheed_dsh_game_game_liveVersion_result$schema = () => (_khorsheed_dsh_game_game_liveVersion_result$schema$value ??= z.union([z.literal(null), z.object({
+  'projectId': z.string().readonly(),
+  'version': z.number().readonly(),
+  'kind': z.union([z.literal("none"), z.literal("candidate"), z.literal("deployed")]).readonly(),
+  'at': z.union([z.literal(null), z.string()]).readonly(),
+  'by': z.union([z.literal("user"), z.literal("agent"), z.literal("turn")]).readonly().optional(),
+  'show': z.object({
+  'seq': z.number().readonly(),
+  'target': z.object({
+  'view': z.union([z.literal("versions"), z.literal("play"), z.literal("elements"), z.literal("design")]).readonly(),
+  'elementId': z.string().readonly().optional(),
+  'chapterId': z.string().readonly().optional(),
+}).readonly(),
+  'note': z.string().readonly().describe('What to look at, in the agent\'s words (shown with the notice).'),
+  'at': z.string().readonly(),
+}).readonly().optional().describe('The agent\'s latest request to show the user something, if any since the host started.'),
+})]))
 let _khorsheed_dsh_game_game_logPlay_parameter_0$schema$value
 const _khorsheed_dsh_game_game_logPlay_parameter_0$schema = () => (_khorsheed_dsh_game_game_logPlay_parameter_0$schema$value ??= z.string())
 let _khorsheed_dsh_game_game_logPlay_parameter_1$schema$value
@@ -490,6 +510,7 @@ const _khorsheed_dsh_game_game_state_result$schema = () => (_khorsheed_dsh_game_
 }).readonly().optional(),
 })]).readonly().describe('The 3D look, if the element has one (3d-three projects).'),
   'lore': z.string().readonly().describe('The 设定 text (the element\'s `lore` field): who it is, its temper, how it meets the player. \'\' when unwritten.'),
+  'updatedAt': z.number().readonly().optional().describe('When its file last changed (ms), for listing the newest first.'),
 })).readonly(),
   'elementErrors': z.array(z.object({
   'where': z.string().readonly().describe('`smoke`, `data`, or the test file\'s project-relative path.'),
@@ -813,6 +834,8 @@ let _khorsheed_dsh_game_game_finalizeParams_parameter_1_strict$schema$value
 const _khorsheed_dsh_game_game_finalizeParams_parameter_1_strict$schema = () => (_khorsheed_dsh_game_game_finalizeParams_parameter_1_strict$schema$value ??= z.strictObject({
   'projectId': z.string(),
 }))
+let _khorsheed_dsh_game_game_liveVersion_parameter_0_strict$schema$value
+const _khorsheed_dsh_game_game_liveVersion_parameter_0_strict$schema = () => (_khorsheed_dsh_game_game_liveVersion_parameter_0_strict$schema$value ??= z.string())
 let _khorsheed_dsh_game_game_logPlay_parameter_0_strict$schema$value
 const _khorsheed_dsh_game_game_logPlay_parameter_0_strict$schema = () => (_khorsheed_dsh_game_game_logPlay_parameter_0_strict$schema$value ??= z.string())
 let _khorsheed_dsh_game_game_logPlay_parameter_1_strict$schema$value
@@ -961,7 +984,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_bind_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":67,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":73,"column":3},
     },
     'game/bundle': {
       service: 'gameRemote',
@@ -994,7 +1017,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_bundle_result$schema(),
         jsonSchemaError: 'typert tool schema: selected union branches overlap or have no required discriminator',
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":79,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":85,"column":3},
     },
     'game/changes': {
       service: 'gameRemote',
@@ -1027,7 +1050,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_changes_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"against":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"The version compared against (the waiting candidate, else the live one); null before any."},"hasEntry":{"type":"boolean"},"count":{"type":"number","description":"Build files added, changed or removed (first 30 of \\`count\\`)."},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"kind":{"type":"string","enum":["changed","added","removed"]}},"required":["path","kind"],"additionalProperties":true}},"lastAt":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"The newest change's time."},"busy":{"oneOf":[{"type":"null","const":null},{"type":"string","enum":["turn","recent"]}],"description":"Someone is still writing: a bound session's turn is running, or a file changed in the last 20 s."},"edits":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Stable key so repeated edits of one thing collapse into one entry (`param:speed`, `look:fog`, `design:core-loop`)."},"text":{"type":"string","description":"Short label for the dock and the model (`参数 移动速度 1.4→1.8`)."}},"required":["key","text"],"additionalProperties":true},"description":"The panel edits among them."},"failed":{"oneOf":[{"type":"null","const":null},{"type":"array","items":{"type":"object","properties":{"where":{"type":"string"},"message":{"type":"string"}},"required":["where","message"],"additionalProperties":true}}],"description":"The last check ran after the newest change and failed: its findings."},"ok":{"type":"boolean","const":true}},"required":["against","hasEntry","count","files","lastAt","busy","edits","failed","ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":91,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":97,"column":3},
     },
     'game/checkShot': {
       service: 'gameRemote',
@@ -1060,7 +1083,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_checkShot_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"webp":{"type":"string"}},"required":["ok","webp"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":198,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":204,"column":3},
     },
     'game/commit': {
       service: 'gameRemote',
@@ -1111,7 +1134,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_commit_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"kind":{"type":"string","enum":["candidate","deployed"]},"version":{"type":"number"}},"required":["ok","kind","version"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"kind":{"type":"string","const":"failed"},"failures":{"type":"array","items":{"type":"object","properties":{"where":{"type":"string"},"message":{"type":"string"}},"required":["where","message"],"additionalProperties":true}}},"required":["ok","kind","failures"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"kind":{"type":"string","enum":["unchanged","no-entry"]}},"required":["ok","kind"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":97,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":103,"column":9},
     },
     'game/confirm': {
       service: 'gameRemote',
@@ -1162,7 +1185,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_confirm_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"version":{"type":"number"}},"required":["ok","version"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":85,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":91,"column":9},
     },
     'game/deleteProject': {
       service: 'gameRemote',
@@ -1213,7 +1236,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_deleteProject_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"trashedTo":{"type":"string"}},"required":["ok"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]},"reason":{"type":"string"}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":61,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":67,"column":9},
     },
     'game/diff': {
       service: 'gameRemote',
@@ -1246,7 +1269,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_diff_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"diff":{"type":"object","properties":{"added":{"type":"array","items":{"type":"string"}},"removed":{"type":"array","items":{"type":"string"}},"changed":{"type":"array","items":{"type":"string"}}},"required":["added","removed","changed"],"additionalProperties":true}},"required":["ok","diff"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":192,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":198,"column":3},
     },
     'game/dropPending': {
       service: 'gameRemote',
@@ -1297,7 +1320,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_dropPending_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":115,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":121,"column":9},
     },
     'game/editElement': {
       service: 'gameRemote',
@@ -1348,7 +1371,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_editElement_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"elementJson":{"type":"string"}},"required":["ok","elementJson"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":139,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":145,"column":9},
     },
     'game/finalizeParams': {
       service: 'gameRemote',
@@ -1399,7 +1422,40 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_finalizeParams_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":127,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":133,"column":9},
+    },
+    'game/liveVersion': {
+      service: 'gameRemote',
+      description: 'The bound project\'s newest version (cheap; the page polls it).',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'sessionId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _khorsheed_dsh_game_game_liveVersion_parameter_0$schema,
+            schema: _khorsheed_dsh_game_game_liveVersion_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _khorsheed_dsh_game_game_liveVersion_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_game_game_liveVersion_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-game#game/liveVersion:result',
+        create: _khorsheed_dsh_game_game_liveVersion_result$schema,
+        schema: _khorsheed_dsh_game_game_liveVersion_result$schema(),
+        jsonSchema: {"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"projectId":{"type":"string"},"version":{"type":"number"},"kind":{"type":"string","enum":["none","candidate","deployed"]},"at":{"oneOf":[{"type":"null","const":null},{"type":"string"}]},"by":{"type":"string","enum":["user","agent","turn"]},"show":{"type":"object","properties":{"seq":{"type":"number"},"target":{"type":"object","properties":{"view":{"type":"string","enum":["versions","play","elements","design"]},"elementId":{"type":"string"},"chapterId":{"type":"string"}},"required":["view"],"additionalProperties":true},"note":{"type":"string","description":"What to look at, in the agent's words (shown with the notice)."},"at":{"type":"string"}},"required":["seq","target","note","at"],"additionalProperties":true,"description":"The agent's latest request to show the user something, if any since the host started."}},"required":["projectId","version","kind","at"],"additionalProperties":true}]},
+      },
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":49,"column":3},
     },
     'game/logPlay': {
       service: 'gameRemote',
@@ -1450,7 +1506,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_logPlay_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":109,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":115,"column":9},
     },
     'game/pickProposal': {
       service: 'gameRemote',
@@ -1501,7 +1557,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_pickProposal_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":156,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":162,"column":9},
     },
     'game/projectCards': {
       service: 'gameRemote',
@@ -1516,7 +1572,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_projectCards_result$schema(),
         jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"root":{"type":"string"},"updatedAt":{"type":"string"},"pitch":{"type":"string"},"artStyle":{"type":"string"},"version":{"oneOf":[{"type":"null","const":null},{"type":"number"}]},"elements":{"type":"number"},"thumb":{"type":"string","description":"The last check's screenshot (webp, base64), when there is one."}},"required":["id","title","root","updatedAt","pitch","artStyle","version","elements"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":55,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":61,"column":3},
     },
     'game/reject': {
       service: 'gameRemote',
@@ -1567,7 +1623,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_reject_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":180,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":186,"column":9},
     },
     'game/requestRestyle': {
       service: 'gameRemote',
@@ -1618,7 +1674,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_requestRestyle_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":174,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":180,"column":9},
     },
     'game/resetParams': {
       service: 'gameRemote',
@@ -1669,7 +1725,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_resetParams_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":133,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":139,"column":9},
     },
     'game/rollback': {
       service: 'gameRemote',
@@ -1720,7 +1776,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_rollback_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":186,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":192,"column":9},
     },
     'game/setAutoConfirm': {
       service: 'gameRemote',
@@ -1771,7 +1827,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_setAutoConfirm_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":103,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":109,"column":9},
     },
     'game/setOnePager': {
       service: 'gameRemote',
@@ -1822,7 +1878,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_setOnePager_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":168,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":174,"column":9},
     },
     'game/setParam': {
       service: 'gameRemote',
@@ -1873,7 +1929,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_setParam_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":121,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":127,"column":9},
     },
     'game/state': {
       service: 'gameRemote',
@@ -1957,7 +2013,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_turnReport_result$schema(),
         jsonSchema: {"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"turn":{"type":"number"},"projectId":{"type":"string"},"title":{"type":"string"},"at":{"type":"string"},"version":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"kind":{"type":"string","enum":["candidate","deployed"]},"version":{"type":"number"}},"required":["kind","version"],"additionalProperties":true}],"description":"A version that became live (or a candidate) during the turn."},"check":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"ok":{"type":"boolean"},"fixes":{"type":"number"},"gaveUp":{"type":"boolean"},"passed":{"type":"number"},"failures":{"type":"number"}},"required":["ok","fixes","gaveUp","passed","failures"],"additionalProperties":true}],"description":"The turn's end-of-turn check, when one ran."},"elements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"what":{"type":"string","enum":["removed","new","look","fields"]},"fields":{"type":"array","items":{"type":"string"}},"looks":{"type":"object","properties":{"before":{"oneOf":[{"type":"null","const":null},{"type":"string"}]},"after":{"type":"string"}},"required":["before","after"],"additionalProperties":true,"description":"3D looks before and after the turn (JSON), for the card's side-by-side previews."}},"required":["id","name","what"],"additionalProperties":true}},"chapters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"],"additionalProperties":true}},"params":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"from":{"type":"number"},"to":{"type":"number"}},"required":["key","label","to"],"additionalProperties":true}},"code":{"type":"array","items":{"type":"string"},"description":"Other changed source files (code, assets, index.html)."},"tests":{"type":"array","items":{"type":"string"}}},"required":["turn","projectId","title","at","version","check","elements","chapters","params","code","tests"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":49,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":55,"column":3},
     },
     'game/versionBundle': {
       service: 'gameRemote',
@@ -1990,7 +2046,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_versionBundle_result$schema(),
         jsonSchemaError: 'typert tool schema: selected union branches overlap or have no required discriminator',
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":204,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":210,"column":3},
     },
     'game/workingFile': {
       service: 'gameRemote',
@@ -2023,7 +2079,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_workingFile_result$schema(),
         jsonSchemaError: 'typert tool schema: selected union branches overlap or have no required discriminator',
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":73,"column":3},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":79,"column":3},
     },
     'game/writeChapter': {
       service: 'gameRemote',
@@ -2074,7 +2130,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         schema: _khorsheed_dsh_game_game_writeChapter_result$schema(),
         jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["not-found","denied","io","unbound","invalid","no-version","not-a-project","is-workspace","trash-failed"]}},"required":["ok","error"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/game/src/remote.ts","line":162,"column":9},
+      sourceLocation: {"file":"packages/game/src/remote.ts","line":168,"column":9},
     },
   },
 }, z)

package/lib/types/agent.js

@@ -10,7 +10,8 @@ const GUIDANCE = 'This session is the game-development mode. The user designs an
     + 'version that passed the checks. Use game_open / game_read for the project; write its files with the '
     + 'ordinary file tools. Whenever you changed something playable, call game_publish before you report or ask anything, '
     + 'without waiting to be asked — a question does not end the turn, so the play area would still show the old version. '
-    + 'When a CLI member reports its changes, publish them for it (members have no publish tool). Load the game-design skill when shaping the game with the user, and the gamedev skill before '
+    + 'When a CLI member reports its changes, publish them for it (members have no publish tool). A publish also takes the '
+    + 'user\'s game tab to the result; pass show/note to choose where and say what to look at. Load the game-design skill when shaping the game with the user, and the gamedev skill before '
     + 'writing game code. Answer in the user\'s language.';
 /**
  * Register the tools, the guidance and the skills, or nothing when the core is absent.

package/lib/types/client/DesignView.js

@@ -8,7 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * number; 试玩记录 is the log the plugin keeps.
  */
 import { useEffect, useMemo, useState } from 'react';
-import { artStyleLabel } from "../project.js";
+import { artStyleLabel, artStyleName } from "../project.js";
 import { failureOf } from "./contract.js";
 import { Markdown } from "./markdown.js";
 import css from './GameTab.module.css';
@@ -76,7 +76,7 @@ function OnePager(props) {
         setError(null);
         setEditing(true);
     };
-    return _jsxs("section", { className: css.onePager, children: [_jsxs("div", { className: css.onePagerHead, children: [_jsx("span", { className: css.eyebrow, children: t('design.onePager') }), _jsx("span", { className: css.metaLine, children: "game.json" }), _jsx("span", { className: css.spacer }), _jsx("button", { type: "button", className: css.styleChip, onClick: onStyle, title: t('style.change'), children: t('design.style', { style: manifest === null ? '—' : artStyleLabel(manifest.artStyle) }) }), !editing && manifest !== null && _jsx("button", { type: "button", className: css.ghost, onClick: begin, children: t('design.editOnePager') })] }), editing
+    return _jsxs("section", { className: css.onePager, children: [_jsxs("div", { className: css.onePagerHead, children: [_jsx("span", { className: css.eyebrow, children: t('design.onePager') }), _jsx("span", { className: css.metaLine, children: "game.json" }), _jsx("span", { className: css.spacer }), _jsx("button", { type: "button", className: css.styleChip, onClick: onStyle, title: manifest === null ? t('style.change') : `${artStyleLabel(manifest.artStyle)}\n${t('style.change')}`, children: t('design.style', { style: manifest === null ? '—' : artStyleName(manifest.artStyle) }) }), !editing && manifest !== null && _jsx("button", { type: "button", className: css.ghost, onClick: begin, children: t('design.editOnePager') })] }), editing
                 ? _jsxs("div", { className: css.onePagerForm, children: [_jsxs("label", { className: css.field, children: [_jsx("span", { className: css.fieldKey, children: t('design.pitchLabel') }), _jsx("textarea", { className: css.textarea, rows: 2, value: pitch, onChange: e => { setPitch(e.target.value); } })] }), _jsxs("label", { className: css.field, children: [_jsx("span", { className: css.fieldKey, children: t('design.typesLabel') }), _jsx("input", { className: css.input, value: types, onChange: e => { setTypes(e.target.value); } })] }), _jsxs("label", { className: css.field, children: [_jsx("span", { className: css.fieldKey, children: t('design.pillarsLabel') }), _jsx("textarea", { className: css.textarea, rows: 4, value: pillars, onChange: e => { setPillars(e.target.value); } })] }), error !== null && _jsx("p", { className: css.warnText, children: error }), _jsxs("div", { className: css.rowEnd, children: [_jsx("button", { type: "button", className: css.ghost, onClick: () => { setEditing(false); }, children: t('common.cancel') }), _jsx("button", { type: "button", className: css.primary, onClick: () => {
                                         void api.setOnePager(sessionId, project.id, { pitch, elementTypes: types, pillars }).then(r => {
                                             if (failureOf(r) !== undefined) {
@@ -87,7 +87,7 @@ function OnePager(props) {
                                             refresh();
                                         });
                                     }, children: t('common.save') })] })] })
-                : _jsxs(_Fragment, { children: [_jsx("p", { className: css.pitch, children: manifest?.pitch || t('design.noPitch') }), _jsx("div", { className: css.typeRow, children: (manifest?.elementTypes ?? []).map(type => _jsx("span", { className: css.typeTag, children: type }, type)) }), _jsxs("div", { className: css.pillars, children: [_jsx("span", { className: css.eyebrow, children: t('design.pillars') }), (manifest?.pillars.length ?? 0) > 0
+                : _jsxs(_Fragment, { children: [_jsx("p", { className: css.pitch, children: manifest?.pitch || t('design.noPitch') }), manifest !== null && artStyleName(manifest.artStyle) !== artStyleLabel(manifest.artStyle) && _jsx("p", { className: css.metaLine, children: t('design.styleFull', { style: artStyleLabel(manifest.artStyle) }) }), _jsx("div", { className: css.typeRow, children: (manifest?.elementTypes ?? []).map(type => _jsx("span", { className: css.typeTag, children: type }, type)) }), _jsxs("div", { className: css.pillars, children: [_jsx("span", { className: css.eyebrow, children: t('design.pillars') }), (manifest?.pillars.length ?? 0) > 0
                                     ? _jsx("ol", { className: css.pillarList, children: manifest.pillars.map((p, i) => _jsx("li", { children: p }, i)) })
                                     : _jsx("p", { className: css.metaLine, children: t('design.noPillars') })] })] })] });
 }

package/lib/types/client/ElementsView.js

@@ -34,7 +34,9 @@ export function ElementsView(props) {
     const open = project.elements.find(e => e.id === openId);
     if (open !== undefined)
         return _jsx(ElementDetail, { ...props, element: open, onBack: () => { onOpen(null); }, types: types });
-    const shown = project.elements.filter(e => filter === 'all' || e.type === filter);
+    // Newest change first (stable: elements of one file keep their order).
+    const shown = project.elements.filter(e => filter === 'all' || e.type === filter)
+        .map((e, i) => ({ e, i })).sort((a, b) => (b.e.updatedAt ?? 0) - (a.e.updatedAt ?? 0) || a.i - b.i).map(x => x.e);
     const openProposals = new Set(project.proposals.filter(p => p.picked === undefined).map(p => p.elementId));
     const toggle = (id) => { setSelected(s => (s.includes(id) ? s.filter(x => x !== id) : [...s, id])); };
     return _jsxs("div", { className: css.scroll, children: [project.elementErrors.length > 0 && _jsxs("div", { className: css.notice, "data-tone": "error", children: [_jsx("strong", { children: t('elements.errors', { count: project.elementErrors.length }) }), _jsx("ul", { className: css.plainList, children: project.elementErrors.slice(0, 6).map((f, i) => _jsxs("li", { children: [_jsx("code", { children: f.where }), " ", f.message] }, i)) })] }), project.elements.length === 0
@@ -71,7 +73,8 @@ function ElementDetail({ t, sessionId, api, project, element, onBack, insertDraf
     const [parts, setParts] = useState(null);
     const [clip, setClip] = useState(null);
     const [view, setView] = useState(null);
-    const turnTo = (yaw) => { setView(v => ({ yaw, n: (v?.n ?? 0) + 1 })); };
+    const viewN = useRef(0);
+    const turnTo = (yaw) => { viewN.current++; setView({ yaw, n: viewN.current }); };
     useEffect(() => { setClips([]); setClip(null); setParts(null); }, [element.id]);
     useEffect(() => { setLook3d(element.look3d); }, [element.id, element.look3d]);
     const save = (next) => {
@@ -115,9 +118,9 @@ function ElementDetail({ t, sessionId, api, project, element, onBack, insertDraf
     const history = proposals.filter(p => p.picked !== undefined);
     const states = look === null ? [] : Object.keys(look.states);
     const fields = Object.entries(element.stats);
-    return _jsxs("div", { className: css.scroll, children: [_jsx(PanelHeader, { className: css.detailHead, title: element.name, meta: _jsx("span", { title: `${element.id} · ${element.file}`, children: element.type }), onBack: onBack, backLabel: t('elements.back'), moreLabel: t('more') }), look3d !== null ? _jsxs("section", { className: css.lookPanel, children: [_jsx(Preview3D, { api: api, projectId: project.id, version: project.current?.version, look: look3d, mode: "spin", className: css.turntable, emptyLabel: t('look.preview3dEmpty'), onClips: (names, found) => { setClips(names); setParts(found); }, clip: clip, view: view }), clips.length > 0 && _jsx(ChipRow, { label: t('gltf.clips'), value: clip?.name ?? '', onSelect: name => { setClip(c => ({ name, n: (c?.n ?? 0) + 1 })); }, chips: clips.map(name => ({ id: name, label: name })) }), _jsxs("div", { className: css.toolRow, children: [_jsx("span", { className: css.metaLine, children: t('look.drag3d') }), _jsx("span", { className: css.spacer }), _jsxs("span", { role: "group", "aria-label": t('look.views'), className: css.toolRow, children: [_jsx("button", { type: "button", className: css.seg, onClick: () => { turnTo(0); }, children: t('look.front') }), _jsx("button", { type: "button", className: css.seg, onClick: () => { turnTo(90); }, children: t('look.side') }), _jsx("button", { type: "button", className: css.seg, onClick: () => { turnTo(180); }, children: t('look.back') })] }), _jsx("span", { className: css.saveState, "data-state": saving, children: saving === 'idle' ? '' : t(`look.${saving}`) })] }), look3d.kind === 'gltf' && _jsx(GltfControls, { t: t, look: look3d, onChange: save })] }) : _jsxs("section", { className: css.lookPanel, children: [_jsxs("div", { className: css.lookMain, children: [look !== null
+    return _jsxs("div", { className: css.scroll, children: [_jsx(PanelHeader, { className: css.detailHead, title: element.name, meta: _jsx("span", { title: `${element.id} · ${element.file}`, children: element.type }), onBack: onBack, backLabel: t('elements.back'), moreLabel: t('more') }), look3d !== null ? _jsxs("section", { className: css.lookPanel, children: [_jsx(Preview3D, { api: api, projectId: project.id, version: project.current?.version, look: look3d, mode: "spin", className: css.turntable, emptyLabel: t('look.preview3dEmpty'), onClips: (names, found) => { setClips(names); setParts(found); }, onTurned: () => { setView(null); }, clip: clip, view: view }), clips.length > 0 && _jsx(ChipRow, { label: t('gltf.clips'), value: clip?.name ?? autoClip(look3d, clips), onSelect: name => { setClip(c => ({ name, n: (c?.n ?? 0) + 1 })); }, chips: clips.map(name => ({ id: name, label: name })) }), _jsxs("div", { className: `${css.toolRow} ${css.tight}`, children: [_jsx("span", { className: css.metaLine, children: t('look.drag3d') }), _jsx("span", { className: css.spacer }), _jsx("span", { role: "group", "aria-label": t('look.views'), className: css.segGroup, children: [[0, 'look.front'], [90, 'look.side'], [180, 'look.back']].map(([yaw, key]) => _jsx("button", { type: "button", className: css.seg, "aria-pressed": view?.yaw === yaw, onClick: () => { turnTo(yaw); }, children: t(key) }, yaw)) }), _jsx("span", { className: css.saveState, "data-state": saving, children: saving === 'idle' ? '' : t(`look.${saving}`) })] }), look3d.kind === 'gltf' && _jsx(GltfControls, { t: t, look: look3d, onChange: save })] }) : _jsxs("section", { className: css.lookPanel, children: [_jsxs("div", { className: css.lookMain, children: [look !== null
                                 ? _jsx(LookCanvas, { look: look, state: state, box: 208, grid: true, onPaint: paint, className: css.lookEditor })
-                                : _jsxs("div", { className: css.lookEmpty, "data-tone": typeTone(types, element.type), children: [_jsx("p", { children: t('look.none') }), _jsx("button", { type: "button", className: css.ghost, onClick: () => { save(blankLook(stylePalette.length > 0 ? stylePalette : ['#000000', '#ffffff'])); }, children: t('look.start') })] }), look !== null && _jsxs("div", { className: css.lookSide, children: [_jsx("div", { className: css.lookPreview, children: _jsx(LookCanvas, { look: look, state: state, box: 64 }) }), _jsx("span", { className: css.metaLine, children: t('look.inGame') }), _jsx("span", { className: css.saveState, "data-state": saving, children: saving === 'idle' ? '' : t(`look.${saving}`) })] })] }), states.length > 0 && _jsx(ChipRow, { label: t('look.states'), value: state, onSelect: setState, chips: states.map(s => ({ id: s, label: s })) }), look !== null && _jsxs(_Fragment, { children: [_jsxs("div", { className: css.toolRow, role: "group", "aria-label": t('look.tools'), children: [_jsx("button", { type: "button", className: css.seg, "aria-pressed": tool === 'pen', onClick: () => { setTool('pen'); setRecolorFrom(null); }, children: t('look.pen') }), _jsx("button", { type: "button", className: css.seg, "aria-pressed": tool === 'recolor', onClick: () => { setTool('recolor'); }, children: t('look.recolor') }), _jsx("span", { className: css.spacer }), _jsx("span", { className: css.metaLine, children: tool === 'pen' ? t('look.penHint') : recolorFrom === null ? t('look.recolorPick') : t('look.recolorTo') })] }), tool === 'recolor' && _jsx("div", { className: css.swatches, "aria-label": t('look.ownColors'), children: look.palette.map((c, i) => _jsx("button", { type: "button", className: css.swatchBtn, "aria-pressed": recolorFrom === i, style: { background: c }, title: `${LOOK_CHARS[i]} ${c}`, onClick: () => { setRecolorFrom(i); } }, i)) }), _jsxs("div", { className: css.swatches, "aria-label": t('look.styleColors'), children: [tool === 'pen' && _jsx("button", { type: "button", className: css.swatchBtn, "data-erase": "true", "aria-pressed": color === null, title: t('look.erase'), onClick: () => { setColor(null); } }), stylePalette.map(c => _jsx("button", { type: "button", className: css.swatchBtn, style: { background: c }, title: c, "aria-pressed": tool === 'pen' && color === c, onClick: () => {
+                                : _jsxs("div", { className: css.lookEmpty, "data-tone": typeTone(types, element.type), children: [_jsx("p", { children: t('look.none') }), _jsx("button", { type: "button", className: css.ghost, onClick: () => { save(blankLook(stylePalette.length > 0 ? stylePalette : ['#000000', '#ffffff'])); }, children: t('look.start') })] }), look !== null && _jsxs("div", { className: css.lookSide, children: [_jsx("div", { className: css.lookPreview, children: _jsx(LookCanvas, { look: look, state: state, box: 64 }) }), _jsx("span", { className: css.metaLine, children: t('look.inGame') }), _jsx("span", { className: css.saveState, "data-state": saving, children: saving === 'idle' ? '' : t(`look.${saving}`) })] })] }), states.length > 0 && _jsx(ChipRow, { label: t('look.states'), value: state, onSelect: setState, chips: states.map(s => ({ id: s, label: s })) }), look !== null && _jsxs(_Fragment, { children: [_jsxs("div", { className: `${css.toolRow} ${css.tight}`, children: [_jsxs("span", { className: css.segGroup, role: "group", "aria-label": t('look.tools'), children: [_jsx("button", { type: "button", className: css.seg, "aria-pressed": tool === 'pen', onClick: () => { setTool('pen'); setRecolorFrom(null); }, children: t('look.pen') }), _jsx("button", { type: "button", className: css.seg, "aria-pressed": tool === 'recolor', onClick: () => { setTool('recolor'); }, children: t('look.recolor') })] }), _jsx("span", { className: css.spacer }), _jsx("span", { className: css.metaLine, children: tool === 'pen' ? t('look.penHint') : recolorFrom === null ? t('look.recolorPick') : t('look.recolorTo') })] }), tool === 'recolor' && _jsx("div", { className: css.swatches, "aria-label": t('look.ownColors'), children: look.palette.map((c, i) => _jsx("button", { type: "button", className: css.swatchBtn, "aria-pressed": recolorFrom === i, style: { background: c }, title: `${LOOK_CHARS[i]} ${c}`, onClick: () => { setRecolorFrom(i); } }, i)) }), _jsxs("div", { className: css.swatches, "aria-label": t('look.styleColors'), children: [tool === 'pen' && _jsx("button", { type: "button", className: css.swatchBtn, "data-erase": "true", "aria-pressed": color === null, title: t('look.erase'), onClick: () => { setColor(null); } }), stylePalette.map(c => _jsx("button", { type: "button", className: css.swatchBtn, style: { background: c }, title: c, "aria-pressed": tool === 'pen' && color === c, onClick: () => {
                                             if (tool === 'pen')
                                                 setColor(c);
                                             else if (recolorFrom !== null) {
@@ -155,7 +158,7 @@ function GltfControls({ t, look, onChange }) {
     const material = look.material ?? 'toon';
     const [scale, setScale] = useState(String(look.scale ?? 1));
     useEffect(() => { setScale(String(look.scale ?? 1)); }, [look.scale]);
-    return _jsxs("div", { className: css.gltfRow, children: [_jsx("span", { className: css.metaLine, children: t('gltf.file', { src: look.src }) }), _jsx("span", { className: css.spacer }), _jsxs("span", { role: "group", "aria-label": t('gltf.material'), className: css.toolRow, children: [_jsx("button", { type: "button", className: css.seg, "aria-pressed": material === 'toon', onClick: () => { onChange({ ...look, material: 'toon' }); }, children: t('gltf.toon') }), _jsx("button", { type: "button", className: css.seg, "aria-pressed": material === 'original', onClick: () => { onChange({ ...look, material: 'original' }); }, children: t('gltf.original') })] }), _jsxs("label", { className: css.gltfScale, children: [_jsx("span", { className: css.metaLine, children: t('gltf.scale') }), _jsx("input", { className: css.input, inputMode: "decimal", value: scale, onChange: e => { setScale(e.target.value); }, onBlur: () => { const v = Number(scale); if (Number.isFinite(v) && v > 0 && v !== (look.scale ?? 1))
+    return _jsxs("div", { className: css.gltfRow, children: [_jsx("span", { className: css.metaLine, children: t('gltf.file', { src: look.src }) }), _jsx("span", { className: css.spacer }), _jsxs("span", { role: "group", "aria-label": t('gltf.material'), className: css.segGroup, children: [_jsx("button", { type: "button", className: css.seg, "aria-pressed": material === 'toon', onClick: () => { onChange({ ...look, material: 'toon' }); }, children: t('gltf.toon') }), _jsx("button", { type: "button", className: css.seg, "aria-pressed": material === 'original', onClick: () => { onChange({ ...look, material: 'original' }); }, children: t('gltf.original') })] }), _jsxs("label", { className: css.gltfScale, children: [_jsx("span", { className: css.metaLine, children: t('gltf.scale') }), _jsx("input", { className: css.input, inputMode: "decimal", value: scale, onChange: e => { setScale(e.target.value); }, onBlur: () => { const v = Number(scale); if (Number.isFinite(v) && v > 0 && v !== (look.scale ?? 1))
                             onChange({ ...look, scale: v }); }, onKeyDown: e => { if (e.key === 'Enter')
                             e.target.blur(); } })] })] });
 }
@@ -185,3 +188,8 @@ function GltfTweaks({ t, look, parts, onChange }) {
                                                     setBone(name, { rotate: next });
                                                 } }), _jsxs("span", { className: css.paramValue, children: [rot(name)[i], "\u00B0"] })] }, axis))] })] }, name)), shown.length > 40 && _jsx("span", { className: css.metaLine, children: t('gltf.moreBones', { count: shown.length - 40 }) })] })] });
 }
+/** The clip a model plays on its own (dsh3d's rule): the look's choice, else an idle-like name, else the first. */
+function autoClip(look, clips) {
+    const chosen = look.kind === 'gltf' ? look.animation : undefined;
+    return chosen !== undefined && clips.includes(chosen) ? chosen : clips.find(c => /idle|待机|stand/i.test(c)) ?? clips[0] ?? '';
+}

package/lib/types/client/GameTab.js

@@ -11,7 +11,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { PanelHeader, PanelRoot, UnderlineTabs, } from '@khorsheed/dsh-client-ui-panel-kit/src/client/index.ts';
 import { Switch, Tag } from '@deepseek-ai/dsh-client-ui-primitives';
-import { artStyleLabel } from "../project.js";
+import { artStyleLabel, artStyleName } from "../project.js";
 import { exportHtml } from "../vfs.js";
 import { failureOf } from "./contract.js";
 import { DesignView } from "./DesignView.js";
@@ -28,7 +28,7 @@ const PlusIcon = _jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16",
 const ExportIcon = _jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M8 2.5v7M5 6.5l3 3 3-3M3 11v2.5h10V11", stroke: "currentColor", strokeWidth: "1.3", strokeLinecap: "round", strokeLinejoin: "round" }) });
 /** The game tab body. */
 export function GameTab(props) {
-    const { sessionId, t, api, insertDraft, subscribeSessionEvents, touch, subscribeNav, takeNav } = props;
+    const { sessionId, t, api, insertDraft, subscribeSessionEvents, touch, subscribeNav, takeNav, reveal } = props;
     const [state, setState] = useState(null);
     const [error, setError] = useState(null);
     const [rev, setRev] = useState(0);
@@ -38,6 +38,7 @@ export function GameTab(props) {
     const [openElement, setOpenElement] = useState(null);
     const [toastText, setToastText] = useState(null);
     const [openChapter, setOpenChapter] = useState(null);
+    useEffect(() => reveal.mount(), [reveal]);
     const toastTimer = useRef();
     const refresh = useCallback(() => { touch(sessionId); }, [touch, sessionId]);
     const toast = useCallback((text) => {
@@ -78,7 +79,7 @@ export function GameTab(props) {
         return () => { live = false; };
     }, [api, sessionId, rev]);
     const viewProps = {
-        t, sessionId, api, refresh, toast, insertDraft: text => insertDraft(sessionId, text), insertRef: ref => props.insertRef(sessionId, ref),
+        t, sessionId, api, refresh, toast, insertDraft: text => insertDraft(sessionId, text), insertRef: ref => props.insertRef(sessionId, ref), reveal,
     };
     const project = state?.bound ?? null;
     const choose = (projectId) => {
@@ -114,7 +115,10 @@ export function GameTab(props) {
 }
 /** The bound-project workbench. */
 function ProjectWorkbench(p) {
-    const { t, sessionId, api, project, view, setView, styling, setStyling, refresh, toast, insertDraft } = p;
+    const { t, sessionId, api, project, view, setView, styling, setStyling, refresh, toast, insertDraft, reveal } = p;
+    const [, rerender] = useState(0);
+    useEffect(() => reveal.subscribe(() => { rerender(n => n + 1); }), [reveal]);
+    const notice = reveal.notice;
     const autoConfirm = project.manifest?.autoConfirm ?? true;
     const style = project.manifest?.artStyle;
     const exportCurrent = () => {
@@ -145,7 +149,8 @@ function ProjectWorkbench(p) {
     ];
     const failing = project.lastCheck !== null && !project.lastCheck.ok;
     const openProposals = project.proposals.filter(x => x.picked === undefined).length;
-    return _jsxs(PanelRoot, { className: css.root, children: [_jsx(PanelHeader, { title: _jsxs("button", { type: "button", className: css.titleSwitch, onClick: p.onPickProject, title: t('switch'), "aria-haspopup": "dialog", children: [_jsx("span", { children: project.title }), _jsx("span", { className: css.titleCaret, "aria-hidden": "true", children: "\u25BE" })] }), meta: _jsxs("span", { className: css.headMeta, children: [style !== undefined && _jsx(Tag, { tone: "quiet", children: artStyleLabel(style) }), _jsx(Tag, { tone: "quiet", children: project.current === null ? t('meta.noVersion') : t('meta.version', { version: project.current.version }) })] }), extra: _jsx("span", { className: css.switches, children: _jsxs("span", { className: css.switch, title: autoConfirm ? t('autoConfirm.onHint') : t('autoConfirm.offHint'), children: [_jsx(Switch, { checked: autoConfirm, label: t('autoConfirm.label'), onChange: next => { void api.setAutoConfirm(sessionId, project.id, next).then(() => { toast(next ? t('toast.autoOn') : t('toast.autoOff')); refresh(); }); } }), _jsx("span", { className: css.switchLabel, children: t('autoConfirm.label') })] }) }), actions: actions, moreLabel: t('more') }), _jsx(UnderlineTabs, { label: t('tabs.label'), value: view, onChange: setView, tabs: [
+    // Any touch in the panel means the user is busy here: the agent's request waits as a notice.
+    return _jsxs(PanelRoot, { className: css.root, onPointerDownCapture: () => { reveal.touched(); }, onKeyDownCapture: () => { reveal.touched(); }, children: [_jsx(PanelHeader, { title: _jsxs("button", { type: "button", className: css.titleSwitch, onClick: p.onPickProject, title: t('switch'), "aria-haspopup": "dialog", children: [_jsx("span", { children: project.title }), _jsx("span", { className: css.titleCaret, "aria-hidden": "true", children: "\u25BE" })] }), meta: _jsxs("span", { className: css.headMeta, children: [style !== undefined && _jsx("span", { title: artStyleLabel(style), children: _jsx(Tag, { tone: "quiet", children: artStyleName(style) }) }), _jsx(Tag, { tone: "quiet", children: project.current === null ? t('meta.noVersion') : t('meta.version', { version: project.current.version }) })] }), extra: _jsx("span", { className: css.switches, children: _jsxs("span", { className: css.switch, title: autoConfirm ? t('autoConfirm.onHint') : t('autoConfirm.offHint'), children: [_jsx(Switch, { checked: autoConfirm, label: t('autoConfirm.label'), onChange: next => { void api.setAutoConfirm(sessionId, project.id, next).then(() => { toast(next ? t('toast.autoOn') : t('toast.autoOff')); refresh(); }); } }), _jsx("span", { className: css.switchLabel, children: t('autoConfirm.label') })] }) }), actions: actions, moreLabel: t('more') }), _jsx(UnderlineTabs, { label: t('tabs.label'), value: view, onChange: setView, tabs: [
                     { id: 'play', label: t('tabs.play'), badge: project.candidate !== null ? '●' : undefined },
                     { id: 'elements', label: t('tabs.elements'), badge: project.elementErrors.length > 0 ? '!' : openProposals > 0 ? '●' : project.elements.length || undefined },
                     { id: 'design', label: t('tabs.design') },
@@ -159,7 +164,7 @@ function ProjectWorkbench(p) {
                                 setStyling(false);
                                 refresh();
                             });
-                        } })] }), _jsx(CommitBar, { ...p, project: project, onOpenVersions: () => { setView('versions'); } }), view === 'play' && _jsx(PlayView, { ...p, onOpenElement: id => { p.setOpenElement(id); setView('elements'); }, onOpenVersions: () => { setView('versions'); } }), view === 'elements' && _jsx(ElementsView, { ...p, openId: p.openElement, onOpen: p.setOpenElement }), view === 'design' && _jsx(DesignView, { ...p, openChapter: p.openChapter, onOpenChapter: p.setOpenChapter, onStyle: () => { setStyling(true); } }), view === 'versions' && _jsx(VersionsView, { ...p }), p.foot] });
+                        } })] }), _jsx(CommitBar, { ...p, project: project, onOpenVersions: () => { setView('versions'); } }), notice !== null && _jsxs("div", { className: css.navNotice, role: "status", children: [_jsx("span", { className: css.navNoticeText, children: notice.text }), _jsx("button", { type: "button", className: css.primary, onClick: () => { reveal.follow(); }, children: t('nav.go') }), _jsx("button", { type: "button", className: css.link, onClick: () => { reveal.dismiss(); }, children: t('nav.dismiss') })] }), view === 'play' && _jsx(PlayView, { ...p, onOpenElement: id => { p.setOpenElement(id); setView('elements'); }, onOpenVersions: () => { setView('versions'); } }), view === 'elements' && _jsx(ElementsView, { ...p, openId: p.openElement, onOpen: p.setOpenElement }), view === 'design' && _jsx(DesignView, { ...p, openChapter: p.openChapter, onOpenChapter: p.setOpenChapter, onStyle: () => { setStyling(true); } }), view === 'versions' && _jsx(VersionsView, { ...p }), p.foot] });
 }
 /**
  * 有新改动还没进游戏: whatever the working files hold that the play area

package/lib/types/client/PlayView.js

@@ -25,7 +25,7 @@ function fmt(value, step) {
 }
 /** The play view. */
 export function PlayView(props) {
-    const { t, sessionId, api, project, refresh, toast, insertDraft, insertRef, onOpenElement, onOpenVersions } = props;
+    const { t, sessionId, api, project, refresh, toast, insertDraft, insertRef, onOpenElement, onOpenVersions, reveal } = props;
     const [which, setWhich] = useState('current');
     const [bundle, setBundle] = useState(null);
     const [error, setError] = useState(null);
@@ -42,6 +42,8 @@ export function PlayView(props) {
     // Playing is opt-in (2026-10-10): a big game should not start, and cost, on
     // every visit. A new version stops the old run and shows its poster.
     const [playing, setPlaying] = useState(false);
+    // A running game is never navigated away from (the agent's request waits as a notice).
+    useEffect(() => { reveal.setPlaying(playing); return () => { reveal.setPlaying(false); }; }, [reveal, playing]);
     const [poster, setPoster] = useState(null);
     useEffect(() => { setPlaying(false); setPicking(false); setPicked(null); }, [version, which]);
     useEffect(() => {

package/lib/types/client/Preview3D.d.ts

@@ -39,6 +39,8 @@ export interface Preview3DProps {
         readonly name: string;
         readonly n: number;
     } | null;
+    /** The user turned a turntable by hand (a named view no longer applies). */
+    readonly onTurned?: () => void;
     /** A turntable turns to this side (yaw in degrees: 0 front, 90 side, 180 back; bump `n` to repeat). */
     readonly view?: {
         readonly yaw: number;
@@ -46,5 +48,5 @@ export interface Preview3DProps {
     } | null;
 }
 /** One 3D look preview. */
-export declare function Preview3D({ api, projectId, version, look, mode, className, emptyLabel, placeholder, onClips, clip, view }: Preview3DProps): ReactNode;
+export declare function Preview3D({ api, projectId, version, look, mode, className, emptyLabel, placeholder, onClips, onTurned, clip, view }: Preview3DProps): ReactNode;
 //# sourceMappingURL=Preview3D.d.ts.map

package/lib/types/client/Preview3D.js

@@ -73,7 +73,7 @@ function stillSlot() {
     return { ready, release };
 }
 /** One 3D look preview. */
-export function Preview3D({ api, projectId, version, look, mode, className, emptyLabel, placeholder, onClips, clip, view }) {
+export function Preview3D({ api, projectId, version, look, mode, className, emptyLabel, placeholder, onClips, onTurned, clip, view }) {
     const lookJson = JSON.stringify(look);
     const stillKey = `${projectId}:${version}:${lookJson}`;
     const [files, setFiles] = useState(null);
@@ -138,10 +138,12 @@ export function Preview3D({ api, projectId, version, look, mode, className, empt
             }
             if (data?.gamedev === 'preview-clips' && mode === 'spin')
                 onClips?.(data.names, data.parts);
+            if (data?.gamedev === 'preview-turned' && mode === 'spin')
+                onTurned?.();
         };
         window.addEventListener('message', onMessage);
         return () => { window.removeEventListener('message', onMessage); };
-    }, [mode, stillKey, onClips]);
+    }, [mode, stillKey, onClips, onTurned]);
     useEffect(() => {
         if (view == null || mode !== 'spin' || !booted.current)
             return;