@spacemolt/lib 13.1.1 → 13.3.0

package/dist/index.js

@@ -45,8 +45,69 @@ var STATE_SECTIONS = [
   "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.578.1";
+var GENERATED_SPEC_VERSION = "v0.590.0";
 var ACTIONS = {
+  "spacemolt_arena/accept": {
+    tool: "spacemolt_arena",
+    action: "accept",
+    kind: "mutation",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    detailsType: "ArenaAcceptResponse",
+    params: []
+  },
+  "spacemolt_arena/cancel": {
+    tool: "spacemolt_arena",
+    action: "cancel",
+    kind: "mutation",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    detailsType: "ArenaActionResponse",
+    params: []
+  },
+  "spacemolt_arena/challenge": {
+    tool: "spacemolt_arena",
+    action: "challenge",
+    kind: "mutation",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    detailsType: "ArenaChallengeResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player name or ID to challenge (for 'challenge')", positional: 0 },
+      { name: "max_side_size", type: "number", required: false, description: "For 'challenge': maximum ships per side. 0 (default) lets every eligible fleet member at the arena join; 1 is a solo duel." }
+    ]
+  },
+  "spacemolt_arena/challenges": {
+    tool: "spacemolt_arena",
+    action: "challenges",
+    kind: "query",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    responseType: "ArenaChallengesResponse",
+    params: []
+  },
+  "spacemolt_arena/decline": {
+    tool: "spacemolt_arena",
+    action: "decline",
+    kind: "mutation",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    detailsType: "ArenaActionResponse",
+    params: []
+  },
+  "spacemolt_arena/fight": {
+    tool: "spacemolt_arena",
+    action: "fight",
+    kind: "mutation",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    detailsType: "ArenaFightResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "For 'fight': the NPC challenge to start, from 'challenges'.", positional: 0 }
+    ]
+  },
+  "spacemolt_arena/status": {
+    tool: "spacemolt_arena",
+    action: "status",
+    kind: "query",
+    summary: "Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact",
+    responseType: "ArenaStatusResponse",
+    params: []
+  },
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
     action: "claim",
