@spacemolt/lib 15.0.0 → 15.1.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.609.4`). **296 commands across 19 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.612.0`). **296 commands across 19 tools.**
 
 ## How to call a command
 

package/dist/account.d.ts

@@ -15,7 +15,7 @@ import type { AuthCredentials } from './auth/credentials.js';
 import type { LoggedInPayload as LoggedInPayloadSchema, SubscribeMarketResponse, SubscribeObservationResponse } from './generated/openapi/types.gen.js';
 import type { NotificationPayloads, TypedNotificationType } from './generated/notifications.gen.js';
 import type { FleetPush, OkPush } from './push-frames.js';
-import { type ConnectionClosedError } from './errors.js';
+import { ConnectionClosedError } from './errors.js';
 import { type MarketBook } from './state/market.js';
 import { type ObservationView } from './state/observation.js';
 import type { GameState, MutationAck, MutationResult, QueryResult, RawFrame, StateSection, WelcomeFrame } from './protocol.js';

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

@@ -1,5 +1,5 @@
 /** The gameserver spec version this command surface was generated from. */
-export declare const GENERATED_SPEC_VERSION = "v0.609.4";
+export declare const GENERATED_SPEC_VERSION = "v0.612.0";
 export type ToolName = "spacemolt" | "spacemolt_arena" | "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" | "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" | "challenge" | "challenges" | "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" | "fight" | "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 {

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

@@ -1,6 +1,6 @@
-import type { NotificationAchievementUnlocked, NotificationActionError, NotificationActionResult, NotificationArenaChallenge, NotificationArenaObjective, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCloak, NotificationCompleteMission, NotificationCraftingUpdate, NotificationDroneAdrift, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationError, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationFactionAllianceBroken, NotificationFactionAllianceFormed, NotificationFactionAllianceProposal, NotificationFactionPeaceAccepted, NotificationFactionPeaceProposal, NotificationFactionWarDeclared, NotificationFleet, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationOk, NotificationPersonnelUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationPrizeUpdate, NotificationRanchPoached, NotificationReconnected, NotificationRefueledBy, NotificationRepairedBy, NotificationScanDetected, NotificationServerRestartWarning, NotificationShipCaptured, NotificationShipCommissionComplete, NotificationSkillLevelUp, NotificationStationRepaired, NotificationTradeCancelled, NotificationTradeComplete, NotificationTradeDeclined, NotificationTradeOfferReceived } from './openapi/types.gen.js';
+import type { NotificationAchievementUnlocked, NotificationActionError, NotificationActionResult, NotificationArenaChallenge, NotificationArenaObjective, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCloak, NotificationCompleteMission, NotificationCraftingUpdate, NotificationDroneAdrift, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationError, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationFactionAllianceBroken, NotificationFactionAllianceFormed, NotificationFactionAllianceProposal, NotificationFactionPeaceAccepted, NotificationFactionPeaceProposal, NotificationFactionWarDeclared, NotificationFleet, NotificationGiftReceived, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationOk, NotificationPersonnelUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationPrizeUpdate, NotificationRanchPoached, NotificationReconnected, NotificationRefueledBy, NotificationRepairedBy, NotificationScanDetected, NotificationServerRestartWarning, NotificationShipCaptured, NotificationShipCommissionComplete, NotificationSkillLevelUp, NotificationStationRepaired, NotificationTradeCancelled, NotificationTradeComplete, NotificationTradeDeclined, NotificationTradeOfferReceived } from './openapi/types.gen.js';
 /** msg_type values that have a published payload schema. */
