@agent-play/sdk 3.3.2 → 3.3.5

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { W as WorldInteractionRole, L as LangChainAgentRegistration, R as RemotePlayWorldInitAudioOptions, A as AgentPlaySnapshot, P as PlayerChainNodeResponse, a as AddAgentInput, b as RegisteredPlayer, c as AddPlayerInput, d as RecordInteractionInput, J as Journey } from './browser-BQR40I8R.js';
-export { e as AgentPlayWorldMap, f as AgentPlayWorldMapAgentOccupant, g as AgentPlayWorldMapBounds, h as AgentPlayWorldMapMcpOccupant, i as AssistToolFieldType, j as AssistToolParameterSpec, k as AssistToolSpec, C as CONTINUOUS_RENDER_OFFSET, D as DEFAULT_AGENT_SPAWN_MIN_DISTANCE, l as DestinationJourneyStep, m as JourneyStep, M as MINIMUM_PLAY_WORLD_BOUNDS, O as OCCUPANCY_POINT_MULTIPLIER, n as OccupancyGridPoint, o as OriginJourneyStep, p as P2aEnableFlag, q as PLAYER_CHAIN_GENESIS_STABLE_KEY, r as PLAYER_CHAIN_HEADER_STABLE_KEY, s as PlatformAgentInformation, t as PlayAgentInformation, u as PlayerChainFanoutNotify, v as PlayerChainGenesisNode, w as PlayerChainHeaderNode, x as PlayerChainNotifyNodeRef, y as PlayerChainOccupantPresentNode, z as PlayerChainOccupantRemovedNode, B as PositionedStep, E as RealtimeWebrtcClientSecret, F as RegisteredAgentSummary, G as RemotePlayWorldOpenAiAudioOptions, S as SPATIAL_ZONE_INDEX_AGENTS, H as SPATIAL_ZONE_INDEX_SPACES, I as StructureJourneyStep, K as WorldBounds, N as WorldJourneyUpdate, Y as YieldEventInfo, Z as ZoneEventInfo, 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';
+import { W as WorldInteractionRole, L as LangChainAgentRegistration, R as RemotePlayWorldInitAudioOptions, A as AgentPlaySnapshot, P as PlayerChainNodeResponse, a as AddAgentInput, b as RegisteredPlayer, c as AddPlayerInput, d as RecordInteractionInput, J as Journey } from './browser-da9E-kSP.js';
+export { e as AgentPlayWorldLayout, f as AgentPlayWorldLayoutZone, g as AgentPlayWorldMap, h as AgentPlayWorldMapAgentOccupant, i as AgentPlayWorldMapBounds, j as AgentPlayWorldMapMcpOccupant, k as AssistToolFieldType, l as AssistToolParameterSpec, m as AssistToolSpec, C as CONTINUOUS_RENDER_OFFSET, n as CarWashCar, o as CarWashCarSchema, p as ComputeTalkAgentPowerUpsEarnedInput, D as DEFAULT_AGENT_SPAWN_MIN_DISTANCE, q as DEFAULT_PLAYER_WALLET_BALANCE_USD, r as DestinationJourneyStep, s as JourneyStep, M as MINIMUM_PLAY_WORLD_BOUNDS, t as MINIMUM_STREET_LAYOUT_BOUNDS, O as OCCUPANCY_POINT_MULTIPLIER, u as OccupancyGridPoint, v as OccupantGroup, w as OriginJourneyStep, x as P2aEnableFlag, y as PLAYER_CHAIN_GENESIS_STABLE_KEY, z as PLAYER_CHAIN_HEADER_STABLE_KEY, B as PlatformAgentInformation, E as PlayAgentInformation, F as PlayerChainFanoutNotify, G as PlayerChainGenesisNode, H as PlayerChainHeaderNode, I as PlayerChainNotifyNodeRef, K as PlayerChainOccupantPresentNode, N as PlayerChainOccupantRemovedNode, Q as PlayerWallet, S as PlayerWalletSchema, T as PositionedStep, U as PurchaseRecord, V as PurchaseRecordSchema, X as RealtimeWebrtcClientSecret, Y as RegisteredAgentSummary, Z as RemotePlayWorldOpenAiAudioOptions, _ as SPACE_STRUCTURE_ANCHOR_MIN_DISTANCE, $ as SPATIAL_ZONE_INDEX_AGENTS, a0 as SPATIAL_ZONE_INDEX_SPACES, a1 as STREET_NAME_POOL, a2 as SaleState, a3 as SaleStateSchema, a4 as ShopItem, a5 as ShopItemSchema, a6 as SpaceContentItem, a7 as Street, a8 as StreetPoolEntry, a9 as StructureJourneyStep, aa as SupermarketItem, ab as SupermarketItemSchema, ac as TALK_AGENT_PU_BILLED_SECONDS_PER_UNIT, ad as TALK_AGENT_PU_MAX_PER_LEG, ae as TALK_PRICE_PER_60S_USD, af as TALK_PRICE_PER_SECOND_USD, ag as TALK_TICK_SECONDS, ah as WALLET_BUNDLE_OFFERS, ai as WalletBundleId, aj as WalletBundleOffer, ak as WorldBounds, al as WorldJourneyUpdate, am as WorldLayout, an as WorldLayoutBoundsField, ao as YieldEventInfo, ap as Zone, aq as ZoneEventInfo, ar as applyBoundsFieldUpdateToLayout, as as availableCellsForZone, at as boundingWorldRectForOccupancyPoints, au as boundsContain, av as buildRankedOccupancyPoints, aw as buildRankedOccupancyPointsForSpatialZone, ax as buildRankedOccupancyPointsForZone, ay as buildRankedOccupancyPointsInRect, az as cellsForZone, aA as centerOfZone, aB as clampWorldPosition, aC as computeTalkAgentPowerUpsEarned, aD as costForSeconds, aE as createInitialAgentRewardWallet, aF as createInitialPlayerWallet, aG as createVerticalStripSeedLayout, aH as desaturateColor, aI as enumerateIntegerCellsInRect, aJ as expandBoundsToMinimumPlayArea, aK as getStreetPoolEntryById, aL as getWalletBundleById, aM as isAgentSpawnOccupancyPointAvailable, aN as isAgentSpawnOccupancyPointAvailableInRect, aO as isAgentSpawnOccupancyPointAvailableInZone, aP as isItemAvailableForPurchase, aQ as isSpaceAnchorOccupancyPointAvailable, aR as isSpaceAnchorOccupancyPointAvailableInRect, aS as isSpaceAnchorOccupancyPointAvailableInZone, aT as listAllowedOccupancyPoints, aU as listOccupancyPointsForSpatialZone, aV as listOccupancyPointsForZone, aW as listOccupancyPointsInRect, aX as mergeSnapshotWithPlayerChainNode, aY as migrateWorldLayoutBounds, aZ as nextStreetFromPool, a_ as occupancyKeyForPosition, a$ as occupancyPointsGroupedBySpatialZone, b0 as occupancyPointsGroupedByZones, b1 as parsePlayerChainFanoutNotify, b2 as parsePlayerChainFanoutNotifyFromSsePayload, b3 as parsePlayerChainNodeRpcBody, b4 as pickZoneForGroup, b5 as pointCellInRect, b6 as pointCellInSpatialZone, b7 as pointCellInZone, b8 as primaryZoneForGroup, b9 as sortNodeRefsForSerializedFetch, ba as spatialZoneBounds, bb as spatialZoneCenter, bc as streetFromPoolEntry, bd as zonesForGroup } from './browser-da9E-kSP.js';
 import { WorldIntercomEventPayload, IntercomResponsePayload } from '@agent-play/intercom';
 export { AgentPlayAgentNodeEntry, AgentPlayCredentialsFile, NodeCredentialMaterial, createNodeCredentialMaterial, loadAgentPlayCredentialsFileFromPath, loadAgentPlayCredentialsFileFromPathSync, loadRootKey, nodeCredentialFromHumanPhrase, nodeCredentialFromPasswHash, nodeCredentialsMaterialFromHumanPassphrase, parseAgentPlayCredentialsJson, resolveAgentPlayCredentialsPath, verifyStoredNodeCredential } from '@agent-play/node-tools';
+import 'zod';
 
 /**
  * String constants and payload shapes for SSE and in-process world events.

package/dist/index.js

@@ -1,25 +1,66 @@
 import {
   CONTINUOUS_RENDER_OFFSET,
+  CarWashCarSchema,
   DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
+  DEFAULT_PLAYER_WALLET_BALANCE_USD,
   MINIMUM_PLAY_WORLD_BOUNDS,
+  MINIMUM_STREET_LAYOUT_BOUNDS,
   OCCUPANCY_POINT_MULTIPLIER,
   PLAYER_CHAIN_GENESIS_STABLE_KEY,
   PLAYER_CHAIN_HEADER_STABLE_KEY,
+  PlayerWalletSchema,
+  PurchaseRecordSchema,
+  SPACE_STRUCTURE_ANCHOR_MIN_DISTANCE,
   SPATIAL_ZONE_INDEX_AGENTS,
   SPATIAL_ZONE_INDEX_SPACES,
+  STREET_NAME_POOL,
+  SaleStateSchema,
+  ShopItemSchema,
+  SupermarketItemSchema,
+  TALK_AGENT_PU_BILLED_SECONDS_PER_UNIT,
+  TALK_AGENT_PU_MAX_PER_LEG,
+  TALK_PRICE_PER_60S_USD,
+  TALK_PRICE_PER_SECOND_USD,
+  TALK_TICK_SECONDS,
+  WALLET_BUNDLE_OFFERS,
+  applyBoundsFieldUpdateToLayout,
+  availableCellsForZone,
   boundingWorldRectForOccupancyPoints,
   boundsContain,
   buildRankedOccupancyPoints,
   buildRankedOccupancyPointsForSpatialZone,
+  buildRankedOccupancyPointsForZone,
+  buildRankedOccupancyPointsInRect,
+  cellsForZone,
+  centerOfZone,
   clampWorldPosition,
+  computeTalkAgentPowerUpsEarned,
+  costForSeconds,
+  createInitialAgentRewardWallet,
+  createInitialPlayerWallet,
+  createVerticalStripSeedLayout,
+  desaturateColor,
+  enumerateIntegerCellsInRect,
   expandBoundsToMinimumPlayArea,
+  getStreetPoolEntryById,
+  getWalletBundleById,
   isAgentSpawnOccupancyPointAvailable,
+  isAgentSpawnOccupancyPointAvailableInRect,
+  isAgentSpawnOccupancyPointAvailableInZone,
+  isItemAvailableForPurchase,
   isSpaceAnchorOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailableInRect,
+  isSpaceAnchorOccupancyPointAvailableInZone,
   listAllowedOccupancyPoints,
   listOccupancyPointsForSpatialZone,
+  listOccupancyPointsForZone,
+  listOccupancyPointsInRect,
   mergeSnapshotWithPlayerChainNode,
+  migrateWorldLayoutBounds,
+  nextStreetFromPool,
   occupancyKeyForPosition,
   occupancyPointsGroupedBySpatialZone,
+  occupancyPointsGroupedByZones,
   parseAgentOccupantRow,
   parseHumanOccupantRow,
   parseMcpOccupantRow,
@@ -28,11 +69,17 @@ import {
   parsePlayerChainNodeRpcBody,
   parseSpaceCatalogEntry,
   parseStructureOccupantRow,
+  pickZoneForGroup,
+  pointCellInRect,
   pointCellInSpatialZone,
+  pointCellInZone,
+  primaryZoneForGroup,
   sortNodeRefsForSerializedFetch,
   spatialZoneBounds,
-  spatialZoneCenter
-} from "./chunk-WWIEHWZZ.js";
+  spatialZoneCenter,
+  streetFromPoolEntry,
+  zonesForGroup
+} from "./chunk-BCDEUIYP.js";
 
 // src/world-events.ts
 var SESSION_CONNECTED_EVENT = "session:connected";
@@ -281,6 +328,10 @@ function resolveRealtimeInstructions(options) {
   if (explicit !== void 0 && explicit.length > 0) {
     return explicit;
   }
+  const perAgent = options.perAgentInstructions?.trim();
+  if (perAgent !== void 0 && perAgent.length > 0) {
+    return perAgent;
+  }
   const template = options.openai.instructionsTemplate?.trim();
   if (template !== void 0 && template.length > 0) {
     return template.replaceAll("{{agentName}}", options.agentName);
@@ -414,6 +465,12 @@ function parseAgentPlaySnapshot(snapshot) {
   }
   const worldMap = parseWorldMap(snapshot.worldMap);
   const out = { sid: snapshot.sid, worldMap };
+  if ("worldLayout" in snapshot && isRecord(snapshot.worldLayout)) {
+    const wl = snapshot.worldLayout;
+    if (typeof wl.rev === "number" && isRecord(wl.bounds) && Array.isArray(wl.zones) && Array.isArray(wl.streets)) {
+      out.worldLayout = wl;
+    }
+  }
   if ("mcpServers" in snapshot && Array.isArray(snapshot.mcpServers)) {
     const servers = [];
     for (const m of snapshot.mcpServers) {
@@ -922,25 +979,23 @@ var RemotePlayWorld = class {
     const connectionId = randomUUID();
     const leaseTtlSeconds = 45;
     let realtimeWebrtcFromInit;
-    let realtimeInstructionsFromInit;
+    let resolvedRealtimeInstructions;
     if (input.enableP2a === "on" && this.audioInitOptions !== null) {
-      console.log("resolving realtime instructions for agent", input.name);
-      realtimeInstructionsFromInit = resolveRealtimeInstructions({
-        openai: this.audioInitOptions,
-        agentName: input.name
-      });
-      realtimeWebrtcFromInit = await mintOpenAiRealtimeClientSecretForSdk({
+      const resolveOpts = {
         openai: this.audioInitOptions,
-        agentName: input.name
-      });
+        agentName: input.name,
+        perAgentInstructions: input.realtimeInstructions ?? ""
+      };
+      resolvedRealtimeInstructions = resolveRealtimeInstructions(resolveOpts);
+      realtimeWebrtcFromInit = await mintOpenAiRealtimeClientSecretForSdk(resolveOpts);
       this.logTransport("addAgent:p2a_enabled", {
         agentName: input.name,
         model: this.audioInitOptions.model,
         voice: this.audioInitOptions.voice
       });
     }
-    console.log("realtimeWebrtcFromInit", realtimeWebrtcFromInit);
-    console.log("realtimeInstructionsFromInit", realtimeInstructionsFromInit);
+    const callerRealtimeInstructions = typeof input.realtimeInstructions === "string" && input.realtimeInstructions.trim().length > 0 ? input.realtimeInstructions : void 0;
+    const forwardedRealtimeInstructions = resolvedRealtimeInstructions ?? callerRealtimeInstructions;
     const requestPayload = {
       name: input.name,
       type: input.type,
@@ -952,7 +1007,7 @@ var RemotePlayWorld = class {
       leaseTtlSeconds,
       ...input.enableP2a !== void 0 ? { enableP2a: input.enableP2a } : {},
       ...realtimeWebrtcFromInit !== void 0 ? { realtimeWebrtc: realtimeWebrtcFromInit } : {},
-      ...realtimeInstructionsFromInit !== void 0 ? { realtimeInstructions: realtimeInstructionsFromInit } : {}
+      ...forwardedRealtimeInstructions !== void 0 ? { realtimeInstructions: forwardedRealtimeInstructions } : {}
     };
     this.logTransport("addAgent:request_payload", {
       url,
@@ -1054,6 +1109,9 @@ var RemotePlayWorld = class {
     if (input.mainNodeId !== void 0) {
       payload.mainNodeId = input.mainNodeId;
     }
+    if (input.realtimeInstructions !== void 0) {
+      payload.realtimeInstructions = input.realtimeInstructions;
+    }
     return this.addAgent(payload);
   }
   async recordInteraction(input) {
@@ -1421,58 +1479,105 @@ import {
 } from "@agent-play/node-tools";
 export {
   CONTINUOUS_RENDER_OFFSET,
+  CarWashCarSchema,
   DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
+  DEFAULT_PLAYER_WALLET_BALANCE_USD,
   MINIMUM_PLAY_WORLD_BOUNDS,
+  MINIMUM_STREET_LAYOUT_BOUNDS,
   OCCUPANCY_POINT_MULTIPLIER,
   PLAYER_ADDED_EVENT,
   PLAYER_CHAIN_GENESIS_STABLE_KEY,
   PLAYER_CHAIN_HEADER_STABLE_KEY,
+  PlayerWalletSchema,
+  PurchaseRecordSchema,
   RemotePlayWorld,
   SESSION_CLOSED_EVENT,
   SESSION_CONNECTED_EVENT,
   SESSION_INVALID_EVENT,
   SESSION_SSE_ERROR_EVENT,
   SESSION_SSE_OPEN_EVENT,
+  SPACE_STRUCTURE_ANCHOR_MIN_DISTANCE,
   SPATIAL_ZONE_INDEX_AGENTS,
   SPATIAL_ZONE_INDEX_SPACES,
+  STREET_NAME_POOL,
+  SaleStateSchema,
+  ShopItemSchema,
+  SupermarketItemSchema,
+  TALK_AGENT_PU_BILLED_SECONDS_PER_UNIT,
+  TALK_AGENT_PU_MAX_PER_LEG,
+  TALK_PRICE_PER_60S_USD,
+  TALK_PRICE_PER_SECOND_USD,
+  TALK_TICK_SECONDS,
+  WALLET_BUNDLE_OFFERS,
   WORLD_AGENT_SIGNAL_EVENT,
   WORLD_INTERACTION_EVENT,
   WORLD_JOURNEY_EVENT,
   agentPlayDebug,
+  applyBoundsFieldUpdateToLayout,
+  availableCellsForZone,
   boundingWorldRectForOccupancyPoints,
   boundsContain,
   buildRankedOccupancyPoints,
   buildRankedOccupancyPointsForSpatialZone,
+  buildRankedOccupancyPointsForZone,
+  buildRankedOccupancyPointsInRect,
+  cellsForZone,
+  centerOfZone,
   clampWorldPosition,
+  computeTalkAgentPowerUpsEarned,
   configureAgentPlayDebug,
+  costForSeconds,
+  createInitialAgentRewardWallet,
+  createInitialPlayerWallet,
   createNodeCredentialMaterial,
+  createVerticalStripSeedLayout,
+  desaturateColor,
+  enumerateIntegerCellsInRect,
   expandBoundsToMinimumPlayArea,
+  getStreetPoolEntryById,
+  getWalletBundleById,
   intercomResultRecordFromLangChainInvokeOutput,
   isAgentPlayDebugEnabled,
   isAgentSpawnOccupancyPointAvailable,
+  isAgentSpawnOccupancyPointAvailableInRect,
+  isAgentSpawnOccupancyPointAvailableInZone,
+  isItemAvailableForPurchase,
   isSpaceAnchorOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailableInRect,
+  isSpaceAnchorOccupancyPointAvailableInZone,
   langchainRegistration,
   listAllowedOccupancyPoints,
   listOccupancyPointsForSpatialZone,
+  listOccupancyPointsForZone,
+  listOccupancyPointsInRect,
   loadAgentPlayCredentialsFileFromPath,
   loadAgentPlayCredentialsFileFromPathSync2 as loadAgentPlayCredentialsFileFromPathSync,
   loadRootKey2 as loadRootKey,
   mergeSnapshotWithPlayerChainNode,
+  migrateWorldLayoutBounds,
+  nextStreetFromPool,
   nodeCredentialFromHumanPhrase2 as nodeCredentialFromHumanPhrase,
   nodeCredentialFromPasswHash,
   nodeCredentialsMaterialFromHumanPassphrase,
   occupancyKeyForPosition,
   occupancyPointsGroupedBySpatialZone,
+  occupancyPointsGroupedByZones,
   parseAgentPlayCredentialsJson,
   parsePlayerChainFanoutNotify,
   parsePlayerChainFanoutNotifyFromSsePayload,
   parsePlayerChainNodeRpcBody,
+  pickZoneForGroup,
+  pointCellInRect,
   pointCellInSpatialZone,
+  pointCellInZone,
+  primaryZoneForGroup,
   resetAgentPlayDebug,
   resolveAgentPlayCredentialsPath2 as resolveAgentPlayCredentialsPath,
   sortNodeRefsForSerializedFetch,
   spatialZoneBounds,
   spatialZoneCenter,
-  verifyStoredNodeCredential
+  streetFromPoolEntry,
+  verifyStoredNodeCredential,
+  zonesForGroup
 };
 //# sourceMappingURL=index.js.map