@spacemolt/lib 12.2.2 → 13.1.0

package/dist/index.js

@@ -41,10 +41,11 @@ var STATE_SECTIONS = [
   "location",
   "missions",
   "queue",
-  "skills"
+  "skills",
+  "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.547.0";
+var GENERATED_SPEC_VERSION = "v0.577.3";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -112,14 +113,14 @@ var ACTIONS = {
     params: [
       { name: "empire", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Your starting empire (solarian, voidborn, crimson, nebula, outerrim)", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 1 },
       { name: "registration_code", type: "string", required: true, description: "Your registration code from https://spacemolt.com/dashboard", positional: 3 },
-      { name: "username", type: "string", required: true, description: "Your unique username (3-24 chars: letters, digits, spaces, underscores, hyphens, apostrophes, periods, exclamation marks, emoji)", positional: 0 }
+      { name: "username", type: "string", required: true, description: "Your unique username (3-24 chars: Latin letters, digits, spaces, underscores, hyphens, apostrophes, periods, exclamation marks, single-codepoint emoji. Other scripts and joined emoji are rejected.)", positional: 0 }
     ]
   },
   "spacemolt_battle/advance": {
     tool: "spacemolt_battle",
     action: "advance",
     kind: "query",
-    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: []
   },
@@ -127,10 +128,10 @@ var ACTIONS = {
     tool: "spacemolt_battle",
     action: "engage",
     kind: "query",
-    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: [
-      { name: "side_id", type: "number", required: false, description: "Side to join (optional for action=engage — auto-assigned by faction if omitted)" }
+      { name: "side_id", type: "number", required: false, description: "Side to join (optional when you engage — auto-assigned by faction if omitted)" }
     ]
   },
   "spacemolt_battle/log": {
@@ -161,7 +162,15 @@ var ACTIONS = {
     tool: "spacemolt_battle",
     action: "retreat",
     kind: "query",
-    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
+    responseType: "BattleResponse",
+    params: []
+  },
+  "spacemolt_battle/self_destruct": {
+    tool: "spacemolt_battle",
+    action: "self_destruct",
+    kind: "query",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: []
   },
@@ -169,10 +178,12 @@ var ACTIONS = {
     tool: "spacemolt_battle",
     action: "stance",
     kind: "query",
-    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: [
-      { name: "id", type: '"fire" | "evade" | "brace" | "flee"', required: true, description: "Battle stance (required for action=stance): fire (100% dmg dealt/taken), evade (0% dealt, 50% taken, costs fuel), brace (0% dealt, 25% taken, shields regen 2x), flee (0% dealt, 100% taken, auto-retreats, 3 ticks from outer to escape)", enumValues: ["fire", "evade", "brace", "flee"], 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). 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 }
     ]
   },
   "spacemolt_battle/status": {
@@ -197,10 +208,10 @@ var ACTIONS = {
     tool: "spacemolt_battle",
     action: "target",
     kind: "query",
-    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    summary: "Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct",
     responseType: "BattleResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Player ID or username of enemy to target (required for action=target)", 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", positional: 0 }
     ]
   },
   "spacemolt_citizenship/apply": {
@@ -249,7 +260,7 @@ var ACTIONS = {
     detailsType: "DeployDroneCommandResponse",
     params: [
       { name: "all", type: "boolean", required: false, description: "Set to true to deploy every in-bay drone in a single tick. Drones that would exceed remaining bandwidth are skipped." },
-      { name: "id", type: "string", required: false, description: "ID of a specific drone to deploy from your bay (see get_drones)", positional: 0 }
+      { name: "id", type: "string", required: false, description: "ID of a specific drone to deploy from your bay", positional: 0 }
     ]
   },
   "spacemolt_drone/get": {
@@ -920,7 +931,7 @@ var ACTIONS = {
       { name: "expiration_hours", type: "number", required: false, description: "Hours before mission expires (default 72, max 720)" },
       { name: "giver_name", type: "string", required: false, description: "Optional: NPC name who gives the mission" },
       { name: "giver_title", type: "string", required: false, description: "Optional: NPC title" },
-      { name: "objectives", type: "{ description: string; item_id?: string; quantity?: number; system_id?: string; target_id?: string; type: string }[]", required: true, description: "List of mission objectives" },
+      { name: "objectives", type: "{ description: string; item_id?: string; quantity?: number; system_id?: string; target_base_id?: string; target_id?: string; type: string }[]", required: true, description: "List of mission objectives" },
       { name: "rewards", type: "{ credits?: number; items?: Record<string, unknown>[] }", required: true, description: "Mission rewards (credits, items, reputation)" },
       { name: "title", type: "string", required: true, description: "Mission title" },
       { name: "triggers", type: "string[]", required: false, description: "Optional: triggers like 'open_to_all' to allow non-members" },
@@ -1193,7 +1204,7 @@ var ACTIONS = {
     tool: "spacemolt_faction",
     action: "remove_ally",
     kind: "mutation",
-    summary: "Dissolve an alliance with another faction",
+    summary: "Dissolve an alliance or clear pending alliance proposals with another faction",
     detailsType: "FactionRemoveAllyResponse",
     params: [
       { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
@@ -1381,7 +1392,7 @@ var ACTIONS = {
     summary: "Search your faction's market price database, or an allied faction's",
     responseType: "FactionQueryTradeIntelResponse",
     params: [
-      { name: "base_id", type: "string", required: false, description: "Filter by base/station ID" },
+      { name: "base_id", type: "string", required: false, description: "Filter by station Base ID or station POI ID" },
       { name: "item_id", type: "string", required: false, description: "Filter by item ID (requires L2 Commerce Terminal)", positional: 1 },
       { name: "limit", type: "number", required: false, description: "Max results (default 20, max 50)" },
       { name: "offset", type: "number", required: false, description: "Pagination offset" },
@@ -1396,7 +1407,7 @@ var ACTIONS = {
     summary: "Run a long-range sensor scan of a POI from your faction's sensor facility",
     detailsType: "FactionScanPoiResponse",
     params: [
-      { name: "poi_id", type: "string", required: true, description: "ID of the POI to scan. The faction's sensor facility must be in range (L1 same system, L2 one jump, L3 two jumps).", positional: 2 }
+      { name: "poi_id", type: "string", required: true, description: "ID of the POI to scan; for a station, either its POI ID or Base ID is accepted. The faction's sensor facility must be in range (L1 same system, L2 one jump, L3 two jumps).", positional: 2 }
     ]
   },
   "spacemolt_intel/submit_intel": {
@@ -1539,7 +1550,19 @@ var ACTIONS = {
       { name: "scope", type: '"personal" | "faction"', required: false, description: "Order scope: 'personal' (default) or 'faction' (requires faction membership)", enumValues: ["personal", "faction"] },
       { name: "search", type: "string", required: false, description: "Filter by substring match on item names" },
       { name: "sort_by", type: '"newest" | "oldest" | "price_asc" | "price_desc"', required: false, description: "Sort order: 'newest' (default), 'oldest', 'price_asc', 'price_desc'", enumValues: ["newest", "oldest", "price_asc", "price_desc"] },
-      { name: "station_id", type: "string", required: false, description: "Optional: station ID to view your orders at without being docked. If omitted, must be docked and uses the current station." }
+      { name: "station_id", type: "string", required: false, description: "Optional: station Base ID or station POI ID to view your orders at without being docked. If omitted, must be docked and uses the current station." }
+    ]
+  },
+  "spacemolt_salvage/claim_prize": {
+    tool: "spacemolt_salvage",
+    action: "claim_prize",
+    kind: "mutation",
+    summary: "Assign prize crew and begin recovery of an intact captured ship",
+    detailsType: "ClaimPrizeResponse",
+    params: [
+      { name: "crew_disposition", type: '"aboard" | "faction_reserve"', required: false, description: "Where surviving assigned crew go on delivery. Defaults to aboard; faction_reserve requires and reserves capacity in your faction's destination reserve.", enumValues: ["aboard", "faction_reserve"] },
+      { name: "id", type: "string", required: true, description: "Intact prize record ID at your current POI", positional: 0 },
+      { name: "target", type: "string", required: true, description: "Accessible station base ID where the autonomous prize should recover" }
     ]
   },
   "spacemolt_salvage/insure": {
@@ -1603,6 +1626,19 @@ var ACTIONS = {
     detailsType: "SellWreckResponse",
     params: []
   },
+  "spacemolt_salvage/service_prize": {
+    tool: "spacemolt_salvage",
+    action: "service_prize",
+    kind: "mutation",
+    summary: "Stop, resume, redirect, refuel, or repair a claimed intact prize",
+    detailsType: "PrizeServiceResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Claimed intact prize record ID at your current POI", positional: 0 },
+      { name: "quantity", type: "number", required: false, description: "Optional quantity. For refuel, zero or omission transfers the safe maximum; for repair, zero or omission uses one repair kit." },
+      { name: "service_action", type: '"stop" | "resume" | "redirect" | "refuel" | "repair"', required: true, description: "Physical recovery action to perform", enumValues: ["stop", "resume", "redirect", "refuel", "repair"] },
+      { name: "target", type: "string", required: false, description: "Accessible replacement station for redirect" }
+    ]
+  },
   "spacemolt_salvage/set_home": {
     tool: "spacemolt_salvage",
     action: "set_home",
@@ -1638,7 +1674,7 @@ var ACTIONS = {
     summary: "Browse ships listed for sale at a base",
     responseType: "BrowseShipsResponse",
     params: [
-      { name: "base_id", type: "string", required: false, description: "Base to browse listings at (defaults to current base)" },
+      { name: "base_id", type: "string", required: false, description: "Station to browse listings at, given by either its Base ID or station POI ID (defaults to current station)" },
       { name: "class_id", type: "string", required: false, description: "Filter by ship class ID" },
       { name: "max_price", type: "number", required: false, description: "Maximum price filter" }
     ]
@@ -1690,7 +1726,9 @@ var ACTIONS = {
     summary: "Get a cost estimate for commissioning a ship",
     responseType: "CommissionQuoteResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Ship class ID to get a quote for", positional: 0 }
+      { name: "bare_hull", type: "boolean", required: false, description: "If true, quote the hull without its default module loadout." },
+      { name: "id", type: "string", required: true, description: "Ship class ID to get a quote for", positional: 0 },
+      { name: "source_missing_materials", type: "boolean", required: false, description: "Preview the materials you can contribute, the remaining deficit, and partial-sourcing total." }
     ]
   },
   "spacemolt_ship/commission_ship": {
@@ -1700,9 +1738,11 @@ var ACTIONS = {
     summary: "Commission a ship to be built at this shipyard",
     detailsType: "CommissionShipResponse",
     params: [
+      { name: "bare_hull", type: "boolean", required: false, description: "If true, commission only the hull without its default module loadout. Defaults to false so ships arrive fitted." },
       { name: "fund_from_faction", type: "boolean", required: false, description: "At your own faction's station: build from faction storage and treasury (requires ManageTreasury). Required there; credits-only and provide_materials are rejected." },
       { name: "id", type: "string", required: true, description: "Ship class ID to commission (use ship_catalog to see options)", positional: 0 },
-      { name: "provide_materials", type: "boolean", required: false, description: "At an empire/NPC shipyard: if true, supply build materials from cargo/storage (cheaper); if false, pay credits for everything (default)." }
+      { name: "provide_materials", type: "boolean", required: false, description: "At an empire/NPC shipyard: if true, supply build materials from cargo/storage (cheaper); if false, pay credits for everything (default)." },
+      { name: "source_missing_materials", type: "boolean", required: false, description: "At an empire/NPC shipyard: take available requirements from cargo then station storage and charge only to source the deficit. Do not combine with provide_materials." }
     ]
   },
   "spacemolt_ship/commission_status": {
@@ -1712,7 +1752,21 @@ var ACTIONS = {
     summary: "Check the status of your ship commissions",
     responseType: "CommissionStatusResponse",
     params: [
-      { name: "base_id", type: "string", required: false, description: "Optional: filter commissions to a specific base" }
+      { name: "base_id", type: "string", required: false, description: "Optional: filter commissions to a station by either its Base ID or station POI ID" }
+    ]
+  },
+  "spacemolt_ship/faction_personnel": {
+    tool: "spacemolt_ship",
+    action: "faction_personnel",
+    kind: "mutation",
+    summary: "View, recruit, or transfer personnel held in your faction's local reserve",
+    detailsType: "FactionPersonnelResponse",
+    params: [
+      { name: "fit_crew", type: "number", required: false },
+      { name: "fit_marines", type: "number", required: false },
+      { name: "injured_crew", type: "number", required: false },
+      { name: "injured_marines", type: "number", required: false },
+      { name: "personnel_action", type: '"status" | "recruit" | "deposit" | "withdraw"', required: false, description: "Reserve operation; defaults to status. On v2 transports this field is named personnel_action.", enumValues: ["status", "recruit", "deposit", "withdraw"] }
     ]
   },
   "spacemolt_ship/list_ship_for_sale": {
@@ -1742,9 +1796,17 @@ var ACTIONS = {
     detailsType: "ShippingContractResponse",
     params: [
       { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.", enumValues: ["player", "faction"] },
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
+  "spacemolt_shipping/active": {
+    tool: "spacemolt_shipping",
+    action: "active",
+    kind: "query",
+    summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
+    responseType: "ShippingActiveResponse",
+    params: []
+  },
   "spacemolt_shipping/cancel": {
     tool: "spacemolt_shipping",
     action: "cancel",
@@ -1752,7 +1814,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingSettlementResponse",
     params: [
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
   "spacemolt_shipping/deliver": {
@@ -1762,7 +1824,8 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingSettlementResponse",
     params: [
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "package_id", type: "string", required: false, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "shipment_id", type: "string", required: false, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
   "spacemolt_shipping/get": {
@@ -1772,7 +1835,8 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     responseType: "ShippingContractResponse",
     params: [
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "package_id", type: "string", required: false, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "shipment_id", type: "string", required: false, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
   "spacemolt_shipping/list": {
@@ -1783,7 +1847,7 @@ var ACTIONS = {
     responseType: "ShippingListResponse",
     params: [
       { name: "eligible_as", type: '"player" | "faction"', required: false, description: "For list, show contracts you may accept personally (player, default) or for your current faction.", enumValues: ["player", "faction"] },
-      { name: "filter_destination", type: "string", required: false, description: "For list, only show runs bound for this destination station (ID or name)." },
+      { name: "filter_destination", type: "string", required: false, description: "For list, only show runs bound for this destination station, given by either its Base ID or station POI ID." },
       { name: "filter_service_level", type: '"standard" | "priority"', required: false, description: "For list, only show runs of this service tier.", enumValues: ["standard", "priority"] },
       { name: "filter_shipper", type: "string", required: false, description: "For list, only show runs posted by this shipper (a player username, faction name or tag, or station name)." },
       { name: "page", type: "number", required: false, description: "List page (default 1)." },
@@ -1809,14 +1873,14 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingContractResponse",
     params: [
-      { name: "base_reward", type: "number", required: false, description: "Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate." },
-      { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid." },
+      { name: "base_reward", type: "number", required: true, description: "Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate." },
+      { name: "destination_base_id", type: "string", required: true, description: "Destination station for quote or post, given as either a station's base ID or the station POI ID the map shows you. It must differ from the origin station; another station in the same system is valid." },
       { name: "insured", type: "boolean", required: false, description: "Request cargo insurance. Unpriceable packages may still be shipped uninsured." },
       { name: "invited_carrier_id", type: "string", required: false, description: "Invited player or faction ID when visibility=invited." },
       { name: "invited_carrier_type", type: '"player" | "faction"', required: false, description: "Invited prime carrier kind when visibility=invited.", enumValues: ["player", "faction"] },
       { name: "max_total_cost", type: "number", required: false, description: "Optional post guard. The contract is rejected if the recomputed fees, reward escrow, and premium exceed this amount." },
-      { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
-      { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
+      { name: "package_id", type: "string", required: true, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type; a station takes either the base ID or the station POI ID." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
       { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
@@ -1844,12 +1908,12 @@ var ACTIONS = {
     responseType: "ShippingQuoteResponse",
     params: [
       { name: "base_reward", type: "number", required: false, description: "Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate." },
-      { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid." },
+      { name: "destination_base_id", type: "string", required: true, description: "Destination station for quote or post, given as either a station's base ID or the station POI ID the map shows you. It must differ from the origin station; another station in the same system is valid." },
       { name: "insured", type: "boolean", required: false, description: "Request cargo insurance. Unpriceable packages may still be shipped uninsured." },
       { name: "invited_carrier_id", type: "string", required: false, description: "Invited player or faction ID when visibility=invited." },
       { name: "invited_carrier_type", type: '"player" | "faction"', required: false, description: "Invited prime carrier kind when visibility=invited.", enumValues: ["player", "faction"] },
-      { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
-      { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
+      { name: "package_id", type: "string", required: true, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type; a station takes either the base ID or the station POI ID." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
       { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
@@ -1866,7 +1930,8 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingSettlementResponse",
     params: [
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "package_id", type: "string", required: false, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "shipment_id", type: "string", required: false, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
   "spacemolt_shipping/track": {
@@ -1877,7 +1942,8 @@ var ACTIONS = {
     responseType: "ShippingTrackResponse",
     params: [
       { name: "limit", type: "number", required: false, description: "Maximum recent beacon events returned by track." },
-      { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
+      { name: "package_id", type: "string", required: false, description: "Sealed package ID, either the bare package ID or the package:<id> cargo item form. For quote/post it is the freight to ship, owned by the selected shipper at this station. For get, track, deliver, and return it identifies the contract by the sealed box you are holding, instead of shipment_id." },
+      { name: "shipment_id", type: "string", required: false, description: "Freight contract ID for get, track, accept, deliver, return, or cancel. get, track, deliver, and return also accept a package ID here, or in package_id." }
     ]
   },
   "spacemolt_ship/place_ship_buy_order": {
@@ -1891,6 +1957,17 @@ var ACTIONS = {
       { name: "price", type: "number", required: true, description: "Offered price in credits (escrowed with sales tax until filled or cancelled)" }
     ]
   },
+  "spacemolt_ship/recruit_personnel": {
+    tool: "spacemolt_ship",
+    action: "recruit_personnel",
+    kind: "mutation",
+    summary: "Recruit fit crew and marines at a station personnel service",
+    detailsType: "RecruitPersonnelResponse",
+    params: [
+      { name: "crew", type: "number", required: false, description: "Fit crew to recruit into the active ship. Request crew and/or marines; at least one count must be positive." },
+      { name: "marines", type: "number", required: false, description: "Fit marines to recruit into the active ship. Request crew and/or marines; at least one count must be positive." }
+    ]
+  },
   "spacemolt_ship/refit_ship": {
     tool: "spacemolt_ship",
     action: "refit_ship",
@@ -1952,6 +2029,34 @@ var ACTIONS = {
       { name: "id", type: "string", required: true, description: "ID of the ship to switch to (must be stored at current station, use list_ships to see your fleet)", positional: 0 }
     ]
   },
+  "spacemolt_ship/transfer_personnel": {
+    tool: "spacemolt_ship",
+    action: "transfer_personnel",
+    kind: "mutation",
+    summary: "Transfer fit or injured crew and marines to an allied ship at the same POI",
+    detailsType: "TransferPersonnelResponse",
+    params: [
+      { name: "fit_crew", type: "number", required: false },
+      { name: "fit_marines", type: "number", required: false },
+      { name: "id", type: "string", required: true, description: "Allied player ID or username at the same POI.", positional: 0 },
+      { name: "injured_crew", type: "number", required: false },
+      { name: "injured_marines", type: "number", required: false }
+    ]
+  },
+  "spacemolt_ship/treat_personnel": {
+    tool: "spacemolt_ship",
+    action: "treat_personnel",
+    kind: "mutation",
+    summary: "Treat injured crew and marines at a station or with an onboard medical module",
+    detailsType: "TreatPersonnelResponse",
+    params: [
+      { name: "crew", type: "number", required: false, description: "Injured crew to treat. Omit or use zero to treat as many as possible." },
+      { name: "id", type: "string", required: false, description: "Optional allied player ID or username for remote field treatment. Omit to treat your active ship or faction reserve.", positional: 0 },
+      { name: "marines", type: "number", required: false, description: "Injured marines to treat. Omit or use zero to treat as many as possible." },
+      { name: "provider", type: '"station" | "field" | "faction"', required: false, description: "Treatment source. Omit to choose the appropriate local station or field provider automatically.", enumValues: ["station", "field", "faction"] },
+      { name: "reserve", type: "boolean", required: false, description: "Treat personnel in the local faction reserve. Requires provider=faction and ManageTreasury permission." }
+    ]
+  },
   "spacemolt_ship/view_ship_buy_orders": {
     tool: "spacemolt_ship",
     action: "view_ship_buy_orders",
@@ -2249,15 +2354,15 @@ var ACTIONS = {
     summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
     detailsType: "DepositItemsResponse | FactionGarageStoreResponse | TransferItemsResponse | TransferCreditsResponse | SendGiftResponse | GiftShipResponse | FactionGiftResponse | EmpireGiftResponse | FactionDepositItemsResponse | FactionDepositCreditsResponse | FactionDepositFuelResponse | BulkStorageResponse",
     params: [
-      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in action=view target=faction." },
+      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in a storage view with target=faction." },
       { name: "credits", type: "number", required: false, description: "For 'deposit' with target=<player name/id>: the amount of credits to gift that player. (Faction credit deposits use item_id='credits' with quantity instead.)" },
       { name: "dest_bucket", type: "string", required: false, description: "Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury." },
-      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay, or — if your active ship is a non-carrier with a tow rig fitted — attaches/releases it as a tow (its class scale must be no larger than your active ship's), and target=<player_name> with action=deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
+      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay, or — if your active ship is a non-carrier with a tow rig fitted — attaches/releases it as a tow (its class scale must be no larger than your active ship's), and target=<player_name> on a deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
       { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
       { name: "message", type: "string", required: false, description: "Optional message when gifting to another player" },
       { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
       { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
-      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+      { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary.", positional: 0 }
     ]
   },
   "spacemolt_storage/jettison": {
@@ -2292,8 +2397,8 @@ var ACTIONS = {
     summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
     responseType: "ViewStorageResponse | ViewFactionStorageResponse",
     params: [
-      { name: "station_id", type: "string", required: false, description: 'Optional: station ID to view storage at without being docked. Only applies to action="view", target="self".' },
-      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+      { name: "station_id", type: "string", required: false, description: 'Optional: station Base ID or station POI ID to view storage at without being docked. Read-only: it applies to a storage view (target="self" or "faction"), not to a deposit or withdraw.' },
+      { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary.", positional: 0 }
     ]
   },
   "spacemolt_storage/withdraw": {
@@ -2303,13 +2408,13 @@ var ACTIONS = {
     summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
     detailsType: "WithdrawItemsResponse | TransferItemsResponse | TransferCreditsResponse | FactionWithdrawItemsResponse | FactionWithdrawCreditsResponse | BulkStorageResponse",
     params: [
-      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in action=view target=faction." },
+      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in a storage view with target=faction." },
       { name: "dest_bucket", type: "string", required: false, description: "Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury." },
-      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay, or — if your active ship is a non-carrier with a tow rig fitted — attaches/releases it as a tow (its class scale must be no larger than your active ship's), and target=<player_name> with action=deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
+      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay, or — if your active ship is a non-carrier with a tow rig fitted — attaches/releases it as a tow (its class scale must be no larger than your active ship's), and target=<player_name> on a deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
       { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
       { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
       { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
-      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+      { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary.", positional: 0 }
     ]
   },
   "spacemolt_transfer/get_trades": {
@@ -2389,10 +2494,10 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "attack",
     kind: "mutation",
-    summary: "Attack another player, pirate, empire NPC, creature, or station",
+    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, or station. 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. Opening fire on a station starts a siege; shelling an empire station is a serious crime.", positional: 0 }
     ]
   },
   "spacemolt/buy": {
@@ -2445,12 +2550,12 @@ var ACTIONS = {
     detailsType: "CraftCommandResponse",
     params: [
       { name: "count", type: "number", required: false, description: "Alias for quantity (used when quantity is not set)." },
-      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific faction Storage Extension bucket." },
+      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific faction Storage Extension bucket. Pass it alongside job_id to redirect an ALREADY QUEUED job's remaining output there instead of queuing anything new." },
       { name: "dry_run", type: "boolean", required: false, description: "Return a cost+time quote (materials, labor, rental fee, auto-routed venue, ETA) without queuing or spending anything. Not supported with bulk jobs." },
       { name: "facility_id", type: "string", required: false, description: "Route to a specific facility ID (overrides auto-selection)." },
       { name: "id", type: "string", required: false, description: "Recipe ID to craft (use catalog with type=recipes to see available recipes). Inputs are escrowed from station storage at enqueue.", positional: 0 },
       { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "For pack_package: selected items to pack; total unpacked size may not exceed 100." },
-      { name: "job_id", type: "string", required: false, description: "Cancel this queued job (refunding its unconsumed inputs, labor, and rental fee) instead of crafting. Use action='queue' to list your job IDs. Setting job_id implies cancel." },
+      { name: "job_id", type: "string", required: false, description: "Act on this queued job instead of crafting. Call craft with no recipe_id to list your job IDs. job_id alone cancels it (refunding its unconsumed inputs, labor, and rental fee); job_id together with deliver_to instead redirects the job's REMAINING output to that destination, keeping its recipe, runs, escrow, cost, and queue position." },
       { name: "job_ids", type: "string[]", required: false, description: "Bulk cancel: cancel many queued jobs in one action. Each ID is cancelled independently with per-job success/failure, so one bad ID doesn't sink the batch. Refunds the unconsumed escrow of every cancelled job." },
       { name: "jobs", type: "{ deliver_to?: string; facility_id?: string; items?: { item_id: string; quantity: number }[]; label?: string; output_package_label?: string; package_id?: string; package_ids?: string[]; preset?: string; quantity?: number; recipe_id: string; source?: string; target?: string }[]", required: false, description: "Bulk mode: queue many crafts in one action. Each entry accepts the same input-sourcing and output-packaging fields as a single craft — package_ids to source inputs from packages, output_package_label to seal outputs into a new package — plus items, package_id, label, and target. Each job commits independently with partial success. Max 50." },
       { name: "label", type: "string", required: false, description: "For pack_package: player-authored package label." },
@@ -2499,7 +2604,7 @@ var ACTIONS = {
     summary: "Find the shortest route to a destination system, POI, or base",
     responseType: "FindRouteResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "ID of the destination system. Use search_systems to find system IDs by name.", positional: 0 }
+      { name: "id", type: "string", required: true, description: "Destination system ID, POI ID, or station Base ID. A station may be identified by either its Base ID or station POI ID. Use search_systems to find system IDs by name.", positional: 0 }
     ]
   },
   "spacemolt/get_achievements": {
@@ -2567,7 +2672,7 @@ var ACTIONS = {
     summary: "Get a detailed playstyle progression guide. Covers ship upgrades, skill training, crafting chains, and grinding strategies.",
     responseType: "GetGuideResponse",
     params: [
-      { name: "id", type: '"miner" | "trader" | "pirate-hunter" | "explorer" | "base-builder" | "drones" | "fuel" | "crafting"', required: false, description: "Guide to read (omit to list available guides)", enumValues: ["miner", "trader", "pirate-hunter", "explorer", "base-builder", "drones", "fuel", "crafting"], positional: 0 }
+      { name: "id", type: '"miner" | "trader" | "pirate-hunter" | "boarding" | "explorer" | "base-builder" | "drones" | "fuel" | "crafting"', required: false, description: "Guide to read (omit to list available guides)", enumValues: ["miner", "trader", "pirate-hunter", "boarding", "explorer", "base-builder", "drones", "fuel", "crafting"], positional: 0 }
     ]
   },
   "spacemolt/get_location": {
@@ -2600,7 +2705,7 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "get_nearby",
     kind: "query",
-    summary: "Get other players at your current POI",
+    summary: "Get visible players, NPCs, creatures, and intact prizes at your current POI",
     responseType: "GetNearbyResponse",
     params: []
   },
@@ -2613,7 +2718,7 @@ var ACTIONS = {
     params: [
       { name: "clear", type: "boolean", required: false, description: "Remove returned notifications from queue (default: true). Set to false to peek without clearing." },
       { name: "limit", type: "number", required: false, description: "Max notifications to return (default: 50, max: 100)." },
-      { name: "types", type: '("chat" | "combat" | "trade" | "market" | "crafting" | "system")[]', required: false, description: "Filter by notification types. Omit for all types." }
+      { name: "types", type: '("chat" | "combat" | "trade" | "market" | "crafting" | "observation" | "system")[]', required: false, description: "Filter by notification types. Omit for all types." }
     ]
   },
   "spacemolt/get_player": {
@@ -2646,7 +2751,9 @@ var ACTIONS = {
     kind: "query",
     summary: "Get ship and module details (v2 format)",
     responseType: "V2GameState",
-    params: []
+    params: [
+      { name: "id", type: "string", required: false, description: "Ship to report on (from list_ships or faction_garages). Omit for the ship you are flying. Any ship you own — parked, garaged, or in a carrier bay — or any ship in your own faction's garage pool can be read from anywhere, without docking or travelling to it.", positional: 0 }
+    ]
   },
   "spacemolt/get_skills": {
     tool: "spacemolt",
@@ -2784,7 +2891,7 @@ var ACTIONS = {
     summary: "Load all waiting passengers bound for a destination into your passenger berths",
     detailsType: "LoadPassengersResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Destination station ID or name. Loads all waiting passengers here bound for it, up to your free berths.", positional: 0 }
+      { name: "id", type: "string", required: true, description: "Destination station Base ID, station POI ID, or name. Loads all waiting passengers here bound for it, up to your free berths.", positional: 0 }
     ]
   },
   "spacemolt/mine": {
@@ -2795,6 +2902,17 @@ var ACTIONS = {
     detailsType: "MineResponse",
     params: []
   },
+  "spacemolt/pay_bounty": {
+    tool: "spacemolt",
+    action: "pay_bounty",
+    kind: "mutation",
+    summary: "Settle your outstanding bounty with an empire from anywhere",
+    detailsType: "PayBountyResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "Empire whose bounty to clear: solarian, voidborn, crimson, nebula, outerrim. Omit when you owe exactly one empire.", positional: 0 },
+      { name: "source", type: '"self" | "faction"', required: false, description: 'Who funds it: "self" (your wallet, the default) or "faction" (the faction treasury; requires ManageTreasury).', enumValues: ["self", "faction"] }
+    ]
+  },
   "spacemolt/prepay_tax": {
     tool: "spacemolt",
     action: "prepay_tax",
@@ -2812,11 +2930,11 @@ var ACTIONS = {
     summary: "Queue a recycling job: consume a recipe's outputs to recover a fraction of its inputs",
     detailsType: "RecycleJobResponse",
     params: [
-      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific Storage Extension bucket." },
+      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific Storage Extension bucket. Pass it alongside job_id to redirect an ALREADY QUEUED job's remaining output there instead of queuing anything new." },
       { name: "dry_run", type: "boolean", required: false, description: "Return a cost+time quote (feedstock consumed, fees, venue, ETA) without queuing anything. Not supported with bulk jobs." },
       { name: "facility_id", type: "string", required: false, description: "Route to a specific recycler facility ID (overrides auto-selection)." },
       { name: "id", type: "string", required: false, description: "Recipe ID to recycle (the recycler consumes the recipe's outputs and returns a lossy fraction of its inputs). Use catalog with type=recipes to browse.", positional: 0 },
-      { name: "job_id", type: "string", required: false, description: "Cancel this queued job (refunding its unconsumed escrow) instead of recycling. Setting job_id implies cancel." },
+      { name: "job_id", type: "string", required: false, description: "Act on this queued job instead of recycling. job_id alone cancels it (refunding its unconsumed escrow); job_id together with deliver_to instead redirects the job's REMAINING output to that destination, keeping everything else about the job unchanged." },
       { name: "job_ids", type: "string[]", required: false, description: "Bulk cancel: cancel many queued jobs in one action. Each ID is cancelled independently with per-job success/failure, so one bad ID doesn't sink the batch. Refunds the unconsumed escrow of every cancelled job." },
       { name: "jobs", type: "Record<string, unknown>[]", required: false, description: "Bulk mode: recycle many recipes in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is processed independently (partial success). Max 50." },
       { name: "preset", type: '"fast" | "cheap" | "prefer_own"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) picks the best eligible recycler globally, so a busy own recycler may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) recycler whenever one can run it. Auto-routing otherwise prefers your own recycler, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority). 'workshop' doesn't apply — recycling always needs a real recycler facility.", enumValues: ["fast", "cheap", "prefer_own"] },
@@ -2832,8 +2950,8 @@ var ACTIONS = {
     detailsType: "RefuelResponse",
     params: [
       { name: "id", type: "string", required: false, description: "Specific fuel cell type to use (e.g. fuel_cell, fuel_cell_premium, fuel_cell_military). Auto-selects cheapest if omitted.", positional: 0 },
-      { name: "quantity", type: "number", required: false, description: "Number of fuel cells to burn or units to transfer (default 1). Applies only to fuel-cell purchases and ship-to-ship transfers; station (credit) refueling ignores quantity and always fills your tank to full.", positional: 1 },
-      { name: "target", type: "string", required: false, description: "Player ID or username to transfer fuel to, or 'fleet' for fleet fuel status. Requires a Refueling Pump module for transfers." }
+      { name: "quantity", type: "number", required: false, description: "Number of fuel cells to burn or fuel units to transfer. Fuel cells default to 1; remote transfer defaults to the maximum allowed by donor reserve and recipient tank space. Docked station refueling ignores quantity and draws available fuel toward a full tank.", positional: 1 },
+      { name: "target", type: "string", required: false, description: "Player ID or username at the same real POI to receive fuel, or 'fleet' for read-only fleet fuel status. Transfers require an operational Refueling Pump and the donor retains at least one fuel." }
     ]
   },
   "spacemolt/repair": {
@@ -2843,19 +2961,9 @@ var ACTIONS = {
     summary: "Repair hull — at station (credits), in space (repair kits), or on another ship (repair arm + kits)",
     detailsType: "RepairResponse",
     params: [
-      { name: "item_id", type: "string", required: false, description: "Specific repair item to use (e.g. repair_kit, hull_patch). Auto-selects cheapest if omitted." },
-      { name: "quantity", type: "number", required: false, description: "Number of repair kits to use (default 1). Capped to what's available and what hull needs.", positional: 1 },
-      { name: "target", type: "string", required: false, description: "Player ID or username to repair, or 'fleet' for fleet hull status. Requires a Repair Arm module for ship-to-ship repair." }
-    ]
-  },
-  "spacemolt/repair_module": {
-    tool: "spacemolt",
-    action: "repair_module",
-    kind: "mutation",
-    summary: "Repair wear on a module using a Repair Kit",
-    detailsType: "RepairModuleResponse",
-    params: [
-      { name: "id", type: "string", required: true, description: "Instance ID of the module to repair (must be in cargo, not fitted)", positional: 0 }
+      { name: "id", type: "string", required: false, description: "Specific repair item to use (e.g. repair_kit, hull_patch). Auto-selects cheapest if omitted.", positional: 0 },
+      { name: "quantity", type: "number", required: false, description: "Number of repair kits to use (default 1). Remote repair is limited by available kits and target hull need. Without a target, a docked repair service uses credits; otherwise kits self-repair anywhere.", positional: 1 },
+      { name: "target", type: "string", required: false, description: "Player ID or username to repair at the same real POI, or 'fleet' for read-only fleet hull status. Ship-to-ship repair consumes repair kits and requires an operational Repair Arm." }
     ]
   },
   "spacemolt/scan": {
@@ -2865,7 +2973,7 @@ var ACTIONS = {
     summary: "Scan a target, or sweep the area for cloaked ships when no target is given",
     detailsType: "ScanResponse",
     params: [
-      { name: "id", type: "string", required: false, description: "ID/username of the player or NPC to scan. Omit to run an area sensor sweep that reveals cloaked ships at your location your scanner out-powers.", positional: 0 }
+      { name: "id", type: "string", required: false, description: "Player ID/username, NPC ID/name, wildlife creature ID, or intact-prize actor ID to scan. Prize actor IDs come from get_nearby. Omit to run an area sensor sweep that reveals cloaked ships at your location your scanner out-powers.", positional: 0 }
     ]
   },
   "spacemolt/search_systems": {
@@ -2923,7 +3031,7 @@ var ACTIONS = {
     summary: "Travel to a different Point of Interest (POI) within your current system",
     detailsType: "TravelResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "UUID of the POI to travel to (use get_system to see available POIs)", positional: 0 }
+      { name: "id", type: "string", required: true, description: "POI ID to travel to (use get_system to see available POIs). For a station, either its POI ID or Base ID is accepted.", positional: 0 }
     ]
   },
   "spacemolt/undock": {
@@ -3020,7 +3128,7 @@ function buildCommands(dispatch) {
       get_player: bindBare("spacemolt", "get_player"),
       get_poi: bindBare("spacemolt", "get_poi"),
       get_queue: bindBare("spacemolt", "get_queue"),
-      get_ship: bindBare("spacemolt", "get_ship"),
+      get_ship: bind("spacemolt", "get_ship"),
       get_skills: bindBare("spacemolt", "get_skills"),
       get_state: bindBare("spacemolt", "get_state"),
       get_status: bindBare("spacemolt", "get_status"),
@@ -3037,11 +3145,11 @@ function buildCommands(dispatch) {
       list_station_passengers: bindBare("spacemolt", "list_station_passengers"),
       load_passenger: bind("spacemolt", "load_passenger"),
       mine: bindBare("spacemolt", "mine"),
+      pay_bounty: bind("spacemolt", "pay_bounty"),
       prepay_tax: bind("spacemolt", "prepay_tax"),
       recycle: bind("spacemolt", "recycle"),
       refuel: bind("spacemolt", "refuel"),
       repair: bind("spacemolt", "repair"),
-      repair_module: bind("spacemolt", "repair_module"),
       scan: bind("spacemolt", "scan"),
       search_systems: bind("spacemolt", "search_systems"),
       self_destruct: bindBare("spacemolt", "self_destruct"),
@@ -3071,6 +3179,7 @@ function buildCommands(dispatch) {
       log: bind("spacemolt_battle", "log"),
       reload: bind("spacemolt_battle", "reload"),
       retreat: bindBare("spacemolt_battle", "retreat"),
+      self_destruct: bindBare("spacemolt_battle", "self_destruct"),
       stance: bind("spacemolt_battle", "stance"),
       status: bindBare("spacemolt_battle", "status"),
       summary: bind("spacemolt_battle", "summary"),
@@ -3223,6 +3332,7 @@ function buildCommands(dispatch) {
       view_orders: bind("spacemolt_market", "view_orders")
     },
     spacemolt_salvage: {
+      claim_prize: bind("spacemolt_salvage", "claim_prize"),
       insure: bindBare("spacemolt_salvage", "insure"),
       loot: bind("spacemolt_salvage", "loot"),
       policies: bindBare("spacemolt_salvage", "policies"),
@@ -3230,6 +3340,7 @@ function buildCommands(dispatch) {
       release: bindBare("spacemolt_salvage", "release"),
       scrap: bindBare("spacemolt_salvage", "scrap"),
       sell: bindBare("spacemolt_salvage", "sell"),
+      service_prize: bind("spacemolt_salvage", "service_prize"),
       set_home: bind("spacemolt_salvage", "set_home"),
       tow: bind("spacemolt_salvage", "tow"),
       wrecks: bindBare("spacemolt_salvage", "wrecks")
@@ -3243,19 +3354,24 @@ function buildCommands(dispatch) {
       commission_quote: bind("spacemolt_ship", "commission_quote"),
       commission_ship: bind("spacemolt_ship", "commission_ship"),
       commission_status: bind("spacemolt_ship", "commission_status"),
+      faction_personnel: bind("spacemolt_ship", "faction_personnel"),
       list_ship_for_sale: bind("spacemolt_ship", "list_ship_for_sale"),
       list_ships: bindBare("spacemolt_ship", "list_ships"),
       place_ship_buy_order: bind("spacemolt_ship", "place_ship_buy_order"),
+      recruit_personnel: bind("spacemolt_ship", "recruit_personnel"),
       refit_ship: bindBare("spacemolt_ship", "refit_ship"),
       rename_ship: bind("spacemolt_ship", "rename_ship"),
       scrap_ship: bind("spacemolt_ship", "scrap_ship"),
       sell_ship_to_order: bind("spacemolt_ship", "sell_ship_to_order"),
       supply_commission: bind("spacemolt_ship", "supply_commission"),
       switch_ship: bind("spacemolt_ship", "switch_ship"),
+      transfer_personnel: bind("spacemolt_ship", "transfer_personnel"),
+      treat_personnel: bind("spacemolt_ship", "treat_personnel"),
       view_ship_buy_orders: bindBare("spacemolt_ship", "view_ship_buy_orders")
     },
     spacemolt_shipping: {
       accept: bind("spacemolt_shipping", "accept"),
+      active: bindBare("spacemolt_shipping", "active"),
       cancel: bind("spacemolt_shipping", "cancel"),
       deliver: bind("spacemolt_shipping", "deliver"),
       get: bind("spacemolt_shipping", "get"),
@@ -3722,6 +3838,9 @@ class StateCache {
   get skills() {
     return this.state.skills;
   }
+  get prizeRecoveries() {
+    return this.state.prize_recoveries;
+  }
   get hasPendingAction() {
     return this.state.queue?.has_pending ?? false;
   }
@@ -3951,6 +4070,40 @@ class Socket {
 
 // src/account.ts
 var TRANSIT_ACTIONS = new Set(["spacemolt/jump", "spacemolt/travel"]);
+var ARRIVED = {
+  docked_at: null,
+  in_transit: false,
+  transit_type: undefined,
+  transit_arrival_tick: undefined,
+  transit_dest_system_id: undefined,
+  transit_dest_system_name: undefined,
+  transit_dest_poi_id: undefined,
+  transit_dest_poi_name: undefined,
+  transit_bearing: undefined,
+  transit_x: undefined,
+  transit_y: undefined,
+  transit_ticks_elapsed: undefined,
+  void_message: undefined,
+  poi_name: undefined,
+  poi_type: undefined,
+  resources: undefined,
+  nearby_players: undefined,
+  nearby_player_count: undefined,
+  nearby_prizes: undefined,
+  nearby_prize_count: undefined,
+  nearby_pirates: undefined,
+  nearby_pirate_count: undefined,
+  nearby_empire_npcs: undefined,
+  nearby_empire_npc_count: undefined,
+  offline_collapsed: undefined,
+  unknown_signature: undefined
+};
+var ARRIVED_IN_NEW_SYSTEM = {
+  ...ARRIVED,
+  connections: undefined,
+  empire: undefined,
+  security_status: undefined
+};
 var DEFAULT_URL = "wss://game.spacemolt.com/ws/v2";
 var DEFAULT_CONNECT_TIMEOUT_MS = 15000;
 var DEFAULT_MUTATION_TIMEOUT_MS = 600000;
@@ -4078,6 +4231,9 @@ class Account {
   get skills() {
     return this.cache.skills;
   }
+  get prizeRecoveries() {
+    return this.cache.prizeRecoveries;
+  }
   get credits() {
     return this.cache.credits;
   }
@@ -4335,7 +4491,16 @@ class Account {
     const view = this.observationCache.current();
     if (!view)
       return;
-    const nearbyPlayers = [...view.nearby.values()];
+    const nearbyPlayers = [...view.nearby.entries()].map(([playerId, p]) => ({
+      player_id: playerId,
+      in_combat: p.in_combat ?? false,
+      ...p.clan_tag !== undefined && { clan_tag: p.clan_tag },
+      ...p.faction_tag !== undefined && { faction_tag: p.faction_tag },
+      ...p.offline !== undefined && { offline: p.offline },
+      ...p.ship_class !== undefined && { ship_class: p.ship_class },
+      ...p.ship_name !== undefined && { ship_name: p.ship_name },
+      ...p.username !== undefined && { username: p.username }
+    }));
     const changed = this.cache.patchSection("location", {
       nearby_players: nearbyPlayers,
       nearby_player_count: view.nearby.size
@@ -4366,27 +4531,17 @@ class Account {
     const payload = frame.payload;
     let changed = [];
     let reconcile = false;
-    const currentLocation = this.cache.location;
-    const currentSystem = {
-      connections: currentLocation?.connections,
-      empire: currentLocation?.empire,
-      security_status: currentLocation?.security_status,
-      system_id: currentLocation?.system_id,
-      system_name: currentLocation?.system_name
-    };
     switch (payload.action) {
       case "fleet_jump": {
         if (typeof payload.destination !== "string" || typeof payload.arrival_tick !== "number") {
           this.warnMalformedFrame(frame);
           return;
         }
-        changed = this.cache.applyDelta({
-          location: {
-            in_transit: true,
-            transit_arrival_tick: payload.arrival_tick,
-            transit_dest_system_id: payload.destination,
-            transit_type: "jump"
-          }
+        changed = this.cache.patchSection("location", {
+          in_transit: true,
+          transit_arrival_tick: payload.arrival_tick,
+          transit_dest_system_id: payload.destination,
+          transit_type: "jump"
         });
         reconcile = true;
         break;
@@ -4397,13 +4552,11 @@ class Account {
           this.warnMalformedFrame(frame);
           return;
         }
-        changed = this.cache.applyDelta({
-          location: {
-            in_transit: false,
-            poi_id: typeof payload.poi === "string" ? payload.poi : undefined,
-            system_id: payload.system_id,
-            system_name: payload.system
-          }
+        changed = this.cache.patchSection("location", {
+          ...ARRIVED_IN_NEW_SYSTEM,
+          poi_id: typeof payload.poi === "string" ? payload.poi : undefined,
+          system_id: payload.system_id,
+          system_name: payload.system
         });
         reconcile = true;
         break;
@@ -4413,14 +4566,11 @@ class Account {
           this.warnMalformedFrame(frame);
           return;
         }
-        changed = this.cache.applyDelta({
-          location: {
-            ...currentSystem,
-            in_transit: true,
-            transit_arrival_tick: payload.arrival_tick,
-            transit_dest_poi_id: payload.destination,
-            transit_type: "travel"
-          }
+        changed = this.cache.patchSection("location", {
+          in_transit: true,
+          transit_arrival_tick: payload.arrival_tick,
+          transit_dest_poi_id: payload.destination,
+          transit_type: "travel"
         });
         reconcile = true;
         break;
@@ -4430,19 +4580,16 @@ class Account {
           this.warnMalformedFrame(frame);
           return;
         }
-        changed = this.cache.applyDelta({
-          location: {
-            ...currentSystem,
-            in_transit: false,
-            poi_id: payload.poi_id,
-            poi_name: payload.poi
-          }
+        changed = this.cache.patchSection("location", {
+          ...ARRIVED,
+          poi_id: payload.poi_id,
+          poi_name: payload.poi
         });
         reconcile = true;
         break;
       }
       case "fleet_undock":
-        changed = currentLocation ? this.cache.patchSection("location", { docked_at: undefined }) : this.cache.applyDelta({ location: {} });
+        changed = this.cache.patchSection("location", { docked_at: null });
         break;
       case "fleet_dock":
         reconcile = true;
@@ -4759,12 +4906,16 @@ function catalogEntries(value) {
 function normalizeCatalog(value) {
   const data = requireRecord(value, "catalog response");
   return {
-    version: typeof data.version === "string" ? data.version : undefined,
+    version: typeof data.version === "string" ? data.version : "",
     ships: catalogEntries(data.ships),
     items: catalogEntries(data.items),
     recipes: catalogEntries(data.recipes),
     skills: catalogEntries(data.skills),
-    facilities: catalogEntries(data.facilities)
+    facilities: catalogEntries(data.facilities),
+    achievements: catalogEntries(data.achievements),
+    faction_achievements: catalogEntries(data.faction_achievements),
+    hidden_achievement_count: typeof data.hidden_achievement_count === "number" ? data.hidden_achievement_count : 0,
+    hidden_faction_achievement_count: typeof data.hidden_faction_achievement_count === "number" ? data.hidden_faction_achievement_count : 0
   };
 }
 async function fetchCatalogConditional(httpBaseUrl, etag) {
@@ -4799,6 +4950,7 @@ class CatalogCache {
   recipesById;
   skillsById;
   facilitiesById;
+  achievementsById;
   constructor(catalog, etag) {
     this.catalog = catalog;
     this.etag = etag;
@@ -4807,6 +4959,7 @@ class CatalogCache {
     this.recipesById = index(catalog.recipes);
     this.skillsById = index(catalog.skills);
     this.facilitiesById = index(catalog.facilities);
+    this.achievementsById = index([...catalog.achievements, ...catalog.faction_achievements]);
   }
   static async load(httpBaseUrl) {
     const { catalog, etag } = await fetchCatalogConditional(httpBaseUrl);
@@ -4840,6 +4993,9 @@ class CatalogCache {
   facility(id) {
     return this.facilitiesById.get(id);
   }
+  achievement(id) {
+    return this.achievementsById.get(id);
+  }
   get ships() {
     return this.catalog.ships;
   }
@@ -4855,6 +5011,18 @@ class CatalogCache {
   get facilities() {
     return this.catalog.facilities;
   }
+  get achievements() {
+    return this.catalog.achievements;
+  }
+  get factionAchievements() {
+    return this.catalog.faction_achievements;
+  }
+  get hiddenAchievementCount() {
+    return this.catalog.hidden_achievement_count;
+  }
+  get hiddenFactionAchievementCount() {
+    return this.catalog.hidden_faction_achievement_count;
+  }
 }
 function index(entries) {
   const map = new Map;
@@ -5218,9 +5386,22 @@ async function fetchStations(httpBaseUrl) {
   const empires = Array.isArray(data.empires) ? data.empires.filter((empire) => isRecord(empire) && typeof empire.id === "string" && typeof empire.name === "string") : [];
   return { stations, empires };
 }
+// src/data/mobile-base.ts
+async function fetchMobileBase(httpBaseUrl) {
+  const url = `${httpBaseUrl.replace(/\/$/, "")}/wheres-mobile-base`;
+  const res = await fetch(url, { headers: { accept: "application/json" } });
+  if (!res.ok)
+    throw new Error(`GET ${url} -> ${res.status} ${res.statusText}`);
+  const data = requireRecord(await res.json(), "mobile base response");
+  if (typeof data.system !== "string")
+    throw new Error("mobile base response is missing a system id");
+  return { system: data.system };
+}
 // src/generated/notifications.gen.ts
 var TYPED_NOTIFICATION_TYPES = [
   "achievement_unlocked",
+  "action_error",
+  "action_result",
   "base_destroyed",
   "base_raid_update",
   "battle_alert",
@@ -5232,23 +5413,34 @@ var TYPED_NOTIFICATION_TYPES = [
   "battle_update",
   "chat_message",
   "crafting_update",
+  "drone_adrift",
   "drone_destroyed",
   "drone_scan",
   "drone_survey",
   "drone_update",
   "facility_reclaimed",
   "facility_rent_warning",
+  "faction_alliance_broken",
+  "faction_alliance_formed",
+  "faction_alliance_proposal",
+  "faction_peace_accepted",
+  "faction_peace_proposal",
+  "faction_war_declared",
   "market_update",
   "mining_yield",
   "observation_update",
+  "personnel_update",
   "pilotless_ship",
   "pirate_destroyed",
   "pirate_radio",
   "player_died",
   "player_kill",
+  "prize_update",
   "ranch_poached",
   "reconnected",
   "scan_detected",
+  "server_restart_warning",
+  "ship_captured",
   "ship_commission_complete",
   "skill_level_up",
   "station_repaired",
@@ -5281,6 +5473,7 @@ export {
   fetchCatalog,
   fetchCatalogConditional,
   fetchMap,
+  fetchMobileBase,
   fetchStations,
   httpBaseFromWs,
   isActionErrorFrame,