@agent-play/sdk 3.2.2 → 3.3.3

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-CD0Fu-zr.js';
-export { e as AgentPlayWorldMap, f as AgentPlayWorldMapAgentOccupant, g as AgentPlayWorldMapBounds, h as AgentPlayWorldMapMcpOccupant, i as AssistToolFieldType, j as AssistToolParameterSpec, k as AssistToolSpec, D as DestinationJourneyStep, l as JourneyStep, M as MINIMUM_PLAY_WORLD_BOUNDS, O as OriginJourneyStep, m as P2aEnableFlag, n as PLAYER_CHAIN_GENESIS_STABLE_KEY, o as PLAYER_CHAIN_HEADER_STABLE_KEY, p as PlatformAgentInformation, q as PlayAgentInformation, r as PlayerChainFanoutNotify, s as PlayerChainGenesisNode, t as PlayerChainHeaderNode, u as PlayerChainNotifyNodeRef, v as PlayerChainOccupantPresentNode, w as PlayerChainOccupantRemovedNode, x as PositionedStep, y as RealtimeWebrtcClientSecret, z as RegisteredAgentSummary, B as RemotePlayWorldOpenAiAudioOptions, S as StructureJourneyStep, C as WorldBounds, E as WorldJourneyUpdate, Y as YieldEventInfo, Z as ZoneEventInfo, 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-CD0Fu-zr.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-Dpx-0L8A.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, D as DEFAULT_AGENT_SPAWN_MIN_DISTANCE, p as DEFAULT_PLAYER_WALLET_BALANCE_USD, q as DestinationJourneyStep, r as JourneyStep, M as MINIMUM_PLAY_WORLD_BOUNDS, O as OCCUPANCY_POINT_MULTIPLIER, s as OccupancyGridPoint, t as OccupantGroup, u as OriginJourneyStep, v as P2aEnableFlag, w as PLAYER_CHAIN_GENESIS_STABLE_KEY, x as PLAYER_CHAIN_HEADER_STABLE_KEY, y as PlatformAgentInformation, z as PlayAgentInformation, B as PlayerChainFanoutNotify, E as PlayerChainGenesisNode, F as PlayerChainHeaderNode, G as PlayerChainNotifyNodeRef, H as PlayerChainOccupantPresentNode, I as PlayerChainOccupantRemovedNode, K as PlayerWallet, N as PlayerWalletSchema, Q as PositionedStep, S as PurchaseRecord, T as PurchaseRecordSchema, U as RealtimeWebrtcClientSecret, V as RegisteredAgentSummary, X as RemotePlayWorldOpenAiAudioOptions, Y as SPATIAL_ZONE_INDEX_AGENTS, Z as SPATIAL_ZONE_INDEX_SPACES, _ as STREET_NAME_POOL, $ as SaleState, a0 as SaleStateSchema, a1 as ShopItem, a2 as ShopItemSchema, a3 as SpaceContentItem, a4 as Street, a5 as StreetPoolEntry, a6 as StructureJourneyStep, a7 as SupermarketItem, a8 as SupermarketItemSchema, a9 as WorldBounds, aa as WorldJourneyUpdate, ab as WorldLayout, ac as WorldLayoutBoundsField, ad as YieldEventInfo, ae as Zone, af as ZoneEventInfo, ag as applyBoundsFieldUpdateToLayout, ah as availableCellsForZone, ai as boundingWorldRectForOccupancyPoints, aj as boundsContain, ak as buildRankedOccupancyPoints, al as buildRankedOccupancyPointsForSpatialZone, am as buildRankedOccupancyPointsForZone, an as buildRankedOccupancyPointsInRect, ao as cellsForZone, ap as centerOfZone, aq as clampWorldPosition, ar as createInitialPlayerWallet, as as createVerticalStripSeedLayout, at as desaturateColor, au as enumerateIntegerCellsInRect, av as expandBoundsToMinimumPlayArea, aw as getStreetPoolEntryById, ax as isAgentSpawnOccupancyPointAvailable, ay as isAgentSpawnOccupancyPointAvailableInRect, az as isAgentSpawnOccupancyPointAvailableInZone, aA as isItemAvailableForPurchase, aB as isSpaceAnchorOccupancyPointAvailable, aC as isSpaceAnchorOccupancyPointAvailableInRect, aD as isSpaceAnchorOccupancyPointAvailableInZone, aE as listAllowedOccupancyPoints, aF as listOccupancyPointsForSpatialZone, aG as listOccupancyPointsForZone, aH as listOccupancyPointsInRect, aI as mergeSnapshotWithPlayerChainNode, aJ as migrateWorldLayoutBounds, aK as nextStreetFromPool, aL as occupancyKeyForPosition, aM as occupancyPointsGroupedBySpatialZone, aN as occupancyPointsGroupedByZones, aO as parsePlayerChainFanoutNotify, aP as parsePlayerChainFanoutNotifyFromSsePayload, aQ as parsePlayerChainNodeRpcBody, aR as pickZoneForGroup, aS as pointCellInRect, aT as pointCellInSpatialZone, aU as pointCellInZone, aV as primaryZoneForGroup, aW as sortNodeRefsForSerializedFetch, aX as spatialZoneBounds, aY as spatialZoneCenter, aZ as streetFromPoolEntry, a_ as zonesForGroup } from './browser-Dpx-0L8A.js';
 import { WorldIntercomEventPayload, IntercomResponsePayload } from '@agent-play/intercom';