-export type TypedNotificationType = "achievement_unlocked" | "action_error" | "action_result" | "arena_challenge" | "arena_objective" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "battle_update" | "chat_message" | "cloak" | "complete_mission" | "crafting_update" | "drone_adrift" | "drone_destroyed" | "drone_scan" | "drone_survey" | "drone_update" | "error" | "facility_reclaimed" | "facility_rent_warning" | "faction_alliance_broken" | "faction_alliance_formed" | "faction_alliance_proposal" | "faction_peace_accepted" | "faction_peace_proposal" | "faction_war_declared" | "fleet" | "market_update" | "mining_yield" | "observation_update" | "ok" | "personnel_update" | "pilotless_ship" | "pirate_destroyed" | "pirate_radio" | "player_died" | "player_kill" | "prize_update" | "ranch_poached" | "reconnected" | "refueled_by" | "repaired_by" | "scan_detected" | "server_restart_warning" | "ship_captured" | "ship_commission_complete" | "skill_level_up" | "station_repaired" | "trade_cancelled" | "trade_complete" | "trade_declined" | "trade_offer_received";
+export type TypedNotificationType = "achievement_unlocked" | "action_error" | "action_result" | "arena_challenge" | "arena_objective" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "battle_update" | "chat_message" | "cloak" | "complete_mission" | "crafting_update" | "drone_adrift" | "drone_destroyed" | "drone_scan" | "drone_survey" | "drone_update" | "error" | "facility_reclaimed" | "facility_rent_warning" | "faction_alliance_broken" | "faction_alliance_formed" | "faction_alliance_proposal" | "faction_peace_accepted" | "faction_peace_proposal" | "faction_war_declared" | "fleet" | "gift_received" | "market_update" | "mining_yield" | "observation_update" | "ok" | "personnel_update" | "pilotless_ship" | "pirate_destroyed" | "pirate_radio" | "player_died" | "player_kill" | "prize_update" | "ranch_poached" | "reconnected" | "refueled_by" | "repaired_by" | "scan_detected" | "server_restart_warning" | "ship_captured" | "ship_commission_complete" | "skill_level_up" | "station_repaired" | "trade_cancelled" | "trade_complete" | "trade_declined" | "trade_offer_received";
 /** Maps a typed push msg_type to its payload type. */
 export interface NotificationPayloads {
     "achievement_unlocked": NotificationAchievementUnlocked;
@@ -36,6 +36,7 @@ export interface NotificationPayloads {
     "faction_peace_proposal": NotificationFactionPeaceProposal;
     "faction_war_declared": NotificationFactionWarDeclared;
     "fleet": NotificationFleet;
+    "gift_received": NotificationGiftReceived;
     "market_update": NotificationMarketUpdate;
     "mining_yield": NotificationMiningYield;
     "observation_update": NotificationObservationUpdate;
@@ -63,4 +64,4 @@ export interface NotificationPayloads {
     "trade_offer_received": NotificationTradeOfferReceived;
 }
 /** Names of every push msg_type with a published schema, for runtime checks. */
-export declare const TYPED_NOTIFICATION_TYPES: readonly ["achievement_unlocked", "action_error", "action_result", "arena_challenge", "arena_objective", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "battle_update", "chat_message", "cloak", "complete_mission", "crafting_update", "drone_adrift", "drone_destroyed", "drone_scan", "drone_survey", "drone_update", "error", "facility_reclaimed", "facility_rent_warning", "faction_alliance_broken", "faction_alliance_formed", "faction_alliance_proposal", "faction_peace_accepted", "faction_peace_proposal", "faction_war_declared", "fleet", "market_update", "mining_yield", "observation_update", "ok", "personnel_update", "pilotless_ship", "pirate_destroyed", "pirate_radio", "player_died", "player_kill", "prize_update", "ranch_poached", "reconnected", "refueled_by", "repaired_by", "scan_detected", "server_restart_warning", "ship_captured", "ship_commission_complete", "skill_level_up", "station_repaired", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];
+export declare const TYPED_NOTIFICATION_TYPES: readonly ["achievement_unlocked", "action_error", "action_result", "arena_challenge", "arena_objective", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "battle_update", "chat_message", "cloak", "complete_mission", "crafting_update", "drone_adrift", "drone_destroyed", "drone_scan", "drone_survey", "drone_update", "error", "facility_reclaimed", "facility_rent_warning", "faction_alliance_broken", "faction_alliance_formed", "faction_alliance_proposal", "faction_peace_accepted", "faction_peace_proposal", "faction_war_declared", "fleet", "gift_received", "market_update", "mining_yield", "observation_update", "ok", "personnel_update", "pilotless_ship", "pirate_destroyed", "pirate_radio", "player_died", "player_kill", "prize_update", "ranch_poached", "reconnected", "refueled_by", "repaired_by", "scan_detected", "server_restart_warning", "ship_captured", "ship_commission_complete", "skill_level_up", "station_repaired", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];

package/dist/generated/openapi/types.gen.d.ts

@@ -5628,7 +5628,7 @@ export type McpNotification = {
     data: NotificationPayload;
     id: string;
     /**
-     * Specific frame subtype. Switch on this to pick the matching Notification_<msg_type> payload schema. Routing to the coarse type field: chat_message -> chat. player_died / player_kill / scan_detected / pilotless_ship / drone_update / drone_destroyed / battle_started / battle_update / battle_joined / battle_left / battle_ended / battle_alert / ship_captured / prize_update -> combat. trade_offer_received / trade_complete / trade_declined / trade_cancelled -> trade. market_update -> market. crafting_update -> crafting. observation_update -> observation. personnel_update -> system. Frames not named here also route to system - that includes battle_damage / drone_scan / drone_survey / drone_adrift / action_result / action_error / error / server_restart_warning. A types=combat filter does not carry them.
+     * Specific frame subtype. Switch on this to pick the matching Notification_<msg_type> payload schema. Routing to the coarse type field: chat_message -> chat. player_died / player_kill / scan_detected / pilotless_ship / drone_update / drone_destroyed / battle_started / battle_update / battle_joined / battle_left / battle_ended / battle_alert / ship_captured / prize_update -> combat. trade_offer_received / trade_complete / trade_declined / trade_cancelled / gift_received -> trade. market_update -> market. crafting_update -> crafting. observation_update -> observation. personnel_update -> system. Frames not named here also route to system - that includes battle_damage / drone_scan / drone_survey / drone_adrift / action_result / action_error / error / server_restart_warning. A types=combat filter does not carry them.
      */
     msg_type: string;
     timestamp: string;
@@ -6076,7 +6076,7 @@ export type NotificationChannelInfo = {
 /**
  * Frame payload shared by polling and inline notifications. Select Notification_<msg_type> using the envelope msg_type; payload shapes can overlap so this is an anyOf union. Null means the frame supplied no payload.
  */
-export type NotificationPayload = NotificationAchievementUnlocked | NotificationActionError | NotificationActionResult | NotificationArenaChallenge | NotificationArenaObjective | NotificationBaseDestroyed | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCloak | NotificationCompleteMission | NotificationCraftingUpdate | NotificationDroneAdrift | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationError | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationFactionAllianceBroken | NotificationFactionAllianceFormed | NotificationFactionAllianceProposal | NotificationFactionPeaceAccepted | NotificationFactionPeaceProposal | NotificationFactionWarDeclared | NotificationFleet | NotificationMarketUpdate | NotificationMiningYield | NotificationObservationUpdate | NotificationOk | NotificationPersonnelUpdate | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationPrizeUpdate | NotificationRanchPoached | NotificationReconnected | NotificationRefueledBy | NotificationRepairedBy | NotificationScanDetected | NotificationServerRestartWarning | NotificationShipCaptured | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationStationRepaired | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived | null;
+export type NotificationPayload = NotificationAchievementUnlocked | NotificationActionError | NotificationActionResult | NotificationArenaChallenge | NotificationArenaObjective | NotificationBaseDestroyed | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCloak | NotificationCompleteMission | NotificationCraftingUpdate | NotificationDroneAdrift | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationError | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationFactionAllianceBroken | NotificationFactionAllianceFormed | NotificationFactionAllianceProposal | NotificationFactionPeaceAccepted | NotificationFactionPeaceProposal | NotificationFactionWarDeclared | NotificationFleet | NotificationGiftReceived | NotificationMarketUpdate | NotificationMiningYield | NotificationObservationUpdate | NotificationOk | NotificationPersonnelUpdate | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationPrizeUpdate | NotificationRanchPoached | NotificationReconnected | NotificationRefueledBy | NotificationRepairedBy | NotificationScanDetected | NotificationServerRestartWarning | NotificationShipCaptured | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationStationRepaired | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived | null;
 export type NotificationSettingsResponse = {
     action: string;
     channels: Array<NotificationChannelInfo>;
@@ -6592,6 +6592,43 @@ export type NotificationFleet = {
      */
     player_name?: string;
 };
+/**
+ * Another player's gift has just committed to you. Sent when send_gift delivers items, credits or a ship to you. A ship gift can land at a station other than the one you are docked at; base_id names it. Never mutable. It is the same entry that storage view and dock return in gifts[], plus base_id. That entry stays in storage as the durable copy, so a client that was offline still sees the gift there. items, ships and credits are each omitted when the gift did not include them. base_id is omitted on a credit-only gift.
+ */
+export type NotificationGiftReceived = {
+    /**
+     * Station where the items or ships wait in your personal storage. Omitted on a credit-only gift: the credits are already in your wallet.
+     */
+    base_id?: string;
+    /**
+     * Credits added to your wallet (not to storage). Omitted when the gift carried no credits.
+     */
+    credits?: number;
+    /**
+     * Items deposited into your storage. Omitted when the gift carried no items.
+     */
+    items?: Array<StorageGiftItem>;
+    /**
+     * Sender's note. Omitted when empty.
+     */
+    message?: string;
+    /**
+     * Sender username.
+     */
+    sender: string;
+    /**
+     * Sender player ID.
+     */
+    sender_id: string;
+    /**
+     * Ships transferred to you. Omitted when the gift carried no ship.
+     */
+    ships?: Array<StorageGiftShip>;
+    /**
+     * When the gift was delivered.
+     */
+    timestamp: string;
+};
 export type NotificationMarketUpdate = {
     base_id: string;
     base_name?: string;
@@ -9002,6 +9039,9 @@ export type ShipmentContract = {
     breached_at?: string;
     carrier_payout?: number;
     claim_paid?: number;
+    /**
+     * Player or faction carrier that accepted the contract. Absent while the listing is still posted and on a listing canceled or expired before anyone accepted it.
+     */
     contractor?: ShipmentActor;
     covered_value?: number;
     deadline_tick?: number;
@@ -9010,7 +9050,13 @@ export type ShipmentContract = {
     failure_debt: number;
     id: string;
     insurable: boolean;
+    /**
+     * Station that insures the cargo: the origin station. It keeps the premium and pays any claim. Absent when the shipment is uninsured.
+     */
     insurer?: ShipmentActor;
+    /**
+     * The only player or faction carrier allowed to see and accept this listing. Present only when visibility is invited; absent for public, faction and allies listings.
+     */
     invited_carrier?: ShipmentActor;
     latest_beacon_at?: string;
     latest_beacon_fingerprint?: string;
@@ -9028,6 +9074,9 @@ export type ShipmentContract = {
     reward_escrow: number;
     risk_band: 'probationary' | 'licensed' | 'trusted' | 'prime' | 'unpriced';
     route_hops?: number;
+    /**
+     * Salvage claimant recorded for the package: the insurer station, set when an insured contract posts. No current game action reads it. Absent when the shipment is uninsured.
+     */
     salvage_owner?: ShipmentActor;
     service_fee: number;
     service_level: 'standard' | 'priority';
@@ -9044,6 +9093,9 @@ export type ShipmentContract = {
 export type ShipmentTrackingEvent = {
     base_id?: string;
     class: 'shipping_house_escrow' | 'ship' | 'player_storage' | 'faction_storage' | 'faction_bucket' | 'wreck' | 'unpack_job_escrow' | 'destroyed' | 'unknown';
+    /**
+     * Who held the package at this sample: the storage owner, the owner of the carrying ship, or the recipient or shipper at hand-over or return. Absent when the location names no holder (shipping-house escrow, a wreck or an unknown location).
+     */
     custodian?: ShipmentActor;
     fingerprint: string;
     id: string;
@@ -9133,6 +9185,9 @@ export type ShippingQuote = {
     failure_debt: number;
     insurable: boolean;
     insurance_selected: boolean;
+    /**
+     * The only player or faction carrier allowed to see and accept this listing. Present only when visibility is invited; absent for public, faction and allies listings.
+     */
     invited_carrier?: ShipmentActor;
     max_speed_bonus: number;
     origin_base_id: string;
@@ -9174,12 +9229,29 @@ export type ShippingResponse = ({
     action: 'cancel' | 'deliver' | 'return';
 } & ShippingSettlementResponse);
 export type ShippingSettlementResponse = {
+    /**
+     * Which shipping action settled the contract: deliver (the carrier handed the package over at the destination station), return (the carrier surrendered it at the origin station) or cancel (the shipper withdrew a posting no carrier had accepted).
+     */
     action: 'deliver' | 'return' | 'cancel';
+    /**
+     * Credits paid to the carrier (the contractor) for an on-time deliver: base_reward plus the speed bonus earned at the delivery tick. The bonus is the full max_speed_bonus at or before target_tick and decays linearly (rounded down) to 0 at deadline_tick. Same value as contract.carrier_payout. Omitted (0) for a late deliver, for return and for cancel.
+     */
     carrier_payout?: number;
-    claim_paid?: number;
+    /**
+     * The contract after settlement. status is delivered, returned or canceled and reward_escrow and speed_bonus_escrow are now 0; after cancel premium is also 0 because it was refunded. The sealed manifest (appraisal_lines) is always omitted.
+     */
     contract: ShipmentContract;
+    /**
+     * Late fee in credits now owed by the carrier as freight debt to the insurer station (or to the shipping house station when the contract is uninsured). Only a late deliver or a late return creates it: 10% of (base_reward plus max_speed_bonus) with a minimum of 100 and a maximum of 2500 and never more than half of the contract's failure_debt. Omitted when 0: always for an on-time settlement and for cancel.
+     */
     debt_created?: number;
+    /**
+     * True when the deliver or return happened after deadline_tick but inside the recovery window: the reward goes back to the shipper and the carrier owes the late fee in debt_created. Omitted (false) when on time and for cancel.
+     */
     late?: boolean;
+    /**
+     * Credits returned to the shipper from escrow. On-time deliver: the unearned part of the speed bonus (max_speed_bonus minus the bonus paid). Late deliver and return: base_reward plus max_speed_bonus. Cancel: base_reward plus max_speed_bonus plus the insurance premium; the service_fee is not refunded. On deliver and return the insurer station keeps the premium. Omitted when 0.
+     */
     shipper_refund?: number;
 };
 export type ShippingTrackResponse = {
@@ -9473,23 +9545,65 @@ export type StationServicePools = {
     personnel?: StationServicePoolStatus;
 };
 export type StorageGift = {
+    /**
+     * Credits added to your wallet (not to storage). Omitted when the gift carried no credits.
+     */
     credits?: number;
+    /**
+     * Items deposited into your storage. Omitted when the gift carried no items.
+     */
     items?: Array<StorageGiftItem>;
+    /**
+     * Sender's note. Omitted when empty.
+     */
     message?: string;
+    /**
+     * Sender username.
+     */
     sender: string;
+    /**
+     * Sender player ID.
+     */
     sender_id: string;
+    /**
+     * Ships transferred to you. Omitted when the gift carried no ship.
+     */
     ships?: Array<StorageGiftShip>;
+    /**
+     * When the gift was delivered.
+     */
     timestamp: string;
 };
 export type StorageGiftItem = {
+    /**
+     * Item ID now in your storage at the gift's station.
+     */
     item_id: string;
+    /**
+     * Item display name.
+     */
     name: string;
+    /**
+     * Units received.
+     */
     quantity: number;
 };
 export type StorageGiftShip = {
+    /**
+     * Ship class ID.
+     */
     class_id: string;
+    /**
+     * Ship class display name. Empty when the class no longer resolves.
+     */
     class_name: string;
+    /**
+     * Name the sender gave the ship with rename_ship; omitted when it has none.
+     */
     custom_name?: string;
+    /**
+     * Ship you now own. It is parked at the gift's station; use switch_ship there to fly it.
+     */
     ship_id: string;
 };
 export type StorageLocation = {

package/dist/index.js

@@ -78,7 +78,7 @@ var STATE_SECTIONS = [
   "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.609.4";
+var GENERATED_SPEC_VERSION = "v0.612.0";
 var ACTIONS = {
   "spacemolt_arena/accept": {
     tool: "spacemolt_arena",
@@ -4308,9 +4308,16 @@ class Account {
     });
   }
   makeSocket() {
-    this.socket = new Socket({ url: this.url, webSocketFactory: this.webSocketFactory });
-    this.socket.onFrame = (frame) => this.routeFrame(frame);
-    this.socket.onClose = (err) => this.handleClose(err);
+    const socket = new Socket({ url: this.url, webSocketFactory: this.webSocketFactory });
+    socket.onFrame = (frame) => {
+      if (this.socket === socket)
+        this.routeFrame(frame);
+    };
+    socket.onClose = (err) => {
+      if (this.socket === socket)
+        this.handleClose(err);
+    };
+    this.socket = socket;
   }
   get state() {
     return this.cache.snapshot();
@@ -4451,8 +4458,11 @@ class Account {
     }
   }
   async refresh() {
+    const revision = this.stateRevision;
     const result = await this.commands.spacemolt.get_status();
     const snapshot = requireStructuredContent(result, "spacemolt/get_status");
+    if (revision !== this.stateRevision)
+      return this.cache.snapshot();
     const changed = this.cache.seed(snapshot);
     if (changed.length)
       this.stateRevision++;
@@ -4983,10 +4993,19 @@ class Account {
   async reconnectOnce() {
     if (!this.credentialsProvider)
       throw new Error("reconnectOnce requires credentials");
+    const stopIfClosed = () => {
+      if (!this.userClosing)
+        return;
+      this.socket.close();
+      throw new ConnectionClosedError("account was closed");
+    };
+    stopIfClosed();
     this.socket.close();
     this.makeSocket();
     await this.open();
+    stopIfClosed();
     await this.authenticate(await this.credentialsProvider());
+    stopIfClosed();
     await this.resubscribe();
   }
   async resubscribe() {
@@ -5484,7 +5503,13 @@ class SpacemoltClient {
       return;
     }
     this.reconnectingIds.add(id);
-    this.enqueueRateLimited(() => this.withConnectRetry(() => account.reconnectOnce())).then(() => this.notifyAccountReconnected(account)).catch((reconnectErr) => {
+    const wanted = () => this.connected.get(id) === account;
+    this.enqueueRateLimited(() => this.withConnectRetry(async () => wanted() ? account.reconnectOnce() : undefined)).then(() => {
+      if (wanted())
+        this.notifyAccountReconnected(account);
+    }).catch((reconnectErr) => {
+      if (!wanted())
+        return;
       console.warn(`[spacemolt] failed to reconnect "${id}": ${reconnectErr}`);
       this.connected.delete(id);
       this.notifyAccountDisconnected(id, err);
@@ -5574,6 +5599,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "faction_peace_proposal",
   "faction_war_declared",
   "fleet",
+  "gift_received",
   "market_update",
   "mining_yield",
   "observation_update",

package/package.json

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