@agent-os-lab/agent-game-sdk 0.1.2 → 0.1.4

package/src/office/mount.ts

@@ -3,6 +3,7 @@ import {
   resolveOfficeSource,
 } from "./core/source";
 import { mergeAgentPresence, type GameRuntimeSubscription } from "../runtime-client";
+import { resolveOfficeLayout } from "./layout";
 import type {
   AgentGameOfficeMountOptions,
   AgentGameOfficeRenderer,
@@ -18,6 +19,7 @@ export async function mountAgentGameOffice(
   options: AgentGameOfficeMountOptions,
 ): Promise<AgentGameOfficeController> {
   const renderer = resolveRenderer(options.renderer ?? "three");
+  const officeLayout = resolveOfficeLayout(options.office);
   const mutableSource = options.source.type === "snapshot"
     ? createSnapshotOfficeSource({ agents: options.source.agents })
     : null;
@@ -38,6 +40,7 @@ export async function mountAgentGameOffice(
   controller = await renderer.mount(container, latestSnapshot ?? emptySnapshot(), {
     ...options,
     renderer: options.renderer ?? "three",
+    officeLayout,
   });
 
   if (options.source.type === "runtime" && runtimeSource) {
@@ -72,6 +75,9 @@ export async function mountAgentGameOffice(
     focusAgent(agentId) {
       controller?.focusAgent?.(agentId);
     },
+    refreshAgents() {
+      runtimeSubscription?.refresh();
+    },
     destroy() {
       unsubscribe();
       runtimeSubscription?.close();

package/src/office/react/AgentGameOfficeView.ts

@@ -9,15 +9,27 @@ import type {
 export type AgentGameOfficeViewProps = AgentGameOfficeMountOptions & {
   className?: string;
   style?: React.CSSProperties;
+  onReady?: (controller: AgentGameOfficeController) => void;
+  onDestroy?: () => void;
 };
 
 export function AgentGameOfficeView({
   className,
+  onDestroy,
+  onReady,
   style,
   ...options
 }: AgentGameOfficeViewProps) {
   const containerRef = useRef<HTMLDivElement | null>(null);
   const viewRef = useRef<AgentGameOfficeController | null>(null);
+  const onDestroyRef = useRef(onDestroy);
+  const onReadyRef = useRef(onReady);
+  const officeConfigKey = createOfficeConfigKey(options.office);
+
+  useEffect(() => {
+    onReadyRef.current = onReady;
+    onDestroyRef.current = onDestroy;
+  }, [onDestroy, onReady]);
 
   useEffect(() => {
     const container = containerRef.current;
@@ -32,14 +44,16 @@ export function AgentGameOfficeView({
         return;
       }
       viewRef.current = view;
+      onReadyRef.current?.(view);
     });
 
     return () => {
       disposed = true;
       viewRef.current?.destroy();
       viewRef.current = null;
+      onDestroyRef.current?.();
     };
-  }, [options.renderer, options.source]);
+  }, [options.renderer, options.source, officeConfigKey]);
 
   useEffect(() => {
     viewRef.current?.focusAgent(options.focusedAgentId ?? null);
@@ -56,3 +70,13 @@ export function AgentGameOfficeView({
     },
   });
 }
+
+function createOfficeConfigKey(office: AgentGameOfficeMountOptions["office"]): string {
+  if (!office) {
+    return "default";
+  }
+  return JSON.stringify(office.rooms.map((room) => ({
+    type: room.type,
+    capacity: room.capacity ?? null,
+  })));
+}

package/src/office/renderers/three/agent-body-instancing.ts

@@ -84,6 +84,7 @@ export class AgentBodyInstancedLayer {
     );
     mesh.castShadow = false;
     mesh.receiveShadow = false;
+    mesh.frustumCulled = false;
     mesh.name = `agentBody:${key}`;
     this.scene.add(mesh);
 

package/src/office/renderers/three/agent-effect-instancing.ts

@@ -85,6 +85,7 @@ export class AgentEffectInstancedLayer {
     );
     mesh.castShadow = false;
     mesh.receiveShadow = false;
+    mesh.frustumCulled = false;
     mesh.name = `agentEffect:${key}`;
     this.scene.add(mesh);
 

package/src/office/renderers/three/agent-layout.ts

@@ -2,71 +2,27 @@ import * as THREE from "three";
 
 import type { AgentGameOfficeAgent } from "../../core/types";
 import {
-  DESK_SEATS,
-  LARGE_MEETING_X,
-  LARGE_MEETING_Z,
-  LOUNGE_CENTER,
-  MEETING_SEATS,
-  OFFICE_LAYOUT_SCALE,
-  scaleOfficeX,
-  scaleOfficeZ,
-} from "./scene";
+  resolveOfficeAgentAnchor,
+  type ResolvedOfficeLayout,
+} from "../../layout";
 
 export function resolveAgentPosition(
   agent: AgentGameOfficeAgent,
   index: number,
   totalAgents: number,
+  layout: ResolvedOfficeLayout,
 ): THREE.Vector3 {
   if (agent.targetPosition) {
     return new THREE.Vector3(agent.targetPosition.x, 0, agent.targetPosition.z);
   }
-  switch (agent.zoneId) {
-    case "desk":
-      return new THREE.Vector3(
-        DESK_SEATS[index % DESK_SEATS.length]!.x,
-        0,
-        DESK_SEATS[index % DESK_SEATS.length]!.z,
-      );
-    case "meeting-room":
-      return new THREE.Vector3(
-        MEETING_SEATS[index % MEETING_SEATS.length]!.x,
-        0,
-        MEETING_SEATS[index % MEETING_SEATS.length]!.z,
-      );
-    case "lounge":
-      return new THREE.Vector3(
-        LOUNGE_CENTER.x - 1.7 * OFFICE_LAYOUT_SCALE + (index % 4) * 1.15 * OFFICE_LAYOUT_SCALE,
-        0,
-        LOUNGE_CENTER.z - 0.8 * OFFICE_LAYOUT_SCALE + Math.floor(index / 4) * 0.95 * OFFICE_LAYOUT_SCALE,
-      );
-    case "pantry":
-      return new THREE.Vector3(scaleOfficeX(-9.2), 0, scaleOfficeZ(5.2 + index * 0.4));
-    case "review-area": {
-      const angle = (index / Math.max(totalAgents, 1)) * Math.PI * 2;
-      return new THREE.Vector3(
-        scaleOfficeX(0.5) + Math.cos(angle) * 2.2 * OFFICE_LAYOUT_SCALE,
-        0,
-        scaleOfficeZ(4) + Math.sin(angle) * 1.4 * OFFICE_LAYOUT_SCALE,
-      );
-    }
-    case "offstage":
-      return new THREE.Vector3(scaleOfficeX(-13), 0, scaleOfficeZ(8));
-  }
+  void index;
+  void totalAgents;
+  const anchor = resolveOfficeAgentAnchor(layout, agent);
+  return new THREE.Vector3(anchor.position.x, 0, anchor.position.z);
 }
 
-export function resolveAgentFacingTarget(agent: AgentGameOfficeAgent): THREE.Vector3 {
-  switch (agent.zoneId) {
-    case "desk":
-      return new THREE.Vector3(scaleOfficeX(-7), 0, scaleOfficeZ(-5));
-    case "meeting-room":
-      return new THREE.Vector3(LARGE_MEETING_X, 0, LARGE_MEETING_Z);
-    case "lounge":
-      return new THREE.Vector3(LOUNGE_CENTER.x, 0, LOUNGE_CENTER.z);
-    case "review-area":
-      return new THREE.Vector3(scaleOfficeX(0.5), 0, scaleOfficeZ(3.05));
-    case "pantry":
-      return new THREE.Vector3(scaleOfficeX(-9.2), 0, scaleOfficeZ(5.2));
-    case "offstage":
-      return new THREE.Vector3(scaleOfficeX(-13), 0, scaleOfficeZ(8));
-  }
+export function resolveAgentFacingTarget(agent: AgentGameOfficeAgent, layout: ResolvedOfficeLayout): THREE.Vector3 {
+  const anchor = resolveOfficeAgentAnchor(layout, agent);
+  const facing = anchor.facing ?? anchor.position;
+  return new THREE.Vector3(facing.x, 0, facing.z);
 }

package/src/office/renderers/three/mount.ts

@@ -32,6 +32,8 @@ type AgentMeshRecord = {
 
 export const THREE_RENDERER_PIXEL_RATIO_LIMIT = 1.5;
 export const THREE_RENDERER_TARGET_FPS = 30;
+export const THREE_RENDERER_MIN_CAMERA_DISTANCE = 8;
+export const THREE_RENDERER_MAX_CAMERA_DISTANCE = 150;
 
 export function createOfficeMouseButtons(): OrbitControls["mouseButtons"] {
   return {
@@ -89,8 +91,8 @@ export function mountThreeAgentGameOffice(
   controls.enableRotate = true;
   controls.enableZoom = true;
   controls.mouseButtons = createOfficeMouseButtons();
-  controls.minDistance = 8;
-  controls.maxDistance = 70;
+  controls.minDistance = THREE_RENDERER_MIN_CAMERA_DISTANCE;
+  controls.maxDistance = THREE_RENDERER_MAX_CAMERA_DISTANCE;
   controls.maxPolarAngle = Math.PI * 0.48;
   controls.addEventListener("change", () => {
     labelsDirty = true;
@@ -112,7 +114,7 @@ export function mountThreeAgentGameOffice(
   container.appendChild(root);
 
   addLights(scene);
-  buildOfficeScene(scene);
+  buildOfficeScene(scene, _options.officeLayout);
   const agentBodyLayer = createAgentBodyInstancedLayer(scene);
   const agentEffectLayer = createAgentEffectInstancedLayer(scene);
 
@@ -135,7 +137,7 @@ export function mountThreeAgentGameOffice(
     snapshot.agents.forEach((agent, index) => {
       const record = agents.get(agent.id) ?? createAgentRecord(agent, index);
       agents.set(agent.id, record);
-      const target = resolveAgentPosition(agent, index, snapshot.agents.length);
+      const target = resolveAgentPosition(agent, index, snapshot.agents.length, _options.officeLayout);
       record.agent = agent;
       record.renderIndex = index;
       record.target.copy(target);
@@ -148,7 +150,7 @@ export function mountThreeAgentGameOffice(
 
   function createAgentRecord(agent: AgentGameOfficeAgent, index: number): AgentMeshRecord {
     const mesh = createAgentMesh(agent, index);
-    const position = resolveAgentPosition(agent, index, initialSnapshot.agents.length);
+    const position = resolveAgentPosition(agent, index, initialSnapshot.agents.length, _options.officeLayout);
     mesh.group.position.copy(position);
     scene.add(mesh.group);
 
@@ -180,7 +182,7 @@ export function mountThreeAgentGameOffice(
         mesh: record.mesh,
         agent: record.agent,
         target: record.target,
-        facingTarget: resolveAgentFacingTarget(record.agent),
+        facingTarget: resolveAgentFacingTarget(record.agent, _options.officeLayout),
         elapsedSeconds,
         deltaSeconds,
       });