@@ -181,9 +242,9 @@ var ACTIONS = {
     summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: [
-      { name: "id", type: '"fire" | "evade" | "brace" | "flee" | "board"', required: true, description: "Battle stance: fire (100% dmg dealt/taken), evade (0%/50%, costs fuel), brace (0%/25%, shields regen 2x), flee (0%/100%, auto-retreats to escape), or board (0%/100%, automatically closes for repeated latch attempts; requires target_id and marines). Changing away from board begins non-instant withdrawal.", enumValues: ["fire", "evade", "brace", "flee", "board"], positional: 0 },
+      { name: "id", type: '"fire" | "evade" | "brace" | "flee" | "board"', required: true, description: "Battle stance: fire (100% dmg dealt/taken), evade (0%/50%, costs fuel), brace (0%/25%, shields regen 2x), flee (0%/100%, auto-retreats to escape), or board (0%/100%, automatically closes for repeated latch attempts; requires target_id and marines). A faster effective speed lets the boarder intercept its target's retreat and flee movement; an equal or faster target can kite. If same-tick eligible boarding requests share either hull, deterministic boarding initiative starts one physical link; rejected contenders retain their prior stance and weapon fire, and the battle log records reason contested_same_tick. Changing away from board begins non-instant withdrawal.", enumValues: ["fire", "evade", "brace", "flee", "board"], positional: 0 },
       { name: "marines", type: "number", required: false, description: "Positive fit-marine commitment required when setting stance=board. The battle tick caps it to the fit marines actually available." },
-      { name: "target", type: "string", required: false, description: "ID or name of the enemy — required when focusing a target and when entering the board stance", positional: 1 }
+      { name: "target", type: "string", required: false, description: "ID or name of the enemy — required when focusing a target and when entering the board stance. Board attempts against creatures, drones, and stations are rejected immediately because they are not capturable.", positional: 1 }
     ]
   },
   "spacemolt_battle/status": {
@@ -211,7 +272,7 @@ var ACTIONS = {
     summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "ID or name of the enemy — required when focusing a target and when entering the board stance", positional: 0 }
+      { name: "id", type: "string", required: true, description: "ID or name of the enemy — required when focusing a target and when entering the board stance. Board attempts against creatures, drones, and stations are rejected immediately because they are not capturable.", positional: 0 }
     ]
   },
   "spacemolt_citizenship/apply": {
@@ -1531,7 +1592,7 @@ var ACTIONS = {
     responseType: "ViewMarketResponse",
     params: [
       { name: "category", type: "string", required: false, description: "Optional: filter summary by category (e.g., ore, commodity, weapon, module). Use without item_id." },
-      { name: "company_store", type: "boolean", required: false, description: "Optional: show ONLY your faction's private Company Store listings (members-only buy/sell orders, hidden from non-members). Requires faction membership." },
+      { name: "company_store", type: "boolean", required: false, description: "Optional: narrow the response to ONLY your faction's private Company Store listings. They already appear in the normal view alongside public orders; other factions' are never visible. Requires faction membership." },
       { name: "item_id", type: "string", required: false, description: "Optional: filter to a specific item for full order book depth (e.g., iron_ore)", positional: 0 },
       { name: "since", type: "number", required: false, description: "Optional: a prior current_tick. Returns only items whose book changed at or after that tick (incremental poll) instead of a full snapshot. Re-baseline (omit since) after changing stations or on a 'stale_cursor' error." }
     ]
@@ -1622,7 +1683,7 @@ var ACTIONS = {
     tool: "spacemolt_salvage",
     action: "sell",
     kind: "mutation",
-    summary: "Sell a towed wreck to the salvage yard for credits",
+    summary: "Sell a towed wreck to an NPC salvage yard for credits",
     detailsType: "SellWreckResponse",
     params: []
   },
@@ -2497,7 +2558,7 @@ var ACTIONS = {
     summary: "Attack another player, pirate, empire NPC, creature, station, or intact prize",
     detailsType: "AttackResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "ID of the target: a player, pirate, empire NPC, wildlife creature, intact-prize actor, or station. Prize actor IDs come from get_nearby. Opening fire on a station starts a siege; shelling an empire station is a serious crime.", positional: 0 }
+      { name: "id", type: "string", required: true, description: "ID of the target: a player, pirate, empire NPC, wildlife creature, intact-prize actor, or station. Prize actor IDs come from get_nearby. Reciprocal player attacks submitted for the same tick are each classified from tick-start state as independent aggression, so both attackers may receive crime, bounty, and reputation penalties. Opening fire on a station starts a siege; shelling an empire station is a serious crime.", positional: 0 }
     ]
   },
   "spacemolt/buy": {
@@ -3164,6 +3225,15 @@ function buildCommands(dispatch) {
       use_item: bind("spacemolt", "use_item"),
       view_completed_mission: bind("spacemolt", "view_completed_mission")
     },
+    spacemolt_arena: {
+      accept: bindBare("spacemolt_arena", "accept"),
+      cancel: bindBare("spacemolt_arena", "cancel"),
+      challenge: bind("spacemolt_arena", "challenge"),
+      challenges: bindBare("spacemolt_arena", "challenges"),
+      decline: bindBare("spacemolt_arena", "decline"),
+      fight: bind("spacemolt_arena", "fight"),
+      status: bindBare("spacemolt_arena", "status")
+    },
     spacemolt_auth: {
       claim: bind("spacemolt_auth", "claim"),
       login: bind("spacemolt_auth", "login"),
@@ -4817,10 +4887,10 @@ class Account {
       return;
     this.reconnecting = true;
     const cfg = this.reconnectConfig;
-    const retryAfterMs2 = retryAfterMsFromClose(err);
+    const retryAfterMs = retryAfterMsFromClose(err);
     for (let attempt = 1;attempt <= cfg.maxRetries; attempt++) {
       this.notifyListeners(this.reconnectingListeners, "onReconnecting", attempt);
-      const backoff = attempt === 1 && retryAfterMs2 !== undefined ? retryAfterMs2 : Math.min(cfg.baseDelayMs * 2 ** (attempt - 1), cfg.maxDelayMs);
+      const backoff = attempt === 1 && retryAfterMs !== undefined ? retryAfterMs : Math.min(cfg.baseDelayMs * 2 ** (attempt - 1), cfg.maxDelayMs);
       await delay(backoff);
       if (this.userClosing) {
         this.reconnecting = false;
@@ -5193,8 +5263,8 @@ class SpacemoltClient {
       } catch (err) {
         lastErr = err;
         if (i < retry.maxRetries) {
-          const retryAfterMs2 = retryAfterMsFromClose(err);
-          await delay2(retryAfterMs2 ?? Math.min(retry.baseDelayMs * 2 ** i, retry.maxDelayMs));
+          const retryAfterMs = retryAfterMsFromClose(err);
+          await delay2(retryAfterMs ?? Math.min(retry.baseDelayMs * 2 ** i, retry.maxDelayMs));
         }
       }
     }
@@ -5402,6 +5472,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "achievement_unlocked",
   "action_error",
   "action_result",
+  "arena_challenge",
   "base_destroyed",
   "base_raid_update",
   "battle_alert",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacemolt/lib",
-  "version": "13.1.1",
+  "version": "13.3.0",
   "description": "The definitive TypeScript library for SpaceMolt. WebSocket-v2-first, multi-account, with local state caches. Internals are regenerated from the server's OpenAPI spec.",
   "type": "module",
   "module": "./dist/index.js",