@spacemolt/lib 13.0.0 → 13.1.1

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.574.0`). **289 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.578.1`). **289 commands across 18 tools.**
 
 ## How to call a command
 

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.574.0";
+export declare const GENERATED_SPEC_VERSION = "v0.578.1";
 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" | "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 {

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

@@ -23,7 +23,7 @@ export interface SpacemoltAuthRegisterParams {
     empire: "solarian" | "voidborn" | "crimson" | "nebula" | "outerrim";
     /** Your registration code from https://spacemolt.com/dashboard */
     registration_code: string;
-    /** Your unique username (3-24 chars: letters, digits, spaces, underscores, hyphens, apostrophes, periods, exclamation marks, emoji) */
+    /** 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.) */
     username: string;
 }
 export interface SpacemoltBattleEngageParams {
@@ -77,7 +77,7 @@ export interface SpacemoltCitizenshipWithdrawParams {
 export interface SpacemoltDroneDeployParams {
     /** Set to true to deploy every in-bay drone in a single tick. Drones that would exceed remaining bandwidth are skipped. */
     all?: boolean;
-    /** ID of a specific drone to deploy from your bay (see get_drones) */
+    /** ID of a specific drone to deploy from your bay */
     id?: string;
 }
 export interface SpacemoltDroneGetParams {

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

@@ -1,9 +1,11 @@
-import type { NotificationAchievementUnlocked, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCraftingUpdate, NotificationDroneAdrift, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationFactionAllianceBroken, NotificationFactionAllianceFormed, NotificationFactionAllianceProposal, NotificationFactionPeaceAccepted, NotificationFactionPeaceProposal, NotificationFactionWarDeclared, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationPersonnelUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationPrizeUpdate, NotificationRanchPoached, NotificationReconnected, NotificationScanDetected, NotificationServerRestartWarning, NotificationShipCaptured, NotificationShipCommissionComplete, NotificationSkillLevelUp, NotificationStationRepaired, NotificationTradeCancelled, NotificationTradeComplete, NotificationTradeDeclined, NotificationTradeOfferReceived } from './openapi/types.gen.js';
+import type { NotificationAchievementUnlocked, NotificationActionError, NotificationActionResult, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCraftingUpdate, NotificationDroneAdrift, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationFactionAllianceBroken, NotificationFactionAllianceFormed, NotificationFactionAllianceProposal, NotificationFactionPeaceAccepted, NotificationFactionPeaceProposal, NotificationFactionWarDeclared, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationPersonnelUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationPrizeUpdate, NotificationRanchPoached, NotificationReconnected, 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" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "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" | "trade_cancelled" | "trade_complete" | "trade_declined" | "trade_offer_received";
+export type TypedNotificationType = "achievement_unlocked" | "action_error" | "action_result" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "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" | "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;
+    "action_error": NotificationActionError;
+    "action_result": NotificationActionResult;
     "base_destroyed": NotificationBaseDestroyed;
     "base_raid_update": NotificationBaseRaidUpdate;
     "battle_alert": NotificationBattleAlert;
@@ -52,4 +54,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", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "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", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];
+export declare const TYPED_NOTIFICATION_TYPES: readonly ["achievement_unlocked", "action_error", "action_result", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "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", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];

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

@@ -403,12 +403,18 @@ export type BattleEndLogEntry = {
     captures?: Array<CaptureLogEntry>;
     category: string;
     duration: number;
-    outcome: string;
+    /**
+     * How the battle ended. victory means one side survived and took a kill. stalemate and mutual_destruction are both draws. interrupted means a server restart ended the battle before either side won. The WebSocket battle_ended frame calls this same field reason.
+     */
+    outcome: 'victory' | 'stalemate' | 'mutual_destruction' | 'interrupted';
     participant_names?: Array<string>;
     participants: Array<ParticipantSummary>;
     ships_captured?: number;
     ships_destroyed: number;
     total_damage: number;
+    /**
+     * Side id of the winning side. Always -1 for a draw — stalemate and mutual_destruction are both draws — and -1 for a battle a server restart interrupted.
+     */
     winning_side: number;
 };
 export type BattleEndedParticipantInfo = {
@@ -436,6 +442,7 @@ export type BattleLogEntry = {
     joins?: Array<JoinLogEntry>;
     kills?: Array<KillLogEntry>;
     personnel_casualties?: Array<PersonnelCasualtyLogEntry>;
+    recovered_summary?: RecoveredBattleSummary;
     regen?: Array<RegenLogEntry>;
     snapshots: Array<ParticipantSnapshot>;
     system_id: string;
@@ -560,6 +567,9 @@ export type BattleSummaryResponse = {
     ended_at?: string;
     has_station: boolean;
     origin_poi?: string;
+    /**
+     * How the battle ended. victory means one side survived and took a kill. stalemate and mutual_destruction are both draws. interrupted means a server restart ended the battle before either side won. Graceful shutdown emits a battle_ended frame; crash-recovered REST summaries do not fabricate one. Null while status is active. The WebSocket battle_ended frame calls this same field reason.
+     */
     outcome: string;
     participant_count: number;
     player_names?: Array<string>;
@@ -572,6 +582,9 @@ export type BattleSummaryResponse = {
     system_name: string;
     top_damage?: BattleTopDamage;
     total_damage: number;
+    /**
+     * Side id of the winning side. Always -1 for a draw — both stalemate and mutual_destruction report -1 — and -1 for a battle a server restart interrupted. Null while status is active.
+     */
     winning_side: number;
 };
 export type BattleTopDamage = {
@@ -616,6 +629,9 @@ export type BoardingStateLogEntry = {
     casualties_occurred?: boolean;
     defender_casualties?: boolean;
     destroyed?: boolean;
+    /**
+     * Observable boarding transition. Terminal values include capture_ready; plundered; withdrawn; attacker_destroyed; attacker_incapacitated; target_destroyed; target_self_destructed; and restart_canceled. plundered means pirates removed eligible cargo and then disengaged without taking the hull.
+     */
     event: string;
     hull_damage?: number;
     operation_id: string;
@@ -995,6 +1011,10 @@ export type CaptainsLogListResponse = {
 export type CaptureLogEntry = {
     boarding_operation_id: string;
     captor_id: string;
+    /**
+     * Kind of combat actor identified by captor_id. Present on newly recorded captures; omitted on historical rows created before captor provenance was recorded.
+     */
+    captor_kind?: 'player' | 'pirate' | 'npc';
     captor_username: string;
     former_owner_id: string;
     former_owner_username: string;
@@ -1235,12 +1255,18 @@ export type ClaimInsuranceResponse = {
 };
 export type ClaimPrizeResponse = {
     crew_assigned: number;
-    crew_disposition: string;
+    /**
+     * Where the prize crew came from and returns to.
+     */
+    crew_disposition: 'aboard' | 'faction_reserve';
     destination_base_id: string;
     idempotent: boolean;
     prize_id: string;
     ship_id: string;
-    status: string;
+    /**
+     * Recovery state of the prize. delivered / destroyed / expired / recaptured are terminal.
+     */
+    status: 'available' | 'claimed' | 'in_transit' | 'delivered' | 'destroyed' | 'expired' | 'recaptured';
 };
 export type ClientConnectionInfo = {
     distance?: number;
@@ -3013,7 +3039,10 @@ export type FactionPersonnelEmployment = {
     total_marines: number;
 };
 export type FactionPersonnelResponse = {
-    action: string;
+    /**
+     * The personnel_action the request asked for. It is echoed back unchanged.
+     */
+    action: 'status' | 'recruit' | 'deposit' | 'withdraw';
     auto_docked?: boolean;
     auto_undocked?: boolean;
     base_id: string;
@@ -3152,9 +3181,25 @@ export type FactionScanPoiResponse = {
     system_id?: string;
 };
 export type FactionScanPirateContact = {
+    /**
+     * Stronghold crew this pirate flies for and the pirate-standing counterparty affected by fighting them. Omitted only when no stronghold crew can be resolved.
+     */
+    faction?: string;
+    /**
+     * Human-readable name of the pirate stronghold crew. Omitted only when no stronghold crew can be resolved.
+     */
+    faction_name?: string;
     id: string;
     name?: string;
+    /**
+     * Primary livery color configured by the pirate stronghold crew as #RRGGBB. Omitted when the crew has no configured branding.
+     */
+    primary_color?: string;
     role?: string;
+    /**
+     * Secondary livery color configured by the pirate stronghold crew as #RRGGBB. Omitted when the crew has no configured branding.
+     */
+    secondary_color?: string;
     ship_class?: string;
 };
 export type FactionSetEnemyResponse = {
@@ -3582,6 +3627,9 @@ export type GetBaseResponse = {
 };
 export type GetBattleLogResponse = {
     battle_id: string;
+    /**
+     * Tick snapshots include is_npc and is_boss on newly recorded rows. Explicit false is authoritative; either field may be omitted on historical rows that predate identity provenance.
+     */
     entries: Array<BattleLogEntry>;
     /**
      * True if more entries exist past this page (tick_start/tick_end) — raise tick_start or limit to page through.
@@ -4282,10 +4330,20 @@ export type LoungeCheckInResponse = {
     skipped_full?: number;
 };
 export type McpNotification = {
+    /**
+     * Frame payload. The shape is selected by msg_type: read the Notification_<msg_type> schema under components.schemas. The notifications array on every v2 response carries the same payloads as an explicit anyOf.
+     */
+    data: unknown;
     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 / server_restart_warning. A types=combat filter does not carry them.
+     */
     msg_type: string;
     timestamp: string;
-    type: string;
+    /**
+     * Coarse notification category. This is the value get_notifications accepts in its types filter. The server derives it from msg_type — see the msg_type field for the routing table.
+     */
+    type: 'chat' | 'combat' | 'trade' | 'market' | 'crafting' | 'observation' | 'system';
 };
 export type MapData = {
     empires: {
@@ -4650,6 +4708,58 @@ export type NotificationAchievementUnlocked = {
      */
     faction?: boolean;
 };
+/**
+ * A queued action that failed when it ran on a later tick. Delivered on the same path as action_result: to the caller waiting on the originating request_id when one is still attached, otherwise queued and collected through get_notifications.
+ */
+export type NotificationActionError = {
+    /**
+     * Machine-readable error code. Switch on this rather than on message. It is the same code set the synchronous error response uses for that command, so it is not enumerated here — a command can fail at execution time for any reason it can fail immediately.
+     */
+    code: string;
+    /**
+     * Name of the command that failed.
+     */
+    command: string;
+    /**
+     * Optional extra context. Shape depends on code. Omitted when the failure carries none.
+     */
+    details?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Human-readable explanation of the failure.
+     */
+    message: string;
+    /**
+     * Tick the command failed on.
+     */
+    tick: number;
+};
+/**
+ * Result of a queued action that completed on a later tick. It is delivered to the caller waiting on the originating request_id when one is still attached. Otherwise it is queued and collected through get_notifications, which is the normal path once a request has already returned.
+ */
+export type NotificationActionResult = {
+    /**
+     * True when the server docked you to run the command.
+     */
+    auto_docked?: boolean;
+    /**
+     * True when the server undocked you to run the command.
+     */
+    auto_undocked?: boolean;
+    /**
+     * Name of the command that ran.
+     */
+    command: string;
+    /**
+     * Payload of the completed command. On v1 this is the command's own response object — see that command's response schema. On v2 it is the state delta the command registered, keyed by state section. Untyped because both shapes are possible; it is null when the command returned no body.
+     */
+    result: unknown;
+    /**
+     * Tick the command executed on.
+     */
+    tick: number;
+};
 export type NotificationBaseDestroyed = {
     attacker_id: string;
     attacker_name: string;
@@ -4699,10 +4809,16 @@ export type NotificationBattleEnded = {
     captures?: Array<CaptureLogEntry>;
     duration: number;
     participants?: Array<BattleEndedParticipantInfo>;
-    reason: string;
+    /**
+     * How the battle ended. victory means one side survived and took a kill. stalemate and mutual_destruction are both draws. interrupted means a server restart ended the battle. The REST battle summary and battle log call this same field outcome.
+     */
+    reason: 'victory' | 'stalemate' | 'mutual_destruction' | 'interrupted';
     ships_captured?: number;
     ships_destroyed: number;
     total_damage: number;
+    /**
+     * Side id of the winning side. Always -1 for a draw — stalemate and mutual_destruction are both draws — and -1 for a battle a server restart interrupted.
+     */
     winning_side: number;
 };
 export type NotificationBattleJoined = {
@@ -4979,7 +5095,10 @@ export type NotificationObservationUpdate = {
     unknown_signature: boolean;
 };
 export type NotificationPersonnelUpdate = {
-    action: string;
+    /**
+     * What an ally did to your active ship. treatment healed injured crew or marines. transfer moved personnel between ships.
+     */
+    action: 'treatment' | 'transfer';
     crew_capacity: number;
     crew_treated?: number;
     fit_crew_transferred?: number;
@@ -5010,7 +5129,7 @@ export type NotificationPilotlessShip = {
  */
 export type NotificationPirateDestroyed = {
     /**
-     * Combat XP awarded (kill notification to the killer).
+     * Weapons skill XP awarded (legacy field name; kill notification to the killer).
      */
     combat_xp?: number;
     /**
@@ -5041,23 +5160,116 @@ export type NotificationPirateDestroyed = {
      * System name (boss-kill system broadcast).
      */
     system_name?: string;
+    /**
+     * Whether the wreck holds lootable cargo (omitted when no wreck).
+     */
+    wreck_has_cargo?: boolean;
+    /**
+     * Whether the wreck holds salvageable modules (omitted when no wreck).
+     */
+    wreck_has_modules?: boolean;
+    /**
+     * Wreck left behind (omitted when no wreck was created).
+     */
+    wreck_id?: string;
+    /**
+     * POI the wreck was left at — combat is system-scoped, so this can differ from the killer's POI (omitted when no wreck or the POI is hidden from the recipient).
+     */
+    wreck_poi_id?: string;
+    /**
+     * Display name of the wreck's POI (omitted when unknown or hidden from the recipient).
+     */
+    wreck_poi_name?: string;
+    /**
+     * System the wreck is in (omitted when no wreck).
+     */
+    wreck_system_id?: string;
+    /**
+     * Display name of the wreck's system (omitted when no wreck, or when the name is unknown).
+     */
+    wreck_system_name?: string;
 };
-/**
- * Pushed to players in range with a pirate_radio_scanner module, carrying an intercepted pirate transmission.
- */
 export type NotificationPirateRadio = {
     /**
-     * Template/event key of the intercepted message.
+     * Acting pirate combat ID when the grammatical speaker differs from the actor. Omitted when there is no separate actor.
      */
-    event_key?: string;
+    actor_id?: string;
     /**
-     * Pirate faction key the transmission belongs to.
+     * Acting pirate display name when the grammatical speaker differs from the actor. Omitted when there is no separate actor.
+     */
+    actor_name?: string;
+    /**
+     * Battle identity when the transmission refers to a fight.
+     */
+    battle_id?: string;
+    /**
+     * Backward-compatible alias of editorial_class. Both fields always carry the same bounded editorial class.
+     */
+    category: 'ambient' | 'tactical' | 'strategic' | 'outcome';
+    /**
+     * Bounded editorial delivery policy for the public pirate-radio Discord feed; it does not affect in-game delivery.
+     */
+    discord_policy: 'never' | 'batched' | 'immediate';
+    /**
+     * Canonical cross-channel editorial class and alias of category. Both fields always carry the same value.
+     */
+    editorial_class: 'ambient' | 'tactical' | 'strategic' | 'outcome';
+    /**
+     * Bounded pirate-radio template and lifecycle event key.
+     */
+    event_key: string;
+    /**
+     * Pirate stronghold crew key the transmission belongs to.
+     */
+    faction_key: string;
+    /**
+     * Human-readable pirate stronghold crew name.
+     */
+    faction_name: string;
+    /**
+     * Ship class ID of the crew flagship when configured.
+     */
+    flagship_ship_class: string;
+    /**
+     * Rendered in-character transmission text.
      */
-    faction_key?: string;
     message: string;
+    /**
+     * Stable raid; expedition; breakout; return; or incident identity when the transmission belongs to an operation.
+     */
+    operation_id?: string;
+    /**
+     * Display name of the selected speaker: the acting pirate; operation leader; stronghold control; or boss.
+     */
     pirate_name: string;
-    source_poi?: string;
-    source_system?: string;
+    /**
+     * Primary pirate-crew livery color as #RRGGBB.
+     */
+    primary_color: string;
+    /**
+     * Bounded machine-readable doctrine or lifecycle reason code when available.
+     */
+    reason_code?: string;
+    /**
+     * Secondary pirate-crew livery color as #RRGGBB.
+     */
+    secondary_color: string;
+    /**
+     * POI ID from which the transmission originated. Empty when no POI can be resolved.
+     */
+    source_poi: string;
+    /**
+     * System ID from which the transmission originated.
+     */
+    source_system: string;
+    /**
+     * Selected grammatical speaker category such as actor; operation_leader; stronghold_control; or boss.
+     */
+    speaker_category: string;
+    /**
+     * Combat actor ID or stable synthetic stronghold-control speaker ID.
+     */
+    speaker_id: string;
 };
 export type NotificationPlayerDied = {
     cause?: string;
@@ -5070,7 +5282,23 @@ export type NotificationPlayerDied = {
     self_destruct_fee?: number;
     ship_lost: string;
     wreck_id?: string;
+    /**
+     * POI where the wreck was left. Omitted when there is no wreck or the POI is hidden from the recipient.
+     */
+    wreck_poi_id?: string;
+    /**
+     * Display name of the wreck POI. Omitted when unknown or hidden from the recipient.
+     */
+    wreck_poi_name?: string;
     wreck_suppressed?: boolean;
+    /**
+     * System where the wreck was left. Omitted when there is no wreck.
+     */
+    wreck_system_id?: string;
+    /**
+     * Display name of the wreck system. Omitted when unknown.
+     */
+    wreck_system_name?: string;
 };
 /**
  * Pushed to the killer when they destroy another player's ship.
@@ -5092,6 +5320,22 @@ export type NotificationPlayerKill = {
      * Wreck left behind (omitted when no wreck was created).
      */
     wreck_id?: string;
+    /**
+     * POI the wreck was left at — combat is system-scoped, so this can differ from the killer's POI (omitted when no wreck or the POI is hidden from the recipient).
+     */
+    wreck_poi_id?: string;
+    /**
+     * Display name of the wreck's POI (omitted when unknown or hidden from the recipient).
+     */
+    wreck_poi_name?: string;
+    /**
+     * System the wreck is in (omitted when no wreck).
+     */
+    wreck_system_id?: string;
+    /**
+     * Display name of the wreck's system (omitted when no wreck, or when the name is unknown).
+     */
+    wreck_system_name?: string;
 };
 export type NotificationPrizeUpdate = {
     destination_base_id?: string;
@@ -5101,9 +5345,15 @@ export type NotificationPrizeUpdate = {
     ship_class: string;
     ship_id: string;
     ship_name?: string;
-    status: string;
+    /**
+     * Recovery state of the prize. delivered / destroyed / expired / recaptured are terminal.
+     */
+    status: 'available' | 'claimed' | 'in_transit' | 'delivered' | 'destroyed' | 'expired' | 'recaptured';
     system_id?: string;
-    wait_reason?: string;
+    /**
+     * Why an in_transit prize is stalled. Omitted while the prize is moving.
+     */
+    wait_reason?: 'no_route' | 'no_fuel' | 'destination_missing' | 'incapacitated' | 'manual_stop';
     wreck_id?: string;
 };
 export type NotificationRanchPoached = {
@@ -5140,6 +5390,10 @@ export type NotificationShipCaptured = {
     battle_id: string;
     boarding_operation_id: string;
     captor_id: string;
+    /**
+     * Kind of combat actor identified by captor_id. Present on newly emitted captures; omitted only on historical persisted capture records.
+     */
+    captor_kind?: 'player' | 'pirate' | 'npc';
     captor_username: string;
     former_owner_id: string;
     former_owner_username: string;
@@ -5414,6 +5668,14 @@ export type ParticipantSnapshot = {
     flee_counter: number;
     fuel: number;
     hull: number;
+    /**
+     * True for a named pirate boss. False explicitly means not a boss. Omitted only on historical rows recorded before participant identity provenance was captured.
+     */
+    is_boss?: boolean;
+    /**
+     * True for an automated combatant. False explicitly means player-controlled. Omitted only on historical rows recorded before participant identity provenance was captured.
+     */
+    is_npc?: boolean;
     kill_count: number;
     kind?: string;
     max_fuel: number;
@@ -5542,6 +5804,14 @@ export type PirateInfo = {
     max_shield?: number;
     name: string;
     pirate_id: string;
+    /**
+     * Primary livery color for this pirate crew as a hex color.
+     */
+    primary_color?: string;
+    /**
+     * Secondary livery color for this pirate crew as a hex color.
+     */
+    secondary_color?: string;
     shield?: number;
     status: string;
     tier: string;
@@ -5864,12 +6134,21 @@ export type PrizeInfo = {
     ship_class: string;
     ship_id: string;
     ship_name?: string;
-    status: string;
-    wait_reason?: string;
+    /**
+     * Recovery state of the prize. delivered / destroyed / expired / recaptured are terminal.
+     */
+    status: 'available' | 'claimed' | 'in_transit' | 'delivered' | 'destroyed' | 'expired' | 'recaptured';
+    /**
+     * Why an in_transit prize is stalled. Omitted while the prize is moving.
+     */
+    wait_reason?: 'no_route' | 'no_fuel' | 'destination_missing' | 'incapacitated' | 'manual_stop';
 };
 export type PrizeRecoveryInfo = {
     actor_id: string;
-    crew_disposition: string;
+    /**
+     * Where the prize crew came from and returns to.
+     */
+    crew_disposition: 'aboard' | 'faction_reserve';
     destination_base_id: string;
     fuel: number;
     hull: number;
@@ -5882,27 +6161,48 @@ export type PrizeRecoveryInfo = {
     ship_class: string;
     ship_id: string;
     ship_name?: string;
-    status: string;
+    /**
+     * Recovery state of the prize. delivered / destroyed / expired / recaptured are terminal.
+     */
+    status: 'available' | 'claimed' | 'in_transit' | 'delivered' | 'destroyed' | 'expired' | 'recaptured';
     system_id?: string;
     transit_arrival_tick?: number;
     transit_from_poi_id?: string;
     transit_from_system_id?: string;
-    transit_kind?: string;
+    /**
+     * Which leg the prize is flying. jump crosses systems. travel crosses POIs inside one system.
+     */
+    transit_kind?: 'jump' | 'travel';
     transit_to_poi_id?: string;
     transit_to_system_id?: string;
-    wait_reason?: string;
+    /**
+     * Why an in_transit prize is stalled. Omitted while the prize is moving.
+     */
+    wait_reason?: 'no_route' | 'no_fuel' | 'destination_missing' | 'incapacitated' | 'manual_stop';
 };
 export type PrizeServiceResponse = {
-    action: string;
-    crew_disposition?: string;
+    /**
+     * The service_action the request asked for. It is echoed back unchanged.
+     */
+    action: 'stop' | 'resume' | 'redirect' | 'refuel' | 'repair';
+    /**
+     * Where the prize crew came from and returns to.
+     */
+    crew_disposition?: 'aboard' | 'faction_reserve';
     destination_base_id?: string;
     fuel_transferred?: number;
     hull_repaired?: number;
     prize_id: string;
     repair_kits_used?: number;
     ship_id: string;
-    status: string;
-    wait_reason?: string;
+    /**
+     * Recovery state of the prize. delivered / destroyed / expired / recaptured are terminal.
+     */
+    status: 'available' | 'claimed' | 'in_transit' | 'delivered' | 'destroyed' | 'expired' | 'recaptured';
+    /**
+     * Why an in_transit prize is stalled. Omitted while the prize is moving.
+     */
+    wait_reason?: 'no_route' | 'no_fuel' | 'destination_missing' | 'incapacitated' | 'manual_stop';
 };
 export type RanchFeedInfo = {
     cycles_left: number;
@@ -5995,6 +6295,20 @@ export type RecipeOutput = {
     item_id: string;
     quantity: number;
 };
+export type RecoveredBattleSummary = {
+    captures?: Array<CaptureLogEntry>;
+    category: string;
+    duration: number;
+    participant_names?: Array<string>;
+    participants: Array<ParticipantSummary>;
+    ships_captured?: number;
+    ships_destroyed: number;
+    side_factions?: {
+        [key: string]: never;
+    };
+    start_tick: number;
+    total_damage: number;
+};
 export type RecruitPersonnelResponse = {
     auto_docked?: boolean;
     auto_undocked?: boolean;
@@ -7517,7 +7831,10 @@ export type TreatPersonnelResponse = {
     crew_treated: number;
     marines_treated: number;
     medical_pool_remaining?: number;
-    source: string;
+    /**
+     * Which medical supply paid for the treatment. station is the base infirmary. faction is your faction reserve. field is shipboard medical supplies.
+     */
+    source: 'station' | 'faction' | 'field';
     supplies_used?: number;
     target: string;
 };
@@ -8060,7 +8377,7 @@ export type V2Response = {
         /**
          * Notification payload. Shape depends on msg_type — see the Notification_* schemas under components.schemas.
          */
-        data?: NotificationAchievementUnlocked | NotificationDroneAdrift | NotificationServerRestartWarning | NotificationFactionAllianceBroken | NotificationFactionAllianceFormed | NotificationFactionAllianceProposal | NotificationFactionPeaceAccepted | NotificationFactionPeaceProposal | NotificationFactionWarDeclared | NotificationBaseDestroyed | NotificationStationRepaired | NotificationRanchPoached | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationShipCaptured | NotificationPrizeUpdate | NotificationPersonnelUpdate | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCraftingUpdate | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationMarketUpdate | NotificationObservationUpdate | NotificationMiningYield | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationReconnected | NotificationScanDetected | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived;
+        data?: NotificationAchievementUnlocked | NotificationActionError | NotificationActionResult | NotificationDroneAdrift | NotificationServerRestartWarning | NotificationFactionAllianceBroken | NotificationFactionAllianceFormed | NotificationFactionAllianceProposal | NotificationFactionPeaceAccepted | NotificationFactionPeaceProposal | NotificationFactionWarDeclared | NotificationBaseDestroyed | NotificationStationRepaired | NotificationRanchPoached | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationShipCaptured | NotificationPrizeUpdate | NotificationPersonnelUpdate | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCraftingUpdate | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationMarketUpdate | NotificationObservationUpdate | NotificationMiningYield | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationReconnected | NotificationScanDetected | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived;
         id?: string;
         /**
          * Specific message subtype used for handler routing (e.g. chat_message, battle_update, action_result, mining_yield). Switch on this to pick the matching Notification_* payload schema.
@@ -11114,7 +11431,7 @@ export type SpacemoltAuthRegisterData = {
          */
         registration_code: string;
         /**
-         * Your unique username (3-24 chars: letters, digits, spaces, underscores, hyphens, apostrophes, periods, exclamation marks, emoji)
+         * 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.)
          */
         username: string;
     };
@@ -11823,7 +12140,7 @@ export type SpacemoltDroneDeployData = {
          */
         all?: boolean;
         /**
-         * ID of a specific drone to deploy from your bay (see get_drones)
+         * ID of a specific drone to deploy from your bay
          */
         id?: string;
     };

package/dist/index.js

@@ -45,7 +45,7 @@ var STATE_SECTIONS = [
   "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.574.0";
+var GENERATED_SPEC_VERSION = "v0.578.1";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -113,7 +113,7 @@ 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": {
@@ -260,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": {
@@ -5400,6 +5400,8 @@ async function fetchMobileBase(httpBaseUrl) {
 // src/generated/notifications.gen.ts
 var TYPED_NOTIFICATION_TYPES = [
   "achievement_unlocked",
+  "action_error",
+  "action_result",
   "base_destroyed",
   "base_raid_update",
   "battle_alert",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacemolt/lib",
-  "version": "13.0.0",
+  "version": "13.1.1",
   "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",
@@ -33,7 +33,7 @@
     "prepare": "bun run build",
     "build": "rm -rf dist && bun build src/index.ts --outfile dist/index.js --target node --format esm && bun build src/node.ts --outfile dist/node.js --target node --format esm && bun x tsc -p tsconfig.build.json && bun run scripts/fix-dts-extensions.ts",
     "build:smoke": "node scripts/check-build.mjs",
-    "build:browser-check": "bun build src/index.ts --target browser --outfile /dev/null",
+    "build:browser-check": "bun run scripts/check-browser-build.ts",
     "test": "bun test"
   },
   "repository": {