feat(players): NPC disposition types and launch-with-players session tokens

Add Hostile/Neutral/Friendly ring types with session-only inactive overrides on control, plus launch-with-players flow and live player tokens on the map.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/renderer/shared/playerToken/useSceneNpcTokensSession.ts

@@ -3,12 +3,14 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import { ipcChannels } from '../../../shared/ipc/contracts';
 import type {
   SceneNpcTokensSessionEvent,
+  SceneNpcTokensSessionPlacement,
   SceneNpcTokensSessionState,
 } from '../../../shared/types';
 import {
   clampNpcTokenSessionScale,
   DEFAULT_NPC_TOKEN_SESSION_SCALE,
 } from '../../../shared/types/appPlayers';
+import { normalizeNpcDisposition } from '../../../shared/types/npcDisposition';
 import { getDndApi } from '../dndApi';
 
 function withScale(state: SceneNpcTokensSessionState): SceneNpcTokensSessionState {
@@ -18,6 +20,10 @@ function withScale(state: SceneNpcTokensSessionState): SceneNpcTokensSessionStat
   };
 }
 
+function isEmptyPlacement(p: SceneNpcTokensSessionPlacement): boolean {
+  return p.nx === undefined && p.ny === undefined && !p.disposition && !p.inactive;
+}
+
 function applyEvent(
   prev: SceneNpcTokensSessionState,
   event: SceneNpcTokensSessionEvent,
@@ -34,11 +40,69 @@ function applyEvent(
     if (prev.scale === scale) return prev;
     return { ...prev, revision: prev.revision + 1, scale };
   }
+  if (event.kind === 'setDisposition') {
+    const placementId = String(event.placementId ?? '');
+    if (!placementId) return prev;
+    const disposition = normalizeNpcDisposition(event.disposition);
+    const cur = prev.byPlacementId[placementId];
+    if (cur?.disposition === disposition) return prev;
+    return {
+      revision: prev.revision + 1,
+      byPlacementId: {
+        ...prev.byPlacementId,
+        [placementId]: {
+          ...(cur?.nx !== undefined ? { nx: cur.nx } : {}),
+          ...(cur?.ny !== undefined ? { ny: cur.ny } : {}),
+          disposition,
+          ...(cur?.inactive ? { inactive: true } : {}),
+        },
+      },
+      scale: prev.scale ?? DEFAULT_NPC_TOKEN_SESSION_SCALE,
+    };
+  }
+  if (event.kind === 'setInactive') {
+    const placementId = String(event.placementId ?? '');
+    if (!placementId) return prev;
+    const inactive = Boolean(event.inactive);
+    const cur = prev.byPlacementId[placementId];
+    if (Boolean(cur?.inactive) === inactive) return prev;
+    const next: SceneNpcTokensSessionPlacement = {
+      ...(cur?.nx !== undefined ? { nx: cur.nx } : {}),
+      ...(cur?.ny !== undefined ? { ny: cur.ny } : {}),
+      ...(cur?.disposition ? { disposition: cur.disposition } : {}),
+      ...(inactive ? { inactive: true } : {}),
+    };
+    if (isEmptyPlacement(next)) {
+      const { [placementId]: _removed, ...rest } = prev.byPlacementId;
+      return {
+        revision: prev.revision + 1,
+        byPlacementId: rest,
+        scale: prev.scale ?? DEFAULT_NPC_TOKEN_SESSION_SCALE,
+      };
+    }
+    return {
+      revision: prev.revision + 1,
+      byPlacementId: {
+        ...prev.byPlacementId,
+        [placementId]: next,
+      },
+      scale: prev.scale ?? DEFAULT_NPC_TOKEN_SESSION_SCALE,
+    };
+  }
+  // move
+  const placementId = String(event.placementId ?? '');
+  if (!placementId) return prev;
+  const cur = prev.byPlacementId[placementId];
   return {
     revision: prev.revision + 1,
     byPlacementId: {
       ...prev.byPlacementId,
-      [event.placementId]: { nx: event.nx, ny: event.ny },
+      [placementId]: {
+        nx: event.nx,
+        ny: event.ny,
+        ...(cur?.disposition ? { disposition: cur.disposition } : {}),
+        ...(cur?.inactive ? { inactive: true } : {}),
+      },
     },
     scale: prev.scale ?? DEFAULT_NPC_TOKEN_SESSION_SCALE,
   };