@agent-play/sdk 3.2.1 → 3.3.2

package/dist/{browser-CvtF5qSC.d.ts → browser-BQR40I8R.d.ts}

@@ -119,7 +119,7 @@ type AddAgentInput = PlatformAgentInformation & {
  * tools are indexed for the watch UI).
  *
  * **`agentId`** is required: use an id from **`agent-play create`** when the server uses a repository
- * (with account **`password`** from **`RemotePlayWorld`**), or any stable string for local dev without Redis.
+ * (with account **`passwHash`** from **`RemotePlayWorld`**), or any stable string for local dev without Redis.
  */
 type AddPlayerInput = PlatformAgentInformation & {
     /** Registration from {@link langchainRegistration}. */
@@ -128,7 +128,12 @@ type AddPlayerInput = PlatformAgentInformation & {
     mainNodeId?: string;
     /** Registered agent id (or session-local id without Redis). */
     agentId: string;
-    /** @inheritdoc AddAgentInput.enableP2a */
+    /**
+     * When **`"on"`**, registration enables OpenAI Realtime provisioning for this agent.
+     * Omitted or **`"off"`** disables realtime voice for this registration.
+     *
+     * Same semantics as {@link AddAgentInput} **`enableP2a`**.
+     */
     enableP2a?: P2aEnableFlag;
 };
 /** Zone counter event surfaced on snapshots and signals. */
@@ -260,10 +265,39 @@ type AgentPlayWorldMapMcpOccupant = {
     y: number;
     url?: string;
 };
+type AgentPlaySpaceAmenityKind = "supermarket" | "shop" | "car_wash";
+type AgentPlaySpaceOwner = {
+    displayName: string;
+    playerId?: string;
+    nodeId?: string;
+};
+type AgentPlaySpaceCatalogEntry = {
+    id: string;
+    name: string;
+    description: string;
+    designKey: string;
+    owner: AgentPlaySpaceOwner;
+    amenities: AgentPlaySpaceAmenityKind[];
+    activityObjectIds?: string[];
+};
+/** Map anchor linking one or more authored spaces (see {@link AgentPlaySpaceCatalogEntry}). */
+type AgentPlayWorldMapStructureOccupant = {
+    kind: "structure";
+    id: string;
+    name: string;
+    x: number;
+    y: number;
+    worldId: string;
+    spaceIds: string[];
+    /** When true, the anchor is fixed map furniture (e.g. authored spaces). */
+    stationary?: boolean;
+    primaryAmenity?: AgentPlaySpaceAmenityKind;
+    amenities?: AgentPlaySpaceAmenityKind[];
+};
 /** Spatial index: axis-aligned bounds plus every agent and MCP registration placed on the grid. */
 type AgentPlayWorldMap = {
     bounds: AgentPlayWorldMapBounds;
-    occupants: (AgentPlayWorldMapHumanOccupant | AgentPlayWorldMapAgentOccupant | AgentPlayWorldMapMcpOccupant)[];
+    occupants: (AgentPlayWorldMapHumanOccupant | AgentPlayWorldMapAgentOccupant | AgentPlayWorldMapMcpOccupant | AgentPlayWorldMapStructureOccupant)[];
 };
 /**
  * Session snapshot from {@link RemotePlayWorld.getWorldSnapshot}.
@@ -272,6 +306,7 @@ type AgentPlayWorldMap = {
 type AgentPlaySnapshot = {
     sid: string;
     worldMap: AgentPlayWorldMap;
+    spaces?: AgentPlaySpaceCatalogEntry[];
     mcpServers?: Array<{
         id: string;
         name: string;
@@ -310,9 +345,20 @@ type PlayerChainOccupantPresentNode = {
     kind: "occupant";
     stableKey: string;
     removed: false;
-    occupant: AgentPlayWorldMapHumanOccupant | AgentPlayWorldMapAgentOccupant | AgentPlayWorldMapMcpOccupant;
+    occupant: AgentPlayWorldMapHumanOccupant | AgentPlayWorldMapAgentOccupant | AgentPlayWorldMapMcpOccupant | AgentPlayWorldMapStructureOccupant;
+};
+type PlayerChainSpaceRemovedNode = {
+    kind: "space";
+    stableKey: string;
+    removed: true;
+};
+type PlayerChainSpacePresentNode = {
+    kind: "space";
+    stableKey: string;
+    removed: false;
+    space: AgentPlaySpaceCatalogEntry;
 };
-type PlayerChainNodeResponse = PlayerChainGenesisNode | PlayerChainHeaderNode | PlayerChainOccupantRemovedNode | PlayerChainOccupantPresentNode;
+type PlayerChainNodeResponse = PlayerChainGenesisNode | PlayerChainHeaderNode | PlayerChainOccupantRemovedNode | PlayerChainOccupantPresentNode | PlayerChainSpaceRemovedNode | PlayerChainSpacePresentNode;
 /** Full journey + path update (SSE `world:journey`); coordinates are embedded in `path` steps. */
 type WorldJourneyUpdate = {
     playerId: string;
@@ -366,6 +412,58 @@ declare function boundsContain(bounds: WorldBounds, p: {
     y: number;
 }): boolean;
 
+type OccupancyGridPoint = {
+    x: number;
+    y: number;
+};
+declare const OCCUPANCY_POINT_MULTIPLIER = 5;
+declare const CONTINUOUS_RENDER_OFFSET = 0.2;
+declare const DEFAULT_AGENT_SPAWN_MIN_DISTANCE = 0.9;
+/** Bottom-left zone Q1 — agents (spatial rectangle). */
+declare const SPATIAL_ZONE_INDEX_AGENTS = 0;
+/** Top-left zone Q3 — spaces / amenities (spatial rectangle). */
+declare const SPATIAL_ZONE_INDEX_SPACES = 2;
+declare function spatialZoneBounds(quartileIndex: number): WorldBounds;
+declare function spatialZoneCenter(quartileIndex: number): OccupancyGridPoint;
+declare function pointCellInSpatialZone(wx: number, wy: number, zoneIndex: number): boolean;
+declare function listOccupancyPointsForSpatialZone(zoneIndex: number): readonly OccupancyGridPoint[];
+declare function occupancyPointsGroupedBySpatialZone(): readonly (readonly OccupancyGridPoint[])[];
+/** Agent spawns: Q1 only. */
+declare function listAllowedOccupancyPoints(): readonly OccupancyGridPoint[];
+declare function occupancyKeyForPosition(x: number, y: number): string;
+declare function buildRankedOccupancyPointsForSpatialZone(zoneIndex: number): OccupancyGridPoint[];
+/** Back-compat: agent-zone ranking only. */
+declare function buildRankedOccupancyPoints(): OccupancyGridPoint[];
+declare function boundingWorldRectForOccupancyPoints(points: readonly OccupancyGridPoint[]): {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+} | null;
+declare function isAgentSpawnOccupancyPointAvailable(input: {
+    point: OccupancyGridPoint;
+    occupiedKeys: ReadonlySet<string>;
+    existingOccupants: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    minDistance?: number;
+}): boolean;
+declare function isSpaceAnchorOccupancyPointAvailable(input: {
+    point: OccupancyGridPoint;
+    occupiedKeys: ReadonlySet<string>;
+    existingOccupants: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    structureAnchors: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    minDistance: number;
+    structureMinDistance: number;
+}): boolean;
+
 /**
  * Parses **`playerChainNotify`** envelopes and merges {@link PlayerChainNodeResponse} slices into {@link AgentPlaySnapshot} (pure functions + fetch ordering for serialized RPC).
  */
@@ -379,4 +477,4 @@ declare function mergeSnapshotWithPlayerChainNode(snapshot: AgentPlaySnapshot, n
 declare const PLAYER_CHAIN_GENESIS_STABLE_KEY: "__genesis__";
 declare const PLAYER_CHAIN_HEADER_STABLE_KEY: "__header__";
 
-export { type AgentPlaySnapshot as A, type RemotePlayWorldOpenAiAudioOptions as B, type WorldBounds as C, type DestinationJourneyStep as D, type WorldJourneyUpdate as E, boundsContain as F, clampWorldPosition as G, expandBoundsToMinimumPlayArea as H, mergeSnapshotWithPlayerChainNode as I, type Journey as J, parsePlayerChainFanoutNotify as K, type LangChainAgentRegistration as L, MINIMUM_PLAY_WORLD_BOUNDS as M, parsePlayerChainFanoutNotifyFromSsePayload as N, type OriginJourneyStep as O, type PlayerChainNodeResponse as P, parsePlayerChainNodeRpcBody as Q, type RemotePlayWorldInitAudioOptions as R, type StructureJourneyStep as S, sortNodeRefsForSerializedFetch as T, type WorldInteractionRole as W, type YieldEventInfo as Y, type ZoneEventInfo as Z, type AddAgentInput as a, type RegisteredPlayer as b, type AddPlayerInput as c, type RecordInteractionInput as d, type AgentPlayWorldMap as e, type AgentPlayWorldMapAgentOccupant as f, type AgentPlayWorldMapBounds as g, type AgentPlayWorldMapMcpOccupant as h, type AssistToolFieldType as i, type AssistToolParameterSpec as j, type AssistToolSpec as k, type JourneyStep as l, type P2aEnableFlag as m, PLAYER_CHAIN_GENESIS_STABLE_KEY as n, PLAYER_CHAIN_HEADER_STABLE_KEY as o, type PlatformAgentInformation as p, type PlayAgentInformation as q, type PlayerChainFanoutNotify as r, type PlayerChainGenesisNode as s, type PlayerChainHeaderNode as t, type PlayerChainNotifyNodeRef as u, type PlayerChainOccupantPresentNode as v, type PlayerChainOccupantRemovedNode as w, type PositionedStep as x, type RealtimeWebrtcClientSecret as y, type RegisteredAgentSummary as z };
+export { isAgentSpawnOccupancyPointAvailable as $, type AgentPlaySnapshot as A, type PositionedStep as B, CONTINUOUS_RENDER_OFFSET as C, DEFAULT_AGENT_SPAWN_MIN_DISTANCE as D, type RealtimeWebrtcClientSecret as E, type RegisteredAgentSummary as F, type RemotePlayWorldOpenAiAudioOptions as G, SPATIAL_ZONE_INDEX_SPACES as H, type StructureJourneyStep as I, type Journey as J, type WorldBounds as K, type LangChainAgentRegistration as L, MINIMUM_PLAY_WORLD_BOUNDS as M, type WorldJourneyUpdate as N, OCCUPANCY_POINT_MULTIPLIER as O, type PlayerChainNodeResponse as P, boundingWorldRectForOccupancyPoints as Q, type RemotePlayWorldInitAudioOptions as R, SPATIAL_ZONE_INDEX_AGENTS as S, boundsContain as T, buildRankedOccupancyPoints as U, buildRankedOccupancyPointsForSpatialZone as V, type WorldInteractionRole as W, clampWorldPosition as X, type YieldEventInfo as Y, type ZoneEventInfo as Z, expandBoundsToMinimumPlayArea as _, type AddAgentInput as a, isSpaceAnchorOccupancyPointAvailable as a0, listAllowedOccupancyPoints as a1, listOccupancyPointsForSpatialZone as a2, mergeSnapshotWithPlayerChainNode as a3, occupancyKeyForPosition as a4, occupancyPointsGroupedBySpatialZone as a5, parsePlayerChainFanoutNotify as a6, parsePlayerChainFanoutNotifyFromSsePayload as a7, parsePlayerChainNodeRpcBody as a8, pointCellInSpatialZone as a9, sortNodeRefsForSerializedFetch as aa, spatialZoneBounds as ab, spatialZoneCenter as ac, type RegisteredPlayer as b, type AddPlayerInput as c, type RecordInteractionInput as d, type AgentPlayWorldMap as e, type AgentPlayWorldMapAgentOccupant as f, type AgentPlayWorldMapBounds as g, type AgentPlayWorldMapMcpOccupant as h, type AssistToolFieldType as i, type AssistToolParameterSpec as j, type AssistToolSpec as k, type DestinationJourneyStep as l, type JourneyStep as m, type OccupancyGridPoint as n, type OriginJourneyStep as o, type P2aEnableFlag as p, PLAYER_CHAIN_GENESIS_STABLE_KEY as q, PLAYER_CHAIN_HEADER_STABLE_KEY as r, type PlatformAgentInformation as s, type PlayAgentInformation as t, type PlayerChainFanoutNotify as u, type PlayerChainGenesisNode as v, type PlayerChainHeaderNode as w, type PlayerChainNotifyNodeRef as x, type PlayerChainOccupantPresentNode as y, type PlayerChainOccupantRemovedNode as z };

package/dist/browser.d.ts

@@ -1 +1 @@
-export { A as AgentPlaySnapshot, M as MINIMUM_PLAY_WORLD_BOUNDS, n as PLAYER_CHAIN_GENESIS_STABLE_KEY, o as PLAYER_CHAIN_HEADER_STABLE_KEY, C as WorldBounds, F as boundsContain, G as clampWorldPosition, H as expandBoundsToMinimumPlayArea, I as mergeSnapshotWithPlayerChainNode, K as parsePlayerChainFanoutNotify, N as parsePlayerChainFanoutNotifyFromSsePayload, Q as parsePlayerChainNodeRpcBody, T as sortNodeRefsForSerializedFetch } from './browser-CvtF5qSC.js';
+export { A as AgentPlaySnapshot, C as CONTINUOUS_RENDER_OFFSET, D as DEFAULT_AGENT_SPAWN_MIN_DISTANCE, M as MINIMUM_PLAY_WORLD_BOUNDS, O as OCCUPANCY_POINT_MULTIPLIER, n as OccupancyGridPoint, q as PLAYER_CHAIN_GENESIS_STABLE_KEY, r as PLAYER_CHAIN_HEADER_STABLE_KEY, S as SPATIAL_ZONE_INDEX_AGENTS, H as SPATIAL_ZONE_INDEX_SPACES, K as WorldBounds, Q as boundingWorldRectForOccupancyPoints, T as boundsContain, U as buildRankedOccupancyPoints, V as buildRankedOccupancyPointsForSpatialZone, X as clampWorldPosition, _ as expandBoundsToMinimumPlayArea, $ as isAgentSpawnOccupancyPointAvailable, a0 as isSpaceAnchorOccupancyPointAvailable, a1 as listAllowedOccupancyPoints, a2 as listOccupancyPointsForSpatialZone, a3 as mergeSnapshotWithPlayerChainNode, a4 as occupancyKeyForPosition, a5 as occupancyPointsGroupedBySpatialZone, a6 as parsePlayerChainFanoutNotify, a7 as parsePlayerChainFanoutNotifyFromSsePayload, a8 as parsePlayerChainNodeRpcBody, a9 as pointCellInSpatialZone, aa as sortNodeRefsForSerializedFetch, ab as spatialZoneBounds, ac as spatialZoneCenter } from './browser-BQR40I8R.js';

package/dist/browser.js

@@ -1,27 +1,61 @@
 import {
+  CONTINUOUS_RENDER_OFFSET,
+  DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
   MINIMUM_PLAY_WORLD_BOUNDS,
+  OCCUPANCY_POINT_MULTIPLIER,
   PLAYER_CHAIN_GENESIS_STABLE_KEY,
   PLAYER_CHAIN_HEADER_STABLE_KEY,
+  SPATIAL_ZONE_INDEX_AGENTS,
+  SPATIAL_ZONE_INDEX_SPACES,
+  boundingWorldRectForOccupancyPoints,
   boundsContain,
+  buildRankedOccupancyPoints,
+  buildRankedOccupancyPointsForSpatialZone,
   clampWorldPosition,
   expandBoundsToMinimumPlayArea,
+  isAgentSpawnOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailable,
+  listAllowedOccupancyPoints,
+  listOccupancyPointsForSpatialZone,
   mergeSnapshotWithPlayerChainNode,
+  occupancyKeyForPosition,
+  occupancyPointsGroupedBySpatialZone,
   parsePlayerChainFanoutNotify,
   parsePlayerChainFanoutNotifyFromSsePayload,
   parsePlayerChainNodeRpcBody,
-  sortNodeRefsForSerializedFetch
-} from "./chunk-U2M7HNYN.js";
+  pointCellInSpatialZone,
+  sortNodeRefsForSerializedFetch,
+  spatialZoneBounds,
+  spatialZoneCenter
+} from "./chunk-WWIEHWZZ.js";
 export {
+  CONTINUOUS_RENDER_OFFSET,
+  DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
   MINIMUM_PLAY_WORLD_BOUNDS,
+  OCCUPANCY_POINT_MULTIPLIER,
   PLAYER_CHAIN_GENESIS_STABLE_KEY,
   PLAYER_CHAIN_HEADER_STABLE_KEY,
+  SPATIAL_ZONE_INDEX_AGENTS,
+  SPATIAL_ZONE_INDEX_SPACES,
+  boundingWorldRectForOccupancyPoints,
   boundsContain,
+  buildRankedOccupancyPoints,
+  buildRankedOccupancyPointsForSpatialZone,
   clampWorldPosition,
   expandBoundsToMinimumPlayArea,
+  isAgentSpawnOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailable,
+  listAllowedOccupancyPoints,
+  listOccupancyPointsForSpatialZone,
   mergeSnapshotWithPlayerChainNode,
+  occupancyKeyForPosition,
+  occupancyPointsGroupedBySpatialZone,
   parsePlayerChainFanoutNotify,
   parsePlayerChainFanoutNotifyFromSsePayload,
   parsePlayerChainNodeRpcBody,
-  sortNodeRefsForSerializedFetch
+  pointCellInSpatialZone,
+  sortNodeRefsForSerializedFetch,
+  spatialZoneBounds,
+  spatialZoneCenter
 };
 //# sourceMappingURL=browser.js.map