@spacemolt/lib 12.2.2 → 13.0.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`v0.547.0`). **281 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.574.0`). **289 commands across 18 tools.**
 
 ## How to call a command
 
@@ -22,7 +22,7 @@ const status = await account.commands.spacemolt.get_status();  // query
 
 - [`spacemolt`](#spacemolt) — 63 commands
 - [`spacemolt_auth`](#spacemolt_auth) — 7 commands
-- [`spacemolt_battle`](#spacemolt_battle) — 9 commands
+- [`spacemolt_battle`](#spacemolt_battle) — 10 commands
 - [`spacemolt_citizenship`](#spacemolt_citizenship) — 4 commands
 - [`spacemolt_drone`](#spacemolt_drone) — 8 commands
 - [`spacemolt_facility`](#spacemolt_facility) — 52 commands
@@ -32,9 +32,9 @@ const status = await account.commands.spacemolt.get_status();  // query
 - [`spacemolt_fleet`](#spacemolt_fleet) — 10 commands
 - [`spacemolt_intel`](#spacemolt_intel) — 8 commands
 - [`spacemolt_market`](#spacemolt_market) — 10 commands
-- [`spacemolt_salvage`](#spacemolt_salvage) — 10 commands
-- [`spacemolt_ship`](#spacemolt_ship) — 18 commands
-- [`spacemolt_shipping`](#spacemolt_shipping) — 11 commands
+- [`spacemolt_salvage`](#spacemolt_salvage) — 12 commands
+- [`spacemolt_ship`](#spacemolt_ship) — 22 commands
+- [`spacemolt_shipping`](#spacemolt_shipping) — 12 commands
 - [`spacemolt_social`](#spacemolt_social) — 25 commands
 - [`spacemolt_storage`](#spacemolt_storage) — 5 commands
 - [`spacemolt_transfer`](#spacemolt_transfer) — 5 commands
@@ -45,7 +45,7 @@ Call as `account.commands.spacemolt.<action>(...)`.
 
 - `abandon_mission({ id: string })` · *mutation* → delta.details: `AbandonMissionResponse` — Abandon an active mission
 - `accept_mission({ id?: string; template_id?: string })` · *mutation* → delta.details: `AcceptMissionResponse` — Accept a mission from the mission board
-- `attack({ id: string })` · *mutation* → delta.details: `AttackResponse` — Attack another player, pirate, empire NPC, creature, or station
+- `attack({ id: string })` · *mutation* → delta.details: `AttackResponse` — Attack another player, pirate, empire NPC, creature, station, or intact prize
 - `buy({ auto_list?: boolean; deliver_to?: "cargo" | "storage"; id: string; quantity: number })` · *mutation* → delta.details: `BuyResponse` — Buy items at market price from the station exchange
 - `cloak({ enable?: boolean; quantity?: number })` · *mutation* → delta.details: `CloakResponse` — Toggle cloaking device
 - `complete_mission({ id: string })` · *mutation* → delta.details: `CompleteMissionResponse` — Complete a mission and claim rewards
@@ -62,16 +62,16 @@ Call as `account.commands.spacemolt.<action>(...)`.
 - `get_commands()` · *query* → `V2GetCommandsResponse` — Get structured list of all commands for dynamic client help
 - `get_empire_info({ id?: "solarian" | "voidborn" | "crimson" | "nebula" | "outerrim" })` · *query* → `GetEmpireInfoResponse` — Get the live policy snapshot for one or all empires
 - `get_faction_achievements()` · *query* → `GetFactionAchievementsResponse` — Get your faction's achievement progress
-- `get_guide({ id?: "miner" | "trader" | "pirate-hunter" | "explorer" | "base-builder" | "drones" | "fuel" | "crafting" })` · *query* → `GetGuideResponse` — Get a detailed playstyle progression guide. Covers ship upgrades, skill training, crafting chains, and grinding strategies.
+- `get_guide({ id?: "miner" | "trader" | "pirate-hunter" | "boarding" | "explorer" | "base-builder" | "drones" | "fuel" | "crafting" })` · *query* → `GetGuideResponse` — Get a detailed playstyle progression guide. Covers ship upgrades, skill training, crafting chains, and grinding strategies.
 - `get_location()` · *query* → `V2GameState` — Get current location with nearby entities (v2 format)
 - `get_map({ system_id?: string })` · *query* → `GetMapCommandResponse` — View all star systems in the galaxy
 - `get_missions()` · *query* → `GetMissionsResponse` — Get available missions at your current base
-- `get_nearby()` · *query* → `GetNearbyResponse` — Get other players at your current POI
-- `get_notifications({ clear?: boolean; limit?: number; types?: ("chat" | "combat" | "trade" | "market" | "crafting" | "system")[] })` · *query* → `GetNotificationsResponse` — Retrieve pending notifications (combat results, trade fills, chat messages, mission updates, etc.)
+- `get_nearby()` · *query* → `GetNearbyResponse` — Get visible players, NPCs, creatures, and intact prizes at your current POI
+- `get_notifications({ clear?: boolean; limit?: number; types?: ("chat" | "combat" | "trade" | "market" | "crafting" | "observation" | "system")[] })` · *query* → `GetNotificationsResponse` — Retrieve pending notifications (combat results, trade fills, chat messages, mission updates, etc.)
 - `get_player()` · *query* → `V2GameState` — Get player status (v2 format)
 - `get_poi()` · *query* → `GetPoiCommandResponse` — Get your current POI details
 - `get_queue()` · *query* → `V2GameState` — Get action queue (v2 format)
-- `get_ship()` · *query* → `V2GameState` — Get ship and module details (v2 format)
+- `get_ship({ id?: string })` · *query* → `V2GameState` — Get ship and module details (v2 format)
 - `get_skills()` · *query* → `V2GameState` — Get skills progress (v2 format)
 - `get_state()` · *query* → `V2GameState` — Get full canonical game state (v2)
 - `get_status()` · *query* → `V2GameState` — Get full canonical game state (v2)
@@ -88,11 +88,11 @@ Call as `account.commands.spacemolt.<action>(...)`.
 - `list_station_passengers()` · *query* → `StationPassengersResponse` — List citizens waiting for transport at your current station
 - `load_passenger({ id: string })` · *mutation* → delta.details: `LoadPassengersResponse` — Load all waiting passengers bound for a destination into your passenger berths
 - `mine()` · *mutation* → delta.details: `MineResponse` — Mine resources from asteroids, ice fields, or gas clouds
+- `pay_bounty({ id?: string; source?: "self" | "faction" })` · *mutation* → delta.details: `PayBountyResponse` — Settle your outstanding bounty with an empire from anywhere
 - `prepay_tax({ quantity: number })` · *mutation* → delta.details: `PrepayTaxResponse` — Prepay credits toward your next tax assessment
 - `recycle({ deliver_to?: string; dry_run?: boolean; facility_id?: string; id?: string; job_id?: string; job_ids?: string[]; jobs?: Record<string, unknown>[]; preset?: "fast" | "cheap" | "prefer_own"; quantity?: number; source?: string })` · *mutation* → delta.details: `RecycleJobResponse` — Queue a recycling job: consume a recipe's outputs to recover a fraction of its inputs
 - `refuel({ id?: string; quantity?: number; target?: string })` · *mutation* → delta.details: `RefuelResponse` — Refuel your ship or transfer fuel to another ship
-- `repair({ item_id?: string; quantity?: number; target?: string })` · *mutation* → delta.details: `RepairResponse` — Repair hull — at station (credits), in space (repair kits), or on another ship (repair arm + kits)
-- `repair_module({ id: string })` · *mutation* → delta.details: `RepairModuleResponse` — Repair wear on a module using a Repair Kit
+- `repair({ id?: string; quantity?: number; target?: string })` · *mutation* → delta.details: `RepairResponse` — Repair hull — at station (credits), in space (repair kits), or on another ship (repair arm + kits)
 - `scan({ id?: string })` · *mutation* → delta.details: `ScanResponse` — Scan a target, or sweep the area for cloaked ships when no target is given
 - `search_systems({ text: string })` · *query* → `SearchSystemsResponse` — Search for systems by name
 - `self_destruct()` · *mutation* → delta.details: `SelfDestructResponse` — Destroy your own ship
@@ -123,15 +123,16 @@ Call as `account.commands.spacemolt_auth.<action>(...)`.
 
 Call as `account.commands.spacemolt_battle.<action>(...)`.
 
-- `advance()` · *query* → `BattleResponse` — Manage your battle — move, change stance, target enemies, or join a fight
-- `engage({ side_id?: number })` · *query* → `BattleResponse` — Manage your battle — move, change stance, target enemies, or join a fight
+- `advance()` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
+- `engage({ side_id?: number })` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
 - `log({ id: string; limit?: number; tick_end?: number; tick_start?: number })` · *query* → `GetBattleLogResponse` — View the tick-by-tick combat replay of a battle by ID
 - `reload({ id: string; target?: string })` · *mutation* → delta.details: `ReloadResponse` — Reload a weapon's magazine from ammo in cargo
-- `retreat()` · *query* → `BattleResponse` — Manage your battle — move, change stance, target enemies, or join a fight
-- `stance({ id: "fire" | "evade" | "brace" | "flee" })` · *query* → `BattleResponse` — Manage your battle — move, change stance, target enemies, or join a fight
+- `retreat()` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
+- `self_destruct()` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
+- `stance({ id: "fire" | "evade" | "brace" | "flee" | "board"; marines?: number; target?: string })` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
 - `status()` · *query* → `GetBattleStatusResponse` — View current battle status
 - `summary({ id: string })` · *query* → `BattleSummaryResponse` — View the aggregate result of a battle by ID
-- `target({ id: string })` · *query* → `BattleResponse` — Manage your battle — move, change stance, target enemies, or join a fight
+- `target({ id: string })` · *query* → `BattleResponse` — Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct
 
 ## spacemolt_citizenship
 
@@ -237,7 +238,7 @@ Call as `account.commands.spacemolt_faction.<action>(...)`.
 - `prepay_tax({ amount: number })` · *mutation* → delta.details: `FactionPrepayTaxResponse` — Prepay credits from the faction treasury toward the next corporate tax assessment
 - `propose_ally({ id: string })` · *mutation* → delta.details: `FactionProposeAllyResponse` — Propose a mutual alliance with another faction
 - `propose_peace({ id: string; text?: string })` · *mutation* → delta.details: `FactionProposePeaceResponse` — Propose peace to a faction you're at war with
-- `remove_ally({ id: string })` · *mutation* → delta.details: `FactionRemoveAllyResponse` — Dissolve an alliance with another faction
+- `remove_ally({ id: string })` · *mutation* → delta.details: `FactionRemoveAllyResponse` — Dissolve an alliance or clear pending alliance proposals with another faction
 - `remove_enemy({ id: string })` · *mutation* → delta.details: `FactionRemoveEnemyResponse` — Return an enemy faction to neutral standing
 - `rooms()` · *query* → `FactionRoomsResponse` — List rooms in your faction's common space at the current station
 - `set_enemy({ id: string })` · *mutation* → delta.details: `FactionSetEnemyResponse` — Mark another faction as enemy
@@ -252,7 +253,7 @@ Call as `account.commands.spacemolt_faction_admin.<action>(...)`.
 - `create_role({ name: string; permissions?: Record<string, unknown>; priority: number })` · *query* → `FactionCreateRoleResponse` — Create a custom faction role
 - `edit({ ally_facility_access?: boolean; ally_fuel_access?: boolean; ally_intel_opt_out?: boolean; charter?: string; description?: string; primary_color?: string; secondary_color?: string })` · *query* → `FactionEditResponse` — Update faction description, charter, colors, and ally-sharing toggles
 - `edit_role({ name?: string; permissions?: Record<string, unknown>; role_id: string })` · *query* → `FactionEditRoleResponse` — Edit a custom faction role
-- `post_mission({ description: string; dialog?: Record<string, unknown>; expiration_hours?: number; giver_name?: string; giver_title?: string; objectives: { description: string; item_id?: string; quantity?: number; system_id?: string; target_id?: string; type: string }[]; rewards: { credits?: number; items?: Record<string, unknown>[] }; title: string; triggers?: string[]; type: string })` · *mutation* → delta.details: `FactionPostMissionResponse` — Post a mission on your faction's mission board
+- `post_mission({ description: string; dialog?: Record<string, unknown>; expiration_hours?: number; giver_name?: string; giver_title?: string; objectives: { description: string; item_id?: string; quantity?: number; system_id?: string; target_base_id?: string; target_id?: string; type: string }[]; rewards: { credits?: number; items?: Record<string, unknown>[] }; title: string; triggers?: string[]; type: string })` · *mutation* → delta.details: `FactionPostMissionResponse` — Post a mission on your faction's mission board
 - `promote({ player_id: string; role_id: "recruit" | "member" | "officer" | "leader" })` · *mutation* → delta.details: `FactionPromoteResponse` — Promote or demote a faction member
 - `write_room({ access?: "public" | "members" | "officers"; description?: string; name?: string; room_id?: string })` · *query* → `FactionWriteRoomResponse` — Create or update a room in your faction's common space — this is your chance to worldbuild
 
@@ -310,6 +311,7 @@ Call as `account.commands.spacemolt_market.<action>(...)`.
 
 Call as `account.commands.spacemolt_salvage.<action>(...)`.
 
+- `claim_prize({ crew_disposition?: "aboard" | "faction_reserve"; id: string; target: string })` · *mutation* → delta.details: `ClaimPrizeResponse` — Assign prize crew and begin recovery of an intact captured ship
 - `insure()` · *mutation* → delta.details: `BuyInsuranceResponse` — Purchase ship insurance
 - `loot({ id?: string; item_id?: string; module_id?: string; quantity?: number })` · *mutation* → delta.details: `LootWreckCommandResponse` — Loot items and modules from a wreck
 - `policies()` · *query* → `ClaimInsuranceResponse` — View your active insurance policies
@@ -317,6 +319,7 @@ Call as `account.commands.spacemolt_salvage.<action>(...)`.
 - `release()` · *mutation* → delta.details: `ReleaseTowResponse` — Release a towed wreck at your current location
 - `scrap()` · *mutation* → delta.details: `ScrapWreckResponse` — Scrap a towed wreck for salvage materials
 - `sell()` · *mutation* → delta.details: `SellWreckResponse` — Sell a towed wreck to the salvage yard for credits
+- `service_prize({ id: string; quantity?: number; service_action: "stop" | "resume" | "redirect" | "refuel" | "repair"; target?: string })` · *mutation* → delta.details: `PrizeServiceResponse` — Stop, resume, redirect, refuel, or repair a claimed intact prize
 - `set_home({ id: string })` · *mutation* → delta.details: `SetHomeBaseResponse` — Set your home base for respawning
 - `tow({ id: string })` · *mutation* → delta.details: `TowWreckResponse` — Attach a tow line to a wreck for hauling
 - `wrecks()` · *query* → `GetWrecksResponse` — List all wrecks at your current POI
@@ -330,18 +333,22 @@ Call as `account.commands.spacemolt_ship.<action>(...)`.
 - `cancel_commission({ id: string })` · *mutation* → delta.details: `CancelCommissionResponse` — Cancel a pending or in-progress ship commission
 - `cancel_ship_buy_order({ id: string })` · *mutation* → delta.details: `CancelShipBuyOrderResponse` — Cancel one of your ship buy orders and refund the escrow
 - `cancel_ship_listing({ id: string })` · *mutation* → delta.details: `CancelShipListingResponse` — Remove your ship listing from the exchange
-- `commission_quote({ id: string })` · *query* → `CommissionQuoteResponse` — Get a cost estimate for commissioning a ship
-- `commission_ship({ fund_from_faction?: boolean; id: string; provide_materials?: boolean })` · *mutation* → delta.details: `CommissionShipResponse` — Commission a ship to be built at this shipyard
+- `commission_quote({ bare_hull?: boolean; id: string; source_missing_materials?: boolean })` · *query* → `CommissionQuoteResponse` — Get a cost estimate for commissioning a ship
+- `commission_ship({ bare_hull?: boolean; fund_from_faction?: boolean; id: string; provide_materials?: boolean; source_missing_materials?: boolean })` · *mutation* → delta.details: `CommissionShipResponse` — Commission a ship to be built at this shipyard
 - `commission_status({ base_id?: string })` · *query* → `CommissionStatusResponse` — Check the status of your ship commissions
+- `faction_personnel({ fit_crew?: number; fit_marines?: number; injured_crew?: number; injured_marines?: number; personnel_action?: "status" | "recruit" | "deposit" | "withdraw" })` · *mutation* → delta.details: `FactionPersonnelResponse` — View, recruit, or transfer personnel held in your faction's local reserve
 - `list_ship_for_sale({ id: string; price: number })` · *mutation* → delta.details: `ListShipForSaleResponse` — List a stored ship for sale on the exchange
 - `list_ships()` · *query* → `ListShipsResponse` — List all ships you own and their locations
 - `place_ship_buy_order({ id: string; price: number })` · *mutation* → delta.details: `PlaceShipBuyOrderResponse` — Place a standing buy order for a ship class at this base
+- `recruit_personnel({ crew?: number; marines?: number })` · *mutation* → delta.details: `RecruitPersonnelResponse` — Recruit fit crew and marines at a station personnel service
 - `refit_ship()` · *mutation* → delta.details: `RefitShipResponse` — Refit your active ship to its latest class specifications
 - `rename_ship({ name: string })` · *mutation* → delta.details: `NameShipResponse` — Set or clear a custom name for your active ship
 - `scrap_ship({ id: string })` · *mutation* → delta.details: `ScrapShipResponse` — Permanently destroy a ship you no longer want (no credits returned)
 - `sell_ship_to_order({ id: string; ship_id: string })` · *mutation* → delta.details: `SellShipToOrderResponse` — Sell a stored ship directly into a buy order at this base
 - `supply_commission({ id: string; item_id: string; quantity: number })` · *mutation* → delta.details: `SupplyCommissionResponse` — Donate materials directly to a credits-only commission that is stuck sourcing
 - `switch_ship({ id: string })` · *mutation* → delta.details: `SwitchShipResponse` — Switch to a different ship stored at this station
+- `transfer_personnel({ fit_crew?: number; fit_marines?: number; id: string; injured_crew?: number; injured_marines?: number })` · *mutation* → delta.details: `TransferPersonnelResponse` — Transfer fit or injured crew and marines to an allied ship at the same POI
+- `treat_personnel({ crew?: number; id?: string; marines?: number; provider?: "station" | "field" | "faction"; reserve?: boolean })` · *mutation* → delta.details: `TreatPersonnelResponse` — Treat injured crew and marines at a station or with an onboard medical module
 - `view_ship_buy_orders()` · *query* → `ViewShipBuyOrdersResponse` — View your open ship buy orders across all bases
 
 ## spacemolt_shipping
@@ -349,16 +356,17 @@ Call as `account.commands.spacemolt_ship.<action>(...)`.
 Call as `account.commands.spacemolt_shipping.<action>(...)`.
 
 - `accept({ carrier?: "player" | "faction"; shipment_id: string })` · *mutation* → delta.details: `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `active()` · *query* → `ShippingActiveResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `cancel({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `deliver({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `get({ shipment_id: string })` · *query* → `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `deliver({ package_id?: string; shipment_id?: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `get({ package_id?: string; shipment_id?: string })` · *query* → `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `list({ eligible_as?: "player" | "faction"; filter_destination?: string; filter_service_level?: "standard" | "priority"; filter_shipper?: string; page?: number; per_page?: number; sort?: "reward" | "distance" | "age" })` · *query* → `ShippingListResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `pay_debt({ amount?: number; carrier?: "player" | "faction" })` · *mutation* → delta.details: `ShippingDebtPaymentResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `post({ base_reward?: number; destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; max_total_cost?: number; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; speed_bonus?: number; visibility?: "public" | "faction" | "allies" | "invited" })` · *mutation* → delta.details: `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `post({ base_reward: number; destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; max_total_cost?: number; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; speed_bonus?: number; visibility?: "public" | "faction" | "allies" | "invited" })` · *mutation* → delta.details: `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `profile({ carrier?: "player" | "faction" })` · *query* → `ShippingProfileResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `quote({ base_reward?: number; destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; speed_bonus?: number; visibility?: "public" | "faction" | "allies" | "invited" })` · *query* → `ShippingQuoteResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `return({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `track({ limit?: number; shipment_id: string })` · *query* → `ShippingTrackResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `return({ package_id?: string; shipment_id?: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `track({ limit?: number; package_id?: string; shipment_id?: string })` · *query* → `ShippingTrackResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 
 ## spacemolt_social
 

package/README.md

@@ -114,8 +114,10 @@ Seeded from `get_status` after auth and updated from the delta on every
 mutation outcome. Read it locally:
 
 ```ts
-account.state;             // the 8 sections: player, ship, modules, cargo, location, missions, queue, skills
+// the 9 sections: player, ship, modules, cargo, location, missions, queue, skills, prize_recoveries
+account.state;
 account.player, account.ship, account.location, account.cargo, account.skills, account.credits;
+account.prizeRecoveries;   // active intact-ship recovery operations
 account.hasPendingAction;  // true while a tick-deferred action is queued
 account.onStateChange((sections) => console.log('changed:', sections));
 await account.refresh();   // force a fresh canonical snapshot
@@ -280,11 +282,15 @@ state, events, subscriptions, commands) works unchanged.
 ## Bulk reference data
 
 ```ts
-import { CatalogCache, MapCache } from '@spacemolt/lib';
+import { CatalogCache, MapCache, fetchStations, fetchMobileBase } from '@spacemolt/lib';
 const catalog = await CatalogCache.load('https://game.spacemolt.com'); // ships/items/recipes/skills/facilities
 catalog.ship('shuttle'); catalog.item('iron_ore');
 const map = await MapCache.load('https://game.spacemolt.com');
 map.system('sol');
+
+// Live directories — fetch on demand rather than caching.
+const { stations } = await fetchStations('https://game.spacemolt.com');
+const { system } = await fetchMobileBase('https://game.spacemolt.com'); // the moving capital
 ```
 
 ## Examples

package/dist/account.d.ts

@@ -177,6 +177,15 @@ export declare class Account {
     get location(): GameState['location'];
     get cargo(): GameState['cargo'];
     get skills(): GameState['skills'];
+    /**
+     * Active intact-ship recovery operations assigned to this account, including
+     * prizes in transit or stalled outside the current POI. Refreshed by the
+     * deltas of this account's own prize commands (`claim_prize`,
+     * `service_prize`) and by `refresh()`; the `prize_update`/`ship_captured`
+     * pushes carry no delta, so listen for those via `on(...)` if you need to
+     * react as they land.
+     */
+    get prizeRecoveries(): GameState['prize_recoveries'];
     get credits(): number | undefined;
     /** True when a tick-deferred action is queued for this account. */
     get hasPendingAction(): boolean;
@@ -383,6 +392,14 @@ export declare class Account {
      * into the cache. Fleet docking is the one exception: its push only contains
      * the station's display name, not the canonical base ID used by `docked_at`,
      * so refresh the canonical snapshot instead of caching the wrong identifier.
+     *
+     * These pushes carry only the few fields the movement itself changed, so
+     * they go through `patchSection` — unlike a server delta, which always
+     * carries a complete `location` and is applied with `applyDelta`. Patching
+     * keeps the rest of the section (system, connections, POI details) intact
+     * until `reconcileFleetState` refreshes the authoritative snapshot; the
+     * per-POI fields that the move invalidates are only as stale as that
+     * round trip.
      */
     private applyFleetMovementPush;
     /**

package/dist/data/catalog.d.ts

@@ -1,4 +1,4 @@
-import type { FacilityDefinition, Item, Module, Recipe, ShipClass, SkillDefinition } from '../generated/openapi/types.gen.js';
+import type { CatalogAchievement, CatalogDump, FacilityDefinition, Item, Module, Recipe, ShipClass, SkillDefinition } from '../generated/openapi/types.gen.js';
 /**
  * Local copy of the bulk game catalog (`GET /api/catalog.json`).
  *
@@ -23,14 +23,21 @@ export type CatalogItem = Item | Module;
 export type CatalogRecipe = Recipe;
 export type CatalogSkill = SkillDefinition;
 export type CatalogFacility = FacilityDefinition;
-export interface Catalog {
-    version?: string;
+/** An achievement entry — the same shape for player and faction achievements. */
+export type { CatalogAchievement };
+/**
+ * The normalized catalog. Derived from the spec's `CatalogDump` rather than
+ * restated field by field, so a section the server adds breaks `typecheck`
+ * here instead of being silently dropped by `normalizeCatalog` — which is how
+ * the achievements sections went missing until v0.573.1.
+ */
+export type Catalog = Omit<CatalogDump, 'ships' | 'items' | 'recipes' | 'skills' | 'facilities'> & {
     ships: CatalogShip[];
     items: CatalogItem[];
     recipes: CatalogRecipe[];
     skills: CatalogSkill[];
     facilities: CatalogFacility[];
-}
+};
 /** Result of a conditional catalog fetch. */
 export interface CatalogFetchResult {
     /** True when the server answered `304 Not Modified` — `catalog` is absent. */
@@ -58,6 +65,7 @@ export declare class CatalogCache {
     private readonly recipesById;
     private readonly skillsById;
     private readonly facilitiesById;
+    private readonly achievementsById;
     constructor(catalog: Catalog, 
     /** The server `ETag` this catalog was fetched with, for conditional reloads. */
     etag?: string | undefined);
@@ -69,15 +77,27 @@ export declare class CatalogCache {
      * `CatalogCache` when the catalog has changed.
      */
     revalidate(httpBaseUrl: string): Promise<CatalogCache>;
-    get version(): string | undefined;
+    /** Server release this catalog was built for; `''` if the response omitted it. */
+    get version(): string;
     ship(id: string): CatalogShip | undefined;
     item(id: string): CatalogItem | undefined;
     recipe(id: string): CatalogRecipe | undefined;
     skill(id: string): CatalogSkill | undefined;
     facility(id: string): CatalogFacility | undefined;
+    /** Looks up player and faction achievements alike — the ids share one space. */
+    achievement(id: string): CatalogAchievement | undefined;
     get ships(): readonly CatalogShip[];
     get items(): readonly CatalogItem[];
     get recipes(): readonly CatalogRecipe[];
     get skills(): readonly CatalogSkill[];
     get facilities(): readonly CatalogFacility[];
+    get achievements(): readonly CatalogAchievement[];
+    get factionAchievements(): readonly CatalogAchievement[];
+    /**
+     * Achievements the server withholds from the catalog until earned, reported
+     * as a count so a client can show "9 hidden" rather than imply the list is
+     * complete.
+     */
+    get hiddenAchievementCount(): number;
+    get hiddenFactionAchievementCount(): number;
 }

package/dist/data/map.d.ts

@@ -1,19 +1,20 @@
+import type { MapData, MapDataSystem } from '../generated/openapi/types.gen.js';
 /**
  * Local copy of the static galaxy map (`GET /api/map`).
  *
  * Returns `{ systems, empires }` where `empires` maps an empire id to a display
- * colour. System shapes aren't in the v2 spec, so they're typed loosely with
- * `id`-keyed lookups. Static per release; the separate `/api/map/activity`
- * overlay (online counts, battles) changes frequently and is not cached here.
+ * colour. Static per release; the separate `/api/map/activity` overlay (online
+ * counts, battles) changes frequently and is not cached here.
+ *
+ * Both shapes come from the spec. `MapDataSystem` is the entry this endpoint
+ * actually returns (`id` with flat `x`/`y`), published under its own name so it
+ * no longer collides with the v2 map *command*'s `MapSystem` (`system_id`, a
+ * nested `position`) — which used to win the name and make `MapData.systems`
+ * document a shape this endpoint never sends.
  */
-export interface MapSystem {
-    id?: string;
-    [key: string]: unknown;
-}
-export interface GalaxyMap {
-    systems: MapSystem[];
-    empires: Record<string, string>;
-}
+/** A system entry from `GET /api/map`. */
+export type MapSystem = MapDataSystem;
+export type GalaxyMap = MapData;
 export declare function fetchMap(httpBaseUrl: string): Promise<GalaxyMap>;
 export declare class MapCache {
     readonly map: GalaxyMap;

package/dist/data/mobile-base.d.ts

@@ -0,0 +1,13 @@
+import type { MobileBaseLocation } from '../generated/openapi/types.gen.js';
+/**
+ * Where the galaxy's single moving capital currently is
+ * (`GET /wheres-mobile-base`).
+ *
+ * The mobile base relocates as the game runs, so this is live data — fetch it
+ * when you need it rather than caching it like the catalog or map. The response
+ * is the spec's published `MobileBaseLocation` (`{ system }`), a system id that
+ * indexes into the galaxy map.
+ */
+/** Fetch the mobile base's current system id. */
+export declare function fetchMobileBase(httpBaseUrl: string): Promise<MobileBaseLocation>;
+export type { MobileBaseLocation };

package/dist/data/stations.d.ts

@@ -14,8 +14,18 @@
  */
 export interface StationSummary {
     id: string;
+    /**
+     * Base ID for this station — the identifier `location.docked_at` reports and
+     * that base-scoped commands (market, storage, services) take, so this is the
+     * join between the directory and live state. Distinct from `id`.
+     */
+    base_id: string;
+    /** POI the station sits at — the identifier `travel` takes. */
+    poi_id: string;
     name: string;
     description: string;
+    /** Base type, e.g. `station` or `outpost`. */
+    type: string;
     empire?: string;
     empire_name?: string;
     faction_id?: string;

package/dist/generated/actions.gen.d.ts

@@ -1,7 +1,7 @@
 /** The gameserver spec version this command surface was generated from. */
-export declare const GENERATED_SPEC_VERSION = "v0.547.0";
+export declare const GENERATED_SPEC_VERSION = "v0.574.0";
 export type ToolName = "spacemolt" | "spacemolt_auth" | "spacemolt_battle" | "spacemolt_citizenship" | "spacemolt_drone" | "spacemolt_facility" | "spacemolt_faction" | "spacemolt_faction_admin" | "spacemolt_faction_commerce" | "spacemolt_fleet" | "spacemolt_intel" | "spacemolt_market" | "spacemolt_salvage" | "spacemolt_ship" | "spacemolt_shipping" | "spacemolt_social" | "spacemolt_storage" | "spacemolt_transfer";
-export type ActionName = "abandon_mission" | "accept" | "accept_ally" | "accept_invite" | "accept_mission" | "accept_peace" | "advance" | "allow_faction" | "allow_player" | "analyze_market" | "apply" | "attack" | "ban" | "base_cost" | "board" | "browse_for_sale" | "browse_ships" | "build" | "buy" | "buy_listed_ship" | "buy_listing" | "buy_ship_license" | "cancel" | "cancel_commission" | "cancel_listing" | "cancel_mission" | "cancel_order" | "cancel_ship_buy_order" | "cancel_ship_listing" | "captains_log_add" | "captains_log_delete" | "captains_log_get" | "captains_log_list" | "chat" | "claim" | "cloak" | "commission_quote" | "commission_ship" | "commission_status" | "complete_mission" | "completed_missions" | "craft" | "create" | "create_buy_order" | "create_note" | "create_role" | "create_sell_order" | "declare_war" | "decline" | "decline_invite" | "decline_mission" | "delete_note" | "delete_role" | "delete_room" | "deliver" | "deploy" | "deploy_outpost" | "deposit" | "disband" | "disembark" | "dismantle" | "dismantle_outpost" | "distress_signal" | "dock" | "edit" | "edit_role" | "engage" | "espionage" | "estimate_purchase" | "facility_set_description" | "faction_build" | "faction_dismantle" | "faction_list" | "faction_owned" | "faction_upgrade" | "find_route" | "forum_create_thread" | "forum_delete_reply" | "forum_delete_thread" | "forum_get_thread" | "forum_list" | "forum_reply" | "forum_upvote" | "found_station" | "garages" | "get" | "get_achievements" | "get_action_log" | "get_active_missions" | "get_base" | "get_cargo" | "get_chat_history" | "get_commands" | "get_empire_info" | "get_faction_achievements" | "get_guide" | "get_invites" | "get_location" | "get_map" | "get_missions" | "get_nearby" | "get_notes" | "get_notification_settings" | "get_notifications" | "get_player" | "get_poi" | "get_queue" | "get_ship" | "get_skills" | "get_state" | "get_status" | "get_system" | "get_system_agents" | "get_tax_estimate" | "get_trades" | "get_version" | "hunt" | "info" | "inspect" | "install_mod" | "insure" | "intel_status" | "invite" | "jettison" | "job_add" | "job_cancel" | "job_list" | "job_reorder" | "join" | "jump" | "kick" | "leave" | "list" | "list_for_sale" | "list_missions" | "list_passengers" | "list_ship_for_sale" | "list_ships" | "list_station_passengers" | "load" | "load_passenger" | "log" | "login" | "login_link" | "login_link_poll" | "login_token" | "logout" | "loot" | "mine" | "modify_order" | "mute_notifications" | "name" | "owned" | "pay_debt" | "personal_build" | "personal_decorate" | "personal_visit" | "petition" | "place_ship_buy_order" | "policies" | "post" | "post_mission" | "prepay_tax" | "profile" | "promote" | "propose_ally" | "propose_peace" | "query_intel" | "query_trade_intel" | "quote" | "ranch_set_cull" | "ranch_status" | "read_note" | "recall" | "recycle" | "refit_ship" | "refuel" | "register" | "release" | "reload" | "remove_ally" | "remove_enemy" | "remove_faction" | "remove_player" | "rename_ship" | "renounce" | "repair" | "repair_module" | "retreat" | "return" | "rooms" | "scan" | "scan_poi" | "scrap" | "scrap_ship" | "search_systems" | "self_destruct" | "sell" | "sell_ship_to_order" | "set_access" | "set_auto_buy_fuel" | "set_build_policy" | "set_colors" | "set_description" | "set_enemy" | "set_home" | "set_market_fee" | "set_name" | "set_output_price" | "set_public" | "set_refuel_price" | "set_repair_price" | "set_service_access" | "set_status" | "stance" | "station_info" | "station_set_name" | "status" | "submit_intel" | "submit_trade_intel" | "subscribe_market" | "subscribe_observation" | "summary" | "supply_commission" | "survey_system" | "switch_ship" | "target" | "tax_estimate" | "tow" | "track" | "trade_accept" | "trade_cancel" | "trade_decline" | "trade_intel_status" | "trade_offer" | "transfer" | "travel" | "types" | "unban" | "undock" | "uninstall_mod" | "unload" | "unload_passenger" | "unmute_notifications" | "unsubscribe_market" | "unsubscribe_observation" | "upgrade" | "upgrades" | "upload" | "use_item" | "view" | "view_completed_mission" | "view_market" | "view_orders" | "view_ship_buy_orders" | "visit_room" | "withdraw" | "withdraw_invite" | "wrecks" | "write_note" | "write_room";
+export type ActionName = "abandon_mission" | "accept" | "accept_ally" | "accept_invite" | "accept_mission" | "accept_peace" | "active" | "advance" | "allow_faction" | "allow_player" | "analyze_market" | "apply" | "attack" | "ban" | "base_cost" | "board" | "browse_for_sale" | "browse_ships" | "build" | "buy" | "buy_listed_ship" | "buy_listing" | "buy_ship_license" | "cancel" | "cancel_commission" | "cancel_listing" | "cancel_mission" | "cancel_order" | "cancel_ship_buy_order" | "cancel_ship_listing" | "captains_log_add" | "captains_log_delete" | "captains_log_get" | "captains_log_list" | "chat" | "claim" | "claim_prize" | "cloak" | "commission_quote" | "commission_ship" | "commission_status" | "complete_mission" | "completed_missions" | "craft" | "create" | "create_buy_order" | "create_note" | "create_role" | "create_sell_order" | "declare_war" | "decline" | "decline_invite" | "decline_mission" | "delete_note" | "delete_role" | "delete_room" | "deliver" | "deploy" | "deploy_outpost" | "deposit" | "disband" | "disembark" | "dismantle" | "dismantle_outpost" | "distress_signal" | "dock" | "edit" | "edit_role" | "engage" | "espionage" | "estimate_purchase" | "facility_set_description" | "faction_build" | "faction_dismantle" | "faction_list" | "faction_owned" | "faction_personnel" | "faction_upgrade" | "find_route" | "forum_create_thread" | "forum_delete_reply" | "forum_delete_thread" | "forum_get_thread" | "forum_list" | "forum_reply" | "forum_upvote" | "found_station" | "garages" | "get" | "get_achievements" | "get_action_log" | "get_active_missions" | "get_base" | "get_cargo" | "get_chat_history" | "get_commands" | "get_empire_info" | "get_faction_achievements" | "get_guide" | "get_invites" | "get_location" | "get_map" | "get_missions" | "get_nearby" | "get_notes" | "get_notification_settings" | "get_notifications" | "get_player" | "get_poi" | "get_queue" | "get_ship" | "get_skills" | "get_state" | "get_status" | "get_system" | "get_system_agents" | "get_tax_estimate" | "get_trades" | "get_version" | "hunt" | "info" | "inspect" | "install_mod" | "insure" | "intel_status" | "invite" | "jettison" | "job_add" | "job_cancel" | "job_list" | "job_reorder" | "join" | "jump" | "kick" | "leave" | "list" | "list_for_sale" | "list_missions" | "list_passengers" | "list_ship_for_sale" | "list_ships" | "list_station_passengers" | "load" | "load_passenger" | "log" | "login" | "login_link" | "login_link_poll" | "login_token" | "logout" | "loot" | "mine" | "modify_order" | "mute_notifications" | "name" | "owned" | "pay_bounty" | "pay_debt" | "personal_build" | "personal_decorate" | "personal_visit" | "petition" | "place_ship_buy_order" | "policies" | "post" | "post_mission" | "prepay_tax" | "profile" | "promote" | "propose_ally" | "propose_peace" | "query_intel" | "query_trade_intel" | "quote" | "ranch_set_cull" | "ranch_status" | "read_note" | "recall" | "recruit_personnel" | "recycle" | "refit_ship" | "refuel" | "register" | "release" | "reload" | "remove_ally" | "remove_enemy" | "remove_faction" | "remove_player" | "rename_ship" | "renounce" | "repair" | "retreat" | "return" | "rooms" | "scan" | "scan_poi" | "scrap" | "scrap_ship" | "search_systems" | "self_destruct" | "sell" | "sell_ship_to_order" | "service_prize" | "set_access" | "set_auto_buy_fuel" | "set_build_policy" | "set_colors" | "set_description" | "set_enemy" | "set_home" | "set_market_fee" | "set_name" | "set_output_price" | "set_public" | "set_refuel_price" | "set_repair_price" | "set_service_access" | "set_status" | "stance" | "station_info" | "station_set_name" | "status" | "submit_intel" | "submit_trade_intel" | "subscribe_market" | "subscribe_observation" | "summary" | "supply_commission" | "survey_system" | "switch_ship" | "target" | "tax_estimate" | "tow" | "track" | "trade_accept" | "trade_cancel" | "trade_decline" | "trade_intel_status" | "trade_offer" | "transfer" | "transfer_personnel" | "travel" | "treat_personnel" | "types" | "unban" | "undock" | "uninstall_mod" | "unload" | "unload_passenger" | "unmute_notifications" | "unsubscribe_market" | "unsubscribe_observation" | "upgrade" | "upgrades" | "upload" | "use_item" | "view" | "view_completed_mission" | "view_market" | "view_orders" | "view_ship_buy_orders" | "visit_room" | "withdraw" | "withdraw_invite" | "wrecks" | "write_note" | "write_room";
 export interface ActionParam {
     readonly name: string;
     readonly type: string;