@agent-os-lab/agent-game-sdk 0.1.6 → 0.1.8

package/README.md

@@ -14,7 +14,6 @@ import { mountAgentGameOffice } from "@agent-os-lab/agent-game-sdk/office";
 
 const client = new AgentGameRuntimeBrowserClient({
   baseUrl: "",
-  tokenPath: "/api/agent-game-runtime-token",
   accessToken: async () => getScopedToken(),
 });
 
@@ -94,7 +93,9 @@ Built-in room types are `office`, `auditorium`, and `gym`. `capacity` is optiona
 
 Runtime statuses stay unchanged. The SDK locally distributes `idle` and `resting` agents across ambient areas such as lounge, pantry, gym, and reading/bookcase anchors so inactive agents do not all gather at the sofa.
 
-Browser clients should call an application BFF endpoint. Keep the AgentOS service API key on the server; the SDK server client forwards it to Agent Game Runtime:
+Browser clients should call an application BFF endpoint. By default the browser client requests `/api/agent-game-runtime-token` on the same origin. Configure `tokenPath` only if your application exposes that BFF route at a different path.
+
+Keep the AgentOS service API key on the server; the SDK server client forwards it to Agent Game Runtime. The runtime token endpoint path is SDK-managed and defaults to Agent Game Runtime's `/api/v1/game-runtime-token`, so application code only needs `baseUrl` and `apiKey`:
 
 ```ts
 import { AgentGameRuntimeServerClient } from "@agent-os-lab/agent-game-sdk";

package/USAGE.md

@@ -73,16 +73,16 @@ import { AgentGameRuntimeBrowserClient } from "@agent-os-lab/agent-game-sdk";
 
 const browserClient = new AgentGameRuntimeBrowserClient({
   baseUrl: "",
-  tokenPath: "/api/agent-game-runtime-token",
 });
 ```
 
+The default browser token path is `/api/agent-game-runtime-token`. Configure `tokenPath` only when your application exposes its BFF/proxy endpoint at a different same-origin path. This browser path is not the Agent Game Runtime service path.
+
 If your application backend expects an application-scoped browser token, provide `accessToken`. This token is for your BFF/proxy, not for Agent Game Runtime directly.
 
 ```ts
 const browserClient = new AgentGameRuntimeBrowserClient({
   baseUrl: "",
-  tokenPath: "/api/agent-game-runtime-token",
   accessToken: async () => getScopedApplicationToken(),
 });
 ```