-export { AgentPlayAgentNodeEntry, AgentPlayCredentialsFile, loadAgentPlayCredentialsFileFromPath, loadAgentPlayCredentialsFileFromPathSync, loadRootKey, nodeCredentialsMaterialFromHumanPassphrase, parseAgentPlayCredentialsJson, resolveAgentPlayCredentialsPath } from '@agent-play/node-tools';
+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.
@@ -111,8 +112,9 @@ declare function langchainRegistration(agent: unknown): LangChainAgentRegistrati
 
 /**
  * Root key (from `.root`) plus **human** passphrase as stored in **`~/.agent-play/credentials.json`**
- * after **`agent-play create-main-node`**. Material for node id and wire auth is
- * **`nodeCredentialsMaterialFromHumanPassphrase(passw)`** (SHA-256 hex; same as CLI **`hashNodePassword`**).
+ * after **`agent-play create-main-node`**. The SDK hashes the phrase once locally via
+ * **`nodeCredentialFromHumanPhrase`** and sends the resulting **`passwHash`** as the
+ * `x-node-passw` header and as the `passwHash` field in repository-backed requests.
  */
 type RemotePlayWorldNodeCredentials = {
     rootKey: string;
@@ -135,8 +137,8 @@ type RemotePlayWorldOptions = {
 /** Options for {@link RemotePlayWorld.connect}. */
 type RemotePlayWorldConnectOptions = {
     /**
-     * Parent **main** node id. When set, `connect` runs `POST /api/nodes/validate` first, then `GET /api/agent-play/session`.
-     * When omitted, only `GET /api/agent-play/session` runs.
+     * Main node id used for `POST /api/nodes/validate` as **`nodeId`** (not the derived credential id) and remembered for {@link RemotePlayWorld.addAgent} (`mainNodeId` on validate and register).
+     * When omitted, connect skips validate and addAgent uses the derived node id for main-parent fields.
      */
     mainNodeId?: string;
 };
@@ -180,11 +182,12 @@ declare class RemotePlayWorld {
     private readonly rootKey;
     /** Node id derived from hashed passphrase material + root (main or agent node id). */
     private readonly derivedNodeId;
-    /** Hex password material (`hashNodePassword` on normalized human phrase); sent as `password` for repository addAgent. */
-    private readonly password;
+    /** Hex SHA-256 of the normalized human phrase; sent as `x-node-passw` and as `passwHash`. */
+    private readonly passwHash;
     private readonly onSessionEvent;
     private readonly transportLog;
     private sid;
+    private configuredMainNodeId;
     private closed;
     private readonly closeListeners;
     private readonly playerConnectionInfo;
@@ -201,7 +204,7 @@ declare class RemotePlayWorld {
     private validateNodeIdentity;
     /**
      * Establishes the HTTP session via `GET /api/agent-play/session`. With {@link RemotePlayWorldConnectOptions.mainNodeId},
-     * validates node identity with `POST /api/nodes/validate` first.
+     * validates that node with `POST /api/nodes/validate` using **`nodeId: mainNodeId`** first.
      */
     connect(options?: RemotePlayWorldConnectOptions): Promise<void>;
     close(): Promise<void>;
@@ -232,6 +235,8 @@ declare class RemotePlayWorld {
     /**
      * Registers an automation agent using **agent node id** (`nodeId`), sent to the server as `agentId`.
      *
+     * Runs `POST /api/nodes/validate` with **`nodeId`** / **`mainNodeId`** from {@link AddAgentInput} before registering.
+     *
      * If {@link initAudio} was called and **`enableP2a`** is **`"on"`**, this call mints a per-agent
      * OpenAI Realtime client secret and forwards it as `realtimeWebrtc`.
      */

package/dist/index.js

@@ -1,19 +1,73 @@
 import {
+  CONTINUOUS_RENDER_OFFSET,
+  CarWashCarSchema,
+  DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
+  DEFAULT_PLAYER_WALLET_BALANCE_USD,
   MINIMUM_PLAY_WORLD_BOUNDS,
+  OCCUPANCY_POINT_MULTIPLIER,
   PLAYER_CHAIN_GENESIS_STABLE_KEY,
   PLAYER_CHAIN_HEADER_STABLE_KEY,
+  PlayerWalletSchema,
+  PurchaseRecordSchema,
+  SPATIAL_ZONE_INDEX_AGENTS,
+  SPATIAL_ZONE_INDEX_SPACES,
+  STREET_NAME_POOL,
+  SaleStateSchema,
+  ShopItemSchema,
+  SupermarketItemSchema,
+  applyBoundsFieldUpdateToLayout,
+  availableCellsForZone,
+  boundingWorldRectForOccupancyPoints,
   boundsContain,
+  buildRankedOccupancyPoints,
+  buildRankedOccupancyPointsForSpatialZone,
+  buildRankedOccupancyPointsForZone,
+  buildRankedOccupancyPointsInRect,
+  cellsForZone,
+  centerOfZone,
   clampWorldPosition,
+  createInitialPlayerWallet,
+  createVerticalStripSeedLayout,
+  desaturateColor,
+  enumerateIntegerCellsInRect,
   expandBoundsToMinimumPlayArea,
+  getStreetPoolEntryById,
+  isAgentSpawnOccupancyPointAvailable,
+  isAgentSpawnOccupancyPointAvailableInRect,
+  isAgentSpawnOccupancyPointAvailableInZone,
+  isItemAvailableForPurchase,
+  isSpaceAnchorOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailableInRect,
+  isSpaceAnchorOccupancyPointAvailableInZone,
+  listAllowedOccupancyPoints,
+  listOccupancyPointsForSpatialZone,
+  listOccupancyPointsForZone,
+  listOccupancyPointsInRect,
   mergeSnapshotWithPlayerChainNode,
+  migrateWorldLayoutBounds,
+  nextStreetFromPool,
+  occupancyKeyForPosition,
+  occupancyPointsGroupedBySpatialZone,
+  occupancyPointsGroupedByZones,
   parseAgentOccupantRow,
   parseHumanOccupantRow,
   parseMcpOccupantRow,
   parsePlayerChainFanoutNotify,
   parsePlayerChainFanoutNotifyFromSsePayload,
   parsePlayerChainNodeRpcBody,
-  sortNodeRefsForSerializedFetch
-} from "./chunk-U2M7HNYN.js";
+  parseSpaceCatalogEntry,
+  parseStructureOccupantRow,
+  pickZoneForGroup,
+  pointCellInRect,
+  pointCellInSpatialZone,
+  pointCellInZone,
+  primaryZoneForGroup,
+  sortNodeRefsForSerializedFetch,
+  spatialZoneBounds,
+  spatialZoneCenter,
+  streetFromPoolEntry,
+  zonesForGroup
+} from "./chunk-VWC7EE2F.js";
 
 // src/world-events.ts
 var SESSION_CONNECTED_EVENT = "session:connected";
@@ -90,17 +144,20 @@ function unwrapZodCell(cell) {
     if (current === null || typeof current !== "object") {
       return current;
     }
-    const def = current._def;
-    if (!def || typeof def.typeName !== "string") {
+    const def = current._def ?? current.def;
+    if (!def) {
       return current;
     }
-    const { typeName } = def;
-    if (typeName === "ZodOptional" || typeName === "ZodNullable" || typeName === "ZodDefault") {
+    const typeName = typeof def.typeName === "string" ? def.typeName : typeof def.type === "string" ? def.type : void 0;
+    if (typeName === void 0) {
+      return current;
+    }
+    if (typeName === "ZodOptional" || typeName === "ZodNullable" || typeName === "ZodDefault" || typeName === "optional" || typeName === "nullable" || typeName === "default") {
       const inner = def.innerType;
       current = inner !== null && typeof inner === "object" ? inner : void 0;
       continue;
     }
-    if (typeName === "ZodEffects") {
+    if (typeName === "ZodEffects" || typeName === "effects") {
       current = def.schema;
       continue;
     }
@@ -113,14 +170,18 @@ function fieldTypeFromZodCell(cell) {
   if (base === null || typeof base !== "object") {
     return "string";
   }
-  const typeName = base._def?.typeName;
-  if (typeName === "ZodNumber") {
+  const def = base._def ?? base.def;
+  const typeName = def?.typeName;
+  const fallbackType = def?.type;
+  const ctorName = base.constructor?.name ?? "";
+  const kind = typeName ?? fallbackType ?? ctorName;
+  if (kind === "ZodNumber" || kind === "number") {
     return "number";
   }
-  if (typeName === "ZodBoolean") {
+  if (kind === "ZodBoolean" || kind === "boolean") {
     return "boolean";
   }
-  if (typeName === "ZodString") {
+  if (kind === "ZodString" || kind === "string") {
     return "string";
   }
   return "string";
@@ -130,10 +191,11 @@ function parametersFromSchema(schema) {
     return {};
   }
   const z = schema;
-  if (typeof z._def?.shape !== "function") {
+  const shapeRaw = z._def?.shape;
+  const shape = typeof shapeRaw === "function" ? shapeRaw() : shapeRaw !== void 0 && typeof shapeRaw === "object" ? shapeRaw : null;
+  if (shape === null) {
     return { _note: "Pass a Zod object schema on each tool for parameter hints in the watch UI." };
   }
-  const shape = z._def.shape();
   const out = {};
   for (const key of Object.keys(shape)) {
     out[key] = {
@@ -188,10 +250,9 @@ function langchainRegistration(agent) {
 // src/lib/remote-play-world.ts
 import { randomUUID } from "crypto";
 import {
-  deriveNodeIdFromPassword,
   loadAgentPlayCredentialsFileFromPathSync,
   loadRootKey,
-  nodeCredentialsMaterialFromHumanPassphrase,
+  nodeCredentialFromHumanPhrase,
   resolveAgentPlayCredentialsPath
 } from "@agent-play/node-tools";
 import { HumanMessage } from "@langchain/core/messages";
@@ -255,6 +316,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);
@@ -357,9 +422,9 @@ function parseWorldMap(raw) {
   const occupants = [];
   const coordKeys = /* @__PURE__ */ new Set();
   for (const row of occ) {
-    if (!isRecord(row) || row.kind !== "human" && row.kind !== "agent" && row.kind !== "mcp") {
+    if (!isRecord(row) || row.kind !== "human" && row.kind !== "agent" && row.kind !== "mcp" && row.kind !== "structure") {
       throw new Error(
-        "getWorldSnapshot: each occupant must have kind human, agent, or mcp"
+        "getWorldSnapshot: each occupant must have kind human, agent, mcp, or structure"
       );
     }
     const xy = typeof row.x === "number" && typeof row.y === "number" ? `${row.x},${row.y}` : "";
@@ -374,8 +439,10 @@ function parseWorldMap(raw) {
       occupants.push(parseHumanOccupantRow(row));
     } else if (row.kind === "agent") {
       occupants.push(parseAgentOccupantRow(row));
-    } else {
+    } else if (row.kind === "mcp") {
       occupants.push(parseMcpOccupantRow(row));
+    } else {
+      occupants.push(parseStructureOccupantRow(row));
     }
   }
   return { bounds, occupants };
@@ -386,6 +453,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) {
@@ -401,6 +474,18 @@ function parseAgentPlaySnapshot(snapshot) {
     }
     if (servers.length > 0) out.mcpServers = servers;
   }
+  if ("spaces" in snapshot && Array.isArray(snapshot.spaces)) {
+    const catalog = [];
+    for (const row of snapshot.spaces) {
+      if (!isRecord(row)) {
+        continue;
+      }
+      catalog.push(parseSpaceCatalogEntry(row));
+    }
+    if (catalog.length > 0) {
+      out.spaces = catalog.sort((a, b) => a.id.localeCompare(b.id));
+    }
+  }
   return out;
 }
 function parseRegisteredAgentSummary(raw) {
@@ -510,11 +595,12 @@ var RemotePlayWorld = class {
   rootKey;
   /** Node id derived from hashed passphrase material + root (main or agent node id). */
   derivedNodeId;
-  /** Hex password material (`hashNodePassword` on normalized human phrase); sent as `password` for repository addAgent. */
-  password;
+  /** Hex SHA-256 of the normalized human phrase; sent as `x-node-passw` and as `passwHash`. */
+  passwHash;
   onSessionEvent;
   transportLog;
   sid = null;
+  configuredMainNodeId = null;
   closed = false;
   closeListeners = /* @__PURE__ */ new Set();
   playerConnectionInfo = /* @__PURE__ */ new Map();
@@ -533,12 +619,12 @@ var RemotePlayWorld = class {
     const nc = options.nodeCredentials ?? (creds === null ? void 0 : { rootKey: loadRootKey(), passw: creds.passw });
     if (nc !== void 0 && typeof nc.rootKey === "string" && nc.rootKey.trim().length > 0 && typeof nc.passw === "string" && nc.passw.length > 0) {
       this.rootKey = nc.rootKey.trim().toLowerCase();
-      const material = nodeCredentialsMaterialFromHumanPassphrase(nc.passw);
-      this.password = material;
-      this.derivedNodeId = deriveNodeIdFromPassword({
-        password: material,
+      const credential = nodeCredentialFromHumanPhrase({
+        phrase: nc.passw,
         rootKey: this.rootKey
       });
+      this.passwHash = credential.passwHash;
+      this.derivedNodeId = credential.nodeId;
       return;
     }
     throw new Error(formatMissingCredentialsError());
@@ -581,7 +667,7 @@ var RemotePlayWorld = class {
   authHeaders() {
     return {
       "x-node-id": this.derivedNodeId,
-      "x-node-passw": this.password
+      "x-node-passw": this.passwHash
     };
   }
   jsonHeaders() {
@@ -630,18 +716,21 @@ var RemotePlayWorld = class {
   }
   /**
    * Establishes the HTTP session via `GET /api/agent-play/session`. With {@link RemotePlayWorldConnectOptions.mainNodeId},
-   * validates node identity with `POST /api/nodes/validate` first.
+   * validates that node with `POST /api/nodes/validate` using **`nodeId: mainNodeId`** first.
    */
   async connect(options) {
     const mainNodeIdOpt = options?.mainNodeId?.trim();
     if (mainNodeIdOpt !== void 0 && mainNodeIdOpt.length > 0) {
+      this.configuredMainNodeId = mainNodeIdOpt;
       const validation = await this.validateNodeIdentity({
-        nodeId: this.derivedNodeId,
-        mainNodeId: mainNodeIdOpt
+        nodeId: mainNodeIdOpt,
+        mainNodeId: void 0
       });
       console.info(
         `[agent-play] Node identity validated (${validation.nodeKind ?? "unknown"}).`
       );
+    } else {
+      this.configuredMainNodeId = null;
     }
     const res = await fetch(`${this.apiBase}/api/agent-play/session`, {
       headers: this.authHeaders()
@@ -854,15 +943,16 @@ var RemotePlayWorld = class {
   /**
    * Registers an automation agent using **agent node id** (`nodeId`), sent to the server as `agentId`.
    *
+   * Runs `POST /api/nodes/validate` with **`nodeId`** / **`mainNodeId`** from {@link AddAgentInput} before registering.
+   *
    * If {@link initAudio} was called and **`enableP2a`** is **`"on"`**, this call mints a per-agent
    * OpenAI Realtime client secret and forwards it as `realtimeWebrtc`.
    */
   async addAgent(input) {
     const sid = this.getSessionId();
-    const effectiveMainNodeId = this.derivedNodeId;
     const validation = await this.validateNodeIdentity({
       nodeId: input.nodeId,
-      mainNodeId: effectiveMainNodeId
+      mainNodeId: input.mainNodeId
     });
     console.info(
       [
@@ -870,44 +960,42 @@ var RemotePlayWorld = class {
         `  status   : validated`,
         `  nodeId   : ${input.nodeId}`,
         `  nodeKind : ${validation.nodeKind ?? "unknown"}`,
-        `  mainNode : ${effectiveMainNodeId}`
+        `  mainNode : ${input.mainNodeId ?? "n/a"}`
       ].join("\n")
     );
     const url = `${this.apiBase}/api/agent-play/players?sid=${encodeURIComponent(sid)}`;
     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({
+      const resolveOpts = {
         openai: this.audioInitOptions,
-        agentName: input.name
-      });
-      realtimeWebrtcFromInit = await mintOpenAiRealtimeClientSecretForSdk({
-        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,
       agent: input.agent,
-      mainNodeId: effectiveMainNodeId,
-      password: this.password,
+      mainNodeId: input.mainNodeId,
+      passwHash: this.passwHash,
       agentId: input.nodeId,
       connectionId,
       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,
@@ -1009,6 +1097,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) {
@@ -1363,46 +1454,106 @@ var RemotePlayWorld = class {
 
 // src/index.ts
 import {
+  createNodeCredentialMaterial,
   loadAgentPlayCredentialsFileFromPath,
   loadAgentPlayCredentialsFileFromPathSync as loadAgentPlayCredentialsFileFromPathSync2,
   loadRootKey as loadRootKey2,
-  nodeCredentialsMaterialFromHumanPassphrase as nodeCredentialsMaterialFromHumanPassphrase2,
+  nodeCredentialFromHumanPhrase as nodeCredentialFromHumanPhrase2,
+  nodeCredentialFromPasswHash,
+  nodeCredentialsMaterialFromHumanPassphrase,
   parseAgentPlayCredentialsJson,
-  resolveAgentPlayCredentialsPath as resolveAgentPlayCredentialsPath2
+  resolveAgentPlayCredentialsPath as resolveAgentPlayCredentialsPath2,
+  verifyStoredNodeCredential
 } from "@agent-play/node-tools";
 export {
+  CONTINUOUS_RENDER_OFFSET,
+  CarWashCarSchema,
+  DEFAULT_AGENT_SPAWN_MIN_DISTANCE,
+  DEFAULT_PLAYER_WALLET_BALANCE_USD,
   MINIMUM_PLAY_WORLD_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,
+  SPATIAL_ZONE_INDEX_AGENTS,
+  SPATIAL_ZONE_INDEX_SPACES,
+  STREET_NAME_POOL,
+  SaleStateSchema,
+  ShopItemSchema,
+  SupermarketItemSchema,
   WORLD_AGENT_SIGNAL_EVENT,
   WORLD_INTERACTION_EVENT,
   WORLD_JOURNEY_EVENT,
   agentPlayDebug,
+  applyBoundsFieldUpdateToLayout,
+  availableCellsForZone,
+  boundingWorldRectForOccupancyPoints,
   boundsContain,
+  buildRankedOccupancyPoints,
+  buildRankedOccupancyPointsForSpatialZone,
+  buildRankedOccupancyPointsForZone,
+  buildRankedOccupancyPointsInRect,
+  cellsForZone,
+  centerOfZone,
   clampWorldPosition,
   configureAgentPlayDebug,
+  createInitialPlayerWallet,
+  createNodeCredentialMaterial,
+  createVerticalStripSeedLayout,
+  desaturateColor,
+  enumerateIntegerCellsInRect,
   expandBoundsToMinimumPlayArea,
+  getStreetPoolEntryById,
   intercomResultRecordFromLangChainInvokeOutput,
   isAgentPlayDebugEnabled,
+  isAgentSpawnOccupancyPointAvailable,
+  isAgentSpawnOccupancyPointAvailableInRect,
+  isAgentSpawnOccupancyPointAvailableInZone,
+  isItemAvailableForPurchase,
+  isSpaceAnchorOccupancyPointAvailable,
+  isSpaceAnchorOccupancyPointAvailableInRect,
+  isSpaceAnchorOccupancyPointAvailableInZone,
   langchainRegistration,
+  listAllowedOccupancyPoints,
+  listOccupancyPointsForSpatialZone,
+  listOccupancyPointsForZone,
+  listOccupancyPointsInRect,
   loadAgentPlayCredentialsFileFromPath,
   loadAgentPlayCredentialsFileFromPathSync2 as loadAgentPlayCredentialsFileFromPathSync,
   loadRootKey2 as loadRootKey,
   mergeSnapshotWithPlayerChainNode,
-  nodeCredentialsMaterialFromHumanPassphrase2 as nodeCredentialsMaterialFromHumanPassphrase,
+  migrateWorldLayoutBounds,
+  nextStreetFromPool,
+  nodeCredentialFromHumanPhrase2 as nodeCredentialFromHumanPhrase,
+  nodeCredentialFromPasswHash,
+  nodeCredentialsMaterialFromHumanPassphrase,
+  occupancyKeyForPosition,
+  occupancyPointsGroupedBySpatialZone,
+  occupancyPointsGroupedByZones,
   parseAgentPlayCredentialsJson,
   parsePlayerChainFanoutNotify,
   parsePlayerChainFanoutNotifyFromSsePayload,
   parsePlayerChainNodeRpcBody,
+  pickZoneForGroup,
+  pointCellInRect,
+  pointCellInSpatialZone,
+  pointCellInZone,
+  primaryZoneForGroup,
   resetAgentPlayDebug,
   resolveAgentPlayCredentialsPath2 as resolveAgentPlayCredentialsPath,
-  sortNodeRefsForSerializedFetch
+  sortNodeRefsForSerializedFetch,
+  spatialZoneBounds,
+  spatialZoneCenter,
+  streetFromPoolEntry,
+  verifyStoredNodeCredential,
+  zonesForGroup
 };
 //# sourceMappingURL=index.js.map