@agent-os-lab/agent-game-sdk 0.1.12 → 0.1.13

package/package.json

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

package/src/avatar/canvas-view.ts

@@ -1,10 +1,27 @@
-import {
-  AgentGameError,
-  normalizeAgentAvatarAnimationFrames,
-  validateAgentAvatarDefinition,
-  type AgentAvatarAnimationName,
-  type AgentAvatarDefinition,
-} from "../core";
+import { AgentGameError } from "../core/errors";
+
+const REQUIRED_AGENT_AVATAR_ANIMATIONS = [
+  "idle.down",
+  "idle.up",
+  "idle.left",
+  "idle.right",
+  "walk.down",
+  "walk.up",
+  "walk.left",
+  "walk.right",
+  "work.typing",
+  "emote.think",
+  "emote.talk",
+] as const;
+
+export type AgentAvatarAnimationName = (typeof REQUIRED_AGENT_AVATAR_ANIMATIONS)[number];
+export type AgentAvatarAnimationFrames = string | string[];
+export type AgentAvatarDefinition = {
+  id: string;
+  imageUrl: string;
+  atlasUrl: string;
+  animations: Partial<Record<AgentAvatarAnimationName, AgentAvatarAnimationFrames>> & Record<string, AgentAvatarAnimationFrames>;
+};
 
 export type AgentAvatarAtlasFrame = {
   frame: {
@@ -195,6 +212,37 @@ function resolveAnimationFrameName(
   return frames[index]!;
 }
 
+function validateAgentAvatarDefinition(avatar: AgentAvatarDefinition): AgentAvatarDefinition {
+  assertNonEmpty(avatar.id, "avatar id");
+  assertNonEmpty(avatar.imageUrl, "avatar image url");
+  assertNonEmpty(avatar.atlasUrl, "avatar atlas url");
+
+  for (const animation of REQUIRED_AGENT_AVATAR_ANIMATIONS) {
+    if (!avatar.animations[animation]) {
+      throw new AgentGameError("missing_animation", `Agent game avatar ${avatar.id} is missing animation: ${animation}`);
+    }
+    const frames = normalizeAgentAvatarAnimationFrames(avatar.animations[animation]);
+    if (frames.length === 0) {
+      throw new AgentGameError("missing_animation", `Agent game avatar ${avatar.id} is missing animation: ${animation}`);
+    }
+  }
+
+  return avatar;
+}
+
+function normalizeAgentAvatarAnimationFrames(frames: AgentAvatarAnimationFrames | undefined): string[] {
+  if (frames === undefined) {
+    return [];
+  }
+  return Array.isArray(frames) ? frames : [frames];
+}
+
+function assertNonEmpty(value: string, field: string): void {
+  if (!value || value.trim().length === 0) {
+    throw new AgentGameError("invalid_asset_manifest", `Agent game ${field} must not be empty`);
+  }
+}
+
 function assertPositiveFiniteInteger(value: number, field: string): number {
   if (!Number.isInteger(value) || value <= 0) {
     throw new AgentGameError("invalid_asset_manifest", `Agent avatar canvas ${field} must be a positive integer`);

package/src/avatar/three-view.ts

@@ -1,7 +1,7 @@
 import * as THREE from "three";
 
 import type { AgentGameOfficeAgent, AgentGameOfficeSceneState } from "../office/core/types";
-import { AgentGameError } from "../core";
+import { AgentGameError } from "../core/errors";
 import {
   createAgentAvatar3DScene,
   type ResolvedAgentAvatar3DState,