@@ -141,7 +141,6 @@ import { mountAgentGameOffice } from "@agent-os-lab/agent-game-sdk/office";
 
 const client = new AgentGameRuntimeBrowserClient({
   baseUrl: "",
-  tokenPath: "/api/agent-game-runtime-token",
 });
 
 const view = await mountAgentGameOffice(container, {
@@ -318,6 +317,8 @@ AGENT_GAME_RUNTIME_BASE_URL=http://localhost:3107 AGENTOS_API_KEY=... bun run de
 
 Open `http://localhost:7357`.
 
+The demo exposes the browser BFF route at `/api/agent-game-runtime-token`. It does not require `AGENT_GAME_RUNTIME_TOKEN_PATH`; the SDK server client owns the runtime token path and uses Agent Game Runtime's default `/api/v1/game-runtime-token`.
+
 Set `PORT=7358` or another value to change the port.
 
 ## Publish

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-os-lab/agent-game-sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "files": [
     "src",

package/src/office/core/projection.ts

@@ -29,7 +29,7 @@ export function mapPresenceToOfficeAgents(
     role: agent.scene ?? null,
     statusLabel: statusLabels[agent.status],
     activity: agent.activity,
-    activityLabel: sanitizeActivityLabel(agent.activity),
+    activityLabel: sanitizeActivityLabel(agent.activity, agent.status),
     sceneState: mapStatusToSceneState(agent.status),
     zoneId: mapStatusToZoneId(agent.status, agent.agentId),
     updatedAt: agent.updatedAt,
@@ -68,7 +68,13 @@ function mapStatusToSceneState(status: AgentPresenceStatus): AgentGameOfficeScen
   return status;
 }
 
-function sanitizeActivityLabel(activity: AgentPresence["activity"]): string | undefined {
+function sanitizeActivityLabel(
+  activity: AgentPresence["activity"],
+  status: AgentPresenceStatus,
+): string | undefined {
+  if (!isActiveWorkStatus(status)) {
+    return undefined;
+  }
   if (activity?.kind === "completed") {
     return undefined;
   }
@@ -108,6 +114,10 @@ function formatToolActivityLabel(label: string): string {
   return label === "正在使用工具" ? "正在调用工具..." : label;
 }
 
+function isActiveWorkStatus(status: AgentPresenceStatus): boolean {
+  return status === "working" || status === "thinking";
+}
+
 function mapStatusToZoneId(status: AgentPresenceStatus, agentId: string): AgentGameOfficeZoneId {
   switch (status) {
     case "working":

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

@@ -44,6 +44,7 @@ const WORKING_FOLLOW_RESET_DELAY_MS = 30_000;
 const WORK_EXIT_WAIT_MS = 30_000;
 const WORKING_FOLLOW_CAMERA_OFFSET = new THREE.Vector3(9, 12, 12);
 const OFFICE_CAMERA_TRANSITION_DURATION_MS = 600;
+const OFFICE_CAMERA_UP = new THREE.Vector3(0, 1, 0);
 
 export type WorkingAgentFollowState = {
   selectedAgentId: string | null;
@@ -478,14 +479,14 @@ export function createFollowOfficeCameraView(agentPosition: THREE.Vector3): Offi
   const target = new THREE.Vector3(agentPosition.x, 1, agentPosition.z);
   const position = target.clone().add(WORKING_FOLLOW_CAMERA_OFFSET);
   const rotation = new THREE.Euler();
-  const matrix = new THREE.Matrix4().lookAt(position, target, new THREE.Vector3(0, 1, 0));
+  const matrix = new THREE.Matrix4().lookAt(position, target, OFFICE_CAMERA_UP);
   rotation.setFromRotationMatrix(matrix);
 
   return {
     position,
     rotation,
     target,
-    up: new THREE.Vector3(0, 1, 0),
+    up: OFFICE_CAMERA_UP.clone(),
     distance: position.distanceTo(target),
   };
 }
@@ -502,16 +503,20 @@ export function createInitialOfficeCameraView(
   );
   const quaternion = new THREE.Quaternion().setFromEuler(rotation);
   const forward = new THREE.Vector3(0, 0, -1).applyQuaternion(quaternion).normalize();
-  const up = new THREE.Vector3(0, 1, 0).applyQuaternion(quaternion).normalize();
   const target = new THREE.Vector3(layout.scene.center.x, OFFICE_CAMERA_BOUNDS_HEIGHT / 2, layout.scene.center.z);
-  const distance = resolveOfficeCameraDistance(layout, target, quaternion, aspect, fovDegrees);
+  const preliminaryPosition = target.clone().sub(forward.clone());
+  const orbitRotation = new THREE.Euler();
+  const matrix = new THREE.Matrix4().lookAt(preliminaryPosition, target, OFFICE_CAMERA_UP);
+  orbitRotation.setFromRotationMatrix(matrix);
+  const orbitQuaternion = new THREE.Quaternion().setFromEuler(orbitRotation);
+  const distance = resolveOfficeCameraDistance(layout, target, orbitQuaternion, aspect, fovDegrees);
   const position = target.clone().sub(forward.multiplyScalar(distance));
 
   return {
     position,
-    rotation,
+    rotation: orbitRotation,
     target,
-    up,
+    up: OFFICE_CAMERA_UP.clone(),
     distance,
   };
 }