@agent-play/sdk 3.3.5 → 3.3.8

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 { 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-Djc4apJO.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-Djc4apJO.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';
@@ -36,6 +36,8 @@ declare const WORLD_INTERACTION_EVENT = "world:interaction";
 declare const WORLD_AGENT_SIGNAL_EVENT = "world:agent_signal";
 /** Full journey + path update for a player. */
 declare const WORLD_JOURNEY_EVENT = "world:journey";
+/** Ephemeral human positions (not persisted on the world snapshot). */
+declare const WORLD_GEOGRAPHY_EVENT = "world:geography";
 /**
  * Payload for {@link WORLD_AGENT_SIGNAL_EVENT}.
  *
@@ -124,7 +126,12 @@ type RemotePlayWorldLogging = "off" | "on";
 type RemotePlayWorldOptions = {
     baseUrl?: string;
     /**
-     * `rootKey` from `.root` and **`passw`** human phrase from **`credentials.json`** (see **`loadAgentPlayCredentialsFileFromPathSync`** in **@agent-play/node-tools**).
+     * Main node bootstrap credentials: `rootKey` from `.root` and **`passw`** human phrase for the
+     * main node (session connect, snapshot, SSE). Alias: **`nodeCredentials`**.
+     */
+    mainNodeCredentials?: RemotePlayWorldNodeCredentials;
+    /**
+     * @deprecated Alias for {@link RemotePlayWorldOptions.mainNodeCredentials}.
      */
     nodeCredentials?: RemotePlayWorldNodeCredentials;
     /** Called for session lifecycle events (`session:connected`, `session:closed`; see `world-events`). */
@@ -180,16 +187,17 @@ type SubscribeIntercomCommandsOptions = ({
 declare class RemotePlayWorld {
     private readonly apiBase;
     private readonly rootKey;
-    /** Node id derived from hashed passphrase material + root (main or agent node id). */
-    private readonly derivedNodeId;
-    /** Hex SHA-256 of the normalized human phrase; sent as `x-node-passw` and as `passwHash`. */
-    private readonly passwHash;
+    /** Main node id derived from main passphrase material (session bootstrap). */
+    private readonly mainDerivedNodeId;
+    /** Main node passwHash (session bootstrap, snapshot, SSE). */
+    private readonly mainPasswHash;
     private readonly onSessionEvent;
     private readonly transportLog;
     private sid;
     private configuredMainNodeId;
     private closed;
     private readonly closeListeners;
+    private readonly playerAgentCredentials;
     private readonly playerConnectionInfo;
     private audioInitOptions;
     constructor(options?: RemotePlayWorldOptions);
@@ -198,8 +206,15 @@ declare class RemotePlayWorld {
     private emitSessionEvent;
     onClose(handler: () => void): () => void;
     hold(): RemotePlayWorldHold;
-    private authHeaders;
+    private credentialFromHumanPhrase;
+    private resolveAgentCredential;
+    private mainAuthHeaders;
+    private agentAuthHeaders;
+    private agentAuthHeadersForPlayer;
     private jsonHeaders;
+    private mainJsonHeaders;
+    private agentJsonHeaders;
+    private agentJsonHeadersForPlayer;
     private mergeAuthFetch;
     private validateNodeIdentity;
     /**
@@ -271,4 +286,4 @@ declare class RemotePlayWorld {
  */
 declare function intercomResultRecordFromLangChainInvokeOutput(output: unknown): Record<string, unknown>;
 
-export { AddAgentInput, AddPlayerInput, AgentPlaySnapshot, type IntercomToolExecutor, Journey, LangChainAgentRegistration, PLAYER_ADDED_EVENT, PlayerChainNodeResponse, RecordInteractionInput, RegisteredPlayer, RemotePlayWorld, type RemotePlayWorldConnectOptions, type RemotePlayWorldHold, RemotePlayWorldInitAudioOptions, type RemotePlayWorldLogging, type RemotePlayWorldNodeCredentials, type RemotePlayWorldOptions, type RemotePlayWorldSessionEvent, SESSION_CLOSED_EVENT, SESSION_CONNECTED_EVENT, SESSION_INVALID_EVENT, SESSION_SSE_ERROR_EVENT, SESSION_SSE_OPEN_EVENT, type SubscribeIntercomCommandsOptions, WORLD_AGENT_SIGNAL_EVENT, WORLD_INTERACTION_EVENT, WORLD_JOURNEY_EVENT, type WorldAgentSignalPayload, type WorldInteractionPayload, WorldInteractionRole, agentPlayDebug, configureAgentPlayDebug, intercomResultRecordFromLangChainInvokeOutput, isAgentPlayDebugEnabled, langchainRegistration, resetAgentPlayDebug };
+export { AddAgentInput, AddPlayerInput, AgentPlaySnapshot, type IntercomToolExecutor, Journey, LangChainAgentRegistration, PLAYER_ADDED_EVENT, PlayerChainNodeResponse, RecordInteractionInput, RegisteredPlayer, RemotePlayWorld, type RemotePlayWorldConnectOptions, type RemotePlayWorldHold, RemotePlayWorldInitAudioOptions, type RemotePlayWorldLogging, type RemotePlayWorldNodeCredentials, type RemotePlayWorldOptions, type RemotePlayWorldSessionEvent, SESSION_CLOSED_EVENT, SESSION_CONNECTED_EVENT, SESSION_INVALID_EVENT, SESSION_SSE_ERROR_EVENT, SESSION_SSE_OPEN_EVENT, type SubscribeIntercomCommandsOptions, WORLD_AGENT_SIGNAL_EVENT, WORLD_GEOGRAPHY_EVENT, WORLD_INTERACTION_EVENT, WORLD_JOURNEY_EVENT, type WorldAgentSignalPayload, type WorldInteractionPayload, WorldInteractionRole, agentPlayDebug, configureAgentPlayDebug, intercomResultRecordFromLangChainInvokeOutput, isAgentPlayDebugEnabled, langchainRegistration, resetAgentPlayDebug };

package/dist/index.js

@@ -79,7 +79,7 @@ import {
   spatialZoneCenter,
   streetFromPoolEntry,
   zonesForGroup
-} from "./chunk-BCDEUIYP.js";
+} from "./chunk-SLAPRNMF.js";
 
 // src/world-events.ts
 var SESSION_CONNECTED_EVENT = "session:connected";
@@ -91,6 +91,7 @@ var PLAYER_ADDED_EVENT = "world:player_added";
 var WORLD_INTERACTION_EVENT = "world:interaction";
 var WORLD_AGENT_SIGNAL_EVENT = "world:agent_signal";
 var WORLD_JOURNEY_EVENT = "world:journey";
+var WORLD_GEOGRAPHY_EVENT = "world:geography";
 
 // src/lib/agent-play-debug.ts
 var configuredDebug;
@@ -136,7 +137,8 @@ function formatMissingAgentToolsError() {
   return [
     "langchainRegistration: expected a LangChain agent with a tools array.",
     "",
-    "  Pass the object returned from createAgent({ tools: [...] }) (or equivalent) so tool names are available for the play world.",
+    "  Pass the object returned from createAgent({ tools: [...] }) (or equivalent) so tool names are available for assist/chat UI.",
+    "  Tool names no longer spawn map structures; author spaces separately with an owner (see world map v3 docs).",
     '  The tools array must include named tools; see the separate message if "chat_tool" or assist_* tools are missing.'
   ].join("\n");
 }
@@ -394,7 +396,7 @@ var PLAYER_CONNECTION_HEARTBEAT_MAX_ATTEMPTS = 10;
 var PLAYER_CONNECTION_HEARTBEAT_RETRY_DELAY_MS = 1e4;
 function formatMissingCredentialsError() {
   return [
-    "RemotePlayWorld: provide nodeCredentials: { rootKey, passw },",
+    "RemotePlayWorld: provide mainNodeCredentials: { rootKey, passw },",
     "or run agent-play create-main-node so ~/.agent-play/credentials.json exists."
   ].join(" ");
 }
@@ -605,16 +607,17 @@ function normalizeIntercomSubscribePlayerIds(options) {
 var RemotePlayWorld = class {
   apiBase;
   rootKey;
-  /** Node id derived from hashed passphrase material + root (main or agent node id). */
-  derivedNodeId;
-  /** Hex SHA-256 of the normalized human phrase; sent as `x-node-passw` and as `passwHash`. */
-  passwHash;
+  /** Main node id derived from main passphrase material (session bootstrap). */
+  mainDerivedNodeId;
+  /** Main node passwHash (session bootstrap, snapshot, SSE). */
+  mainPasswHash;
   onSessionEvent;
   transportLog;
   sid = null;
   configuredMainNodeId = null;
   closed = false;
   closeListeners = /* @__PURE__ */ new Set();
+  playerAgentCredentials = /* @__PURE__ */ new Map();
   playerConnectionInfo = /* @__PURE__ */ new Map();
   audioInitOptions = null;
   constructor(options = {}) {
@@ -628,15 +631,15 @@ var RemotePlayWorld = class {
     this.apiBase = normalizeBaseUrl(resolvedBaseUrl);
     this.onSessionEvent = options.onSessionEvent;
     this.transportLog = options.logging === "on";
-    const nc = options.nodeCredentials ?? (creds === null ? void 0 : { rootKey: loadRootKey(), passw: creds.passw });
+    const nc = options.mainNodeCredentials ?? 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 credential = nodeCredentialFromHumanPhrase({
         phrase: nc.passw,
         rootKey: this.rootKey
       });
-      this.passwHash = credential.passwHash;
-      this.derivedNodeId = credential.nodeId;
+      this.mainPasswHash = credential.passwHash;
+      this.mainDerivedNodeId = credential.nodeId;
       return;
     }
     throw new Error(formatMissingCredentialsError());
@@ -676,21 +679,58 @@ var RemotePlayWorld = class {
       }
     };
   }
-  authHeaders() {
+  credentialFromHumanPhrase(phrase) {
+    const credential = nodeCredentialFromHumanPhrase({
+      phrase,
+      rootKey: this.rootKey
+    });
+    return { nodeId: credential.nodeId, passwHash: credential.passwHash };
+  }
+  resolveAgentCredential(input) {
+    const phrase = input.agentPassphrase !== void 0 && input.agentPassphrase.length > 0 ? input.agentPassphrase : void 0;
+    if (phrase === void 0) {
+      return { nodeId: input.nodeId.trim(), passwHash: this.mainPasswHash };
+    }
+    const derived = this.credentialFromHumanPhrase(phrase);
+    return { nodeId: input.nodeId.trim(), passwHash: derived.passwHash };
+  }
+  mainAuthHeaders() {
     return {
-      "x-node-id": this.derivedNodeId,
-      "x-node-passw": this.passwHash
+      "x-node-id": this.mainDerivedNodeId,
+      "x-node-passw": this.mainPasswHash
     };
   }
-  jsonHeaders() {
+  agentAuthHeaders(credential) {
+    return {
+      "x-node-id": credential.nodeId,
+      "x-node-passw": credential.passwHash
+    };
+  }
+  agentAuthHeadersForPlayer(playerId) {
+    const stored = this.playerAgentCredentials.get(playerId);
+    if (stored === void 0) {
+      return this.mainAuthHeaders();
+    }
+    return this.agentAuthHeaders(stored);
+  }
+  jsonHeaders(auth) {
     return {
       "content-type": "application/json",
-      ...this.authHeaders()
+      ...auth
     };
   }
+  mainJsonHeaders() {
+    return this.jsonHeaders(this.mainAuthHeaders());
+  }
+  agentJsonHeaders(credential) {
+    return this.jsonHeaders(this.agentAuthHeaders(credential));
+  }
+  agentJsonHeadersForPlayer(playerId) {
+    return this.jsonHeaders(this.agentAuthHeadersForPlayer(playerId));
+  }
   mergeAuthFetch(input, init) {
     const headers = new Headers(init?.headers);
-    const auth = this.authHeaders();
+    const auth = this.mainAuthHeaders();
     for (const [k, v] of Object.entries(auth)) {
       headers.set(k, v);
     }
@@ -706,7 +746,7 @@ var RemotePlayWorld = class {
     }
     const res = await fetch(`${this.apiBase}/api/nodes/validate`, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.agentJsonHeaders(options.auth),
       body: JSON.stringify(body)
     });
     let json;
@@ -716,13 +756,13 @@ var RemotePlayWorld = class {
       throw new Error(`node validation failed: ${String(res.status)} invalid JSON`);
     }
     if (!isRecord(json) || json.ok !== true) {
-      const reason = isRecord(json) && typeof json.reason === "string" ? json.reason : `HTTP ${String(res.status)}`;
+      const reason = isRecord(json) && typeof json.reason === "string" ? json.reason : isRecord(json) && typeof json.error === "string" ? json.error : `HTTP ${String(res.status)}`;
       throw new Error(`node validation failed: ${reason}`);
     }
     const nodeKind = isRecord(json) && typeof json.nodeKind === "string" ? json.nodeKind : void 0;
     agentPlayDebug("remote-play-world", "node identity validated", {
       nodeKind,
-      derivedNodeIdPrefix: `${this.derivedNodeId.slice(0, 8)}\u2026`
+      nodeIdPrefix: `${options.auth.nodeId.slice(0, 8)}\u2026`
     });
     return nodeKind !== void 0 ? { nodeKind } : {};
   }
@@ -733,10 +773,24 @@ var RemotePlayWorld = class {
   async connect(options) {
     const mainNodeIdOpt = options?.mainNodeId?.trim();
     if (mainNodeIdOpt !== void 0 && mainNodeIdOpt.length > 0) {
+      if (mainNodeIdOpt !== this.mainDerivedNodeId) {
+        throw new Error(
+          [
+            "connect: mainNodeId does not match the node id derived from mainNodeCredentials.passw.",
+            `  mainNodeId (option): ${mainNodeIdOpt}`,
+            `  derived node id:     ${this.mainDerivedNodeId}`,
+            "Ensure AGENT_PLAY_MAIN_NODE_ID_* and AGENT_PLAY_MAIN_NODE_ID_*_PASSW are paired from the same create-main-node output."
+          ].join("\n")
+        );
+      }
       this.configuredMainNodeId = mainNodeIdOpt;
       const validation = await this.validateNodeIdentity({
-        nodeId: mainNodeIdOpt,
-        mainNodeId: void 0
+        nodeId: this.mainDerivedNodeId,
+        mainNodeId: void 0,
+        auth: {
+          nodeId: this.mainDerivedNodeId,
+          passwHash: this.mainPasswHash
+        }
       });
       console.info(
         `[agent-play] Node identity validated (${validation.nodeKind ?? "unknown"}).`
@@ -745,7 +799,7 @@ var RemotePlayWorld = class {
       this.configuredMainNodeId = null;
     }
     const res = await fetch(`${this.apiBase}/api/agent-play/session`, {
-      headers: this.authHeaders()
+      headers: this.mainAuthHeaders()
     });
     if (!res.ok) {
       throw new Error(`session failed: ${res.status}`);
@@ -814,7 +868,7 @@ var RemotePlayWorld = class {
   async getWorldSnapshot() {
     const res = await fetch(`${this.apiBase}/api/agent-play/sdk/rpc`, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.mainJsonHeaders(),
       body: JSON.stringify({ op: "getWorldSnapshot", payload: {} })
     });
     const text = await res.text();
@@ -842,7 +896,7 @@ var RemotePlayWorld = class {
     }
     const res = await fetch(`${this.apiBase}/api/agent-play/sdk/rpc`, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.mainJsonHeaders(),
       body: JSON.stringify({
         op: "getPlayerChainNode",
         payload: { stableKey: trimmed }
@@ -962,9 +1016,15 @@ var RemotePlayWorld = class {
    */
   async addAgent(input) {
     const sid = this.getSessionId();
+    const agentCredentialInput = { nodeId: input.nodeId };
+    if (input.agentPassphrase !== void 0 && input.agentPassphrase.length > 0) {
+      agentCredentialInput.agentPassphrase = input.agentPassphrase;
+    }
+    const agentCredential = this.resolveAgentCredential(agentCredentialInput);
     const validation = await this.validateNodeIdentity({
       nodeId: input.nodeId,
-      mainNodeId: input.mainNodeId
+      mainNodeId: input.mainNodeId,
+      auth: agentCredential
     });
     console.info(
       [
@@ -1001,7 +1061,7 @@ var RemotePlayWorld = class {
       type: input.type,
       agent: input.agent,
       mainNodeId: input.mainNodeId,
-      passwHash: this.passwHash,
+      passwHash: agentCredential.passwHash,
       agentId: input.nodeId,
       connectionId,
       leaseTtlSeconds,
@@ -1016,7 +1076,7 @@ var RemotePlayWorld = class {
     const requestBody = JSON.stringify(requestPayload);
     const res = await fetch(url, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.agentJsonHeaders(agentCredential),
       body: requestBody
     });
     const bodyText = await res.text();
@@ -1040,6 +1100,7 @@ var RemotePlayWorld = class {
     const registeredAgent = parseRegisteredAgentSummary(body.registeredAgent);
     const bodyConnectionId = typeof body.connectionId === "string" && body.connectionId.length > 0 ? body.connectionId : connectionId;
     const bodyLeaseTtlSeconds = typeof body.leaseTtlSeconds === "number" && Number.isFinite(body.leaseTtlSeconds) ? body.leaseTtlSeconds : leaseTtlSeconds;
+    this.playerAgentCredentials.set(playerId, agentCredential);
     const existingConnection = this.playerConnectionInfo.get(playerId);
     if (existingConnection !== void 0) {
       clearInterval(existingConnection.timer);
@@ -1115,14 +1176,18 @@ var RemotePlayWorld = class {
     return this.addAgent(payload);
   }
   async recordInteraction(input) {
-    await this.rpc("recordInteraction", {
-      playerId: input.playerId,
-      role: input.role,
-      text: input.text
-    });
+    await this.rpc(
+      "recordInteraction",
+      {
+        playerId: input.playerId,
+        role: input.role,
+        text: input.text
+      },
+      input.playerId
+    );
   }
   async recordJourney(playerId, journey) {
-    await this.rpc("recordJourney", { playerId, journey });
+    await this.rpc("recordJourney", { playerId, journey }, playerId);
   }
   async sendIntercomResponse(payload) {
     const sid = this.getSessionId();
@@ -1140,7 +1205,7 @@ var RemotePlayWorld = class {
     });
     const res = await fetch(url, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.agentJsonHeadersForPlayer(payload.fromPlayerId),
       body: JSON.stringify({ op: INTERCOM_RESPONSE_OP, payload })
     });
     const okText = await res.text();
@@ -1356,7 +1421,7 @@ var RemotePlayWorld = class {
     }
     const res = await fetch(url, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.mainJsonHeaders(),
       body: JSON.stringify(body)
     });
     const text = await res.text();
@@ -1374,12 +1439,12 @@ var RemotePlayWorld = class {
     }
     return json.id;
   }
-  async rpc(op, payload) {
+  async rpc(op, payload, playerId) {
     const sid = this.getSessionId();
     const url = `${this.apiBase}/api/agent-play/sdk/rpc?sid=${encodeURIComponent(sid)}`;
     const res = await fetch(url, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.agentJsonHeadersForPlayer(playerId),
       body: JSON.stringify({ op, payload })
     });
     if (!res.ok) {
@@ -1401,7 +1466,7 @@ var RemotePlayWorld = class {
       try {
         const res = await fetch(url, {
           method: "POST",
-          headers: this.jsonHeaders(),
+          headers: this.agentJsonHeadersForPlayer(input.playerId),
           body: bodyJson
         });
         const text = await res.text();
@@ -1455,7 +1520,7 @@ var RemotePlayWorld = class {
     const url = `${this.apiBase}/api/agent-play/players/disconnect?sid=${encodeURIComponent(sid)}`;
     await fetch(url, {
       method: "POST",
-      headers: this.jsonHeaders(),
+      headers: this.agentJsonHeadersForPlayer(input.playerId),
       body: JSON.stringify({
         playerId: input.playerId,
         connectionId: input.connectionId
@@ -1510,6 +1575,7 @@ export {
   TALK_TICK_SECONDS,
   WALLET_BUNDLE_OFFERS,
   WORLD_AGENT_SIGNAL_EVENT,
+  WORLD_GEOGRAPHY_EVENT,
   WORLD_INTERACTION_EVENT,
   WORLD_JOURNEY_EVENT,
   agentPlayDebug,