@spacemolt/lib 16.3.0 → 16.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/COMMANDS.md CHANGED
@@ -1,7 +1,7 @@
1
1
  <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
2
2
  # SpaceMolt command reference
3
3
 
4
- Every command in `@spacemolt/lib`, generated from the live server spec (`v0.637.1`). **306 commands across 19 tools.**
4
+ Every command in `@spacemolt/lib`, generated from the live server spec (`v0.644.2`). **306 commands across 19 tools.**
5
5
 
6
6
  ## How to call a command
7
7
 
@@ -103,7 +103,7 @@ Call as `account.commands.spacemolt.<action>(...)`.
103
103
  - `survey_system()` · *mutation* → delta.details: `SurveySystemResponse` — Read ore across the current system and scan for hidden POIs
104
104
  - `travel({ id: string })` · *mutation* → delta.details: `TravelResponse` — Travel to a different Point of Interest (POI) within your current system
105
105
  - `undock()` · *mutation* → delta.details: `UndockResponse` — Undock from a base
106
- - `uninstall_mod({ id: string })` · *mutation* → delta.details: `UninstallModResponse` — Uninstall a module from your ship
106
+ - `uninstall_mod({ id: string; ship_id?: string })` · *mutation* → delta.details: `UninstallModResponse` — Uninstall a module from your active or stored ship
107
107
  - `unload_passenger({ id: string; target?: string })` · *mutation* → delta.details: `UnloadPassengerCommandResponse` — Put a passenger (or everyone) off the ship here — or hand them off to another ship or your faction's transit lounge for a connecting flight
108
108
  - `unsubscribe_observation()` · *query* → `UnsubscribeObservationResponse` — Cancel your live observation watch
109
109
  - `use_item({ id: string; quantity?: number })` · *mutation* → delta.details: `UseItemResponse` — Use a consumable item from cargo
@@ -337,7 +337,7 @@ Call as `account.commands.spacemolt_salvage.<action>(...)`.
337
337
  - `loot({ id?: string; item_id?: string; module_id?: string; quantity?: number })` · *mutation* → delta.details: `LootWreckCommandResponse` — Loot items and modules from a wreck
338
338
  - `policies()` · *query* → `ClaimInsuranceResponse` — View your active insurance policies
339
339
  - `quote()` · *query* → `GetInsuranceQuoteResponse` — Get a risk-based insurance quote for your current ship
340
- - `release()` · *mutation* → delta.details: `ReleaseTowResponse` — Release a towed wreck at your current location
340
+ - `release()` · *mutation* → delta.details: `ReleaseTowResponse` — Release your wreck tow without moving the wreck
341
341
  - `scrap()` · *mutation* → delta.details: `ScrapWreckResponse` — Scrap a towed wreck for salvage materials
342
342
  - `sell()` · *mutation* → delta.details: `SellWreckResponse` — Sell a towed wreck to an NPC salvage yard for credits
343
343
  - `service_prize({ id: string; item_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
@@ -425,11 +425,11 @@ Call as `account.commands.spacemolt_social.<action>(...)`.
425
425
 
426
426
  Call as `account.commands.spacemolt_storage.<action>(...)`.
427
427
 
428
- - `deposit({ bucket?: string; credits?: number; dest_bucket?: string; item_id?: string; items?: { item_id: string; quantity: number }[]; message?: string; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `DepositItemsResponse | FactionGarageStoreResponse | TransferItemsResponse | TransferCreditsResponse | SendGiftResponse | GiftShipResponse | FactionGiftResponse | EmpireGiftResponse | FactionDepositItemsResponse | FactionDepositCreditsResponse | FactionDepositFuelResponse | BulkStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players
428
+ - `deposit({ bucket?: string; credits?: number; dest_bucket?: string; item_id?: string; items?: { item_id: string; quantity: number }[]; message?: string; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `DepositItemsResponse | FactionGarageStoreResponse | TransferItemsResponse | TransferCreditsResponse | SendGiftResponse | GiftShipResponse | FactionGiftResponse | EmpireGiftResponse | FactionDepositItemsResponse | FactionDepositCreditsResponse | FactionDepositFuelResponse | BulkStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews
429
429
  - `jettison({ item_id?: string; items?: { item_id: string; quantity: number }[]; quantity?: number })` · *mutation* → delta.details: `JettisonCommandResponse` — Jettison items from cargo into space
430
430
  - `loot({ item_id?: string; module_id?: string; quantity?: number; wreck_id?: string })` · *mutation* → delta.details: `LootWreckCommandResponse` — Loot items and modules from a wreck
431
- - `view({ station_id?: string; target?: string })` · *query* → `ViewStorageResponse | ViewFactionStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players
432
- - `withdraw({ bucket?: string; dest_bucket?: string; item_id?: string; items?: { item_id: string; quantity: number }[]; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `WithdrawItemsResponse | TransferItemsResponse | TransferCreditsResponse | FactionWithdrawItemsResponse | FactionWithdrawCreditsResponse | BulkStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players
431
+ - `view({ station_id?: string; target?: string })` · *query* → `ViewStorageResponse | ViewFactionStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews
432
+ - `withdraw({ bucket?: string; dest_bucket?: string; item_id?: string; items?: { item_id: string; quantity: number }[]; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `WithdrawItemsResponse | TransferItemsResponse | TransferCreditsResponse | FactionWithdrawItemsResponse | FactionWithdrawCreditsResponse | BulkStorageResponse` — Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews
433
433
 
434
434
  ## spacemolt_transfer
435
435
 
@@ -1,5 +1,5 @@
1
1
  /** The gameserver spec version this command surface was generated from. */
2
- export declare const GENERATED_SPEC_VERSION = "v0.637.1";
2
+ export declare const GENERATED_SPEC_VERSION = "v0.644.2";
3
3
  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";
4
4
  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_mobile_base_jump" | "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" | "decommission_mobile_base" | "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_edit_reply" | "forum_edit_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_mobile_base" | "get_nearby" | "get_notes" | "get_notification_settings" | "get_notifications" | "get_player" | "get_player_profile" | "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" | "jump_mobile_base" | "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" | "move_mobile_base" | "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" | "reset_contraband" | "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_contraband" | "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";
5
5
  export interface ActionParam {
@@ -1220,7 +1220,7 @@ export interface SpacemoltSocialWriteNoteParams {
1220
1220
  export interface SpacemoltStorageDepositParams {
1221
1221
  /** Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in a storage view with target=faction. */
1222
1222
  bucket?: string;
1223
- /** For 'deposit' with target=<player name/id>: the amount of credits to gift that player. (Faction credit deposits use item_id='credits' with quantity instead.) */
1223
+ /** For 'deposit': credits to gift a player, or to donate to an empire, a station:<id> or a pirate:<crew>. (Faction credit deposits use item_id='credits' with quantity instead.) */
1224
1224
  credits?: number;
1225
1225
  /** Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury. */
1226
1226
  dest_bucket?: string;
@@ -1231,13 +1231,13 @@ export interface SpacemoltStorageDepositParams {
1231
1231
  item_id: string;
1232
1232
  quantity: number;
1233
1233
  }[];
1234
- /** Optional message when gifting to another player */
1234
+ /** Optional message with a gift or donation */
1235
1235
  message?: string;
1236
1236
  /** Amount to transfer */
1237
1237
  quantity?: number;
1238
1238
  /** Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury). */
1239
1239
  source?: string;
1240
- /** Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1240
+ /** Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1241
1241
  target?: string;
1242
1242
  }
1243
1243
  export interface SpacemoltStorageJettisonParams {
@@ -1264,7 +1264,7 @@ export interface SpacemoltStorageLootParams {
1264
1264
  export interface SpacemoltStorageViewParams {
1265
1265
  /** Optional: station Base ID or station POI ID to view storage at without being docked. Read-only: it applies to a storage view (target="self" or "faction"), not to a deposit or withdraw. */
1266
1266
  station_id?: string;
1267
- /** Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1267
+ /** Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1268
1268
  target?: string;
1269
1269
  }
1270
1270
  export interface SpacemoltStorageWithdrawParams {
@@ -1283,7 +1283,7 @@ export interface SpacemoltStorageWithdrawParams {
1283
1283
  quantity?: number;
1284
1284
  /** Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury). */
1285
1285
  source?: string;
1286
- /** Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1286
+ /** Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required. */
1287
1287
  target?: string;
1288
1288
  }
1289
1289
  export interface SpacemoltTransferTradeAcceptParams {
@@ -1563,6 +1563,8 @@ export interface SpacemoltTravelParams {
1563
1563
  export interface SpacemoltUninstallModParams {
1564
1564
  /** Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level). */
1565
1565
  id: string;
1566
+ /** Optional owned ship ID. Omit or leave empty for your active ship. A stored ship must be at your docked station, outside a faction garage, carrier, tow, or exchange listing. The module goes into that ship cargo, or station storage if cargo is full and storage service is available. */
1567
+ ship_id?: string;
1566
1568
  }
1567
1569
  export interface SpacemoltUnloadPassengerParams {
1568
1570
  /** Name (or citizen ID) of the passenger to put off the ship at the current station, or "all" to put every passenger off at once. */
@@ -1700,7 +1702,7 @@ export interface Commands {
1700
1702
  travel(params: SpacemoltTravelParams, requestId?: string): Promise<MutationResult<TravelResponse>>;
1701
1703
  /** Undock from a base */
1702
1704
  undock(requestId?: string): Promise<MutationResult<UndockResponse>>;
1703
- /** Uninstall a module from your ship */
1705
+ /** Uninstall a module from your active or stored ship */
1704
1706
  uninstall_mod(params: SpacemoltUninstallModParams, requestId?: string): Promise<MutationResult<UninstallModResponse>>;
1705
1707
  /** Put a passenger (or everyone) off the ship here — or hand them off to another ship or your faction's transit lounge for a connecting flight */
1706
1708
  unload_passenger(params: SpacemoltUnloadPassengerParams, requestId?: string): Promise<MutationResult<UnloadPassengerCommandResponse>>;
@@ -2064,7 +2066,7 @@ export interface Commands {
2064
2066
  policies(requestId?: string): Promise<QueryResult<ClaimInsuranceResponse>>;
2065
2067
  /** Get a risk-based insurance quote for your current ship */
2066
2068
  quote(requestId?: string): Promise<QueryResult<GetInsuranceQuoteResponse>>;
2067
- /** Release a towed wreck at your current location */
2069
+ /** Release your wreck tow without moving the wreck */
2068
2070
  release(requestId?: string): Promise<MutationResult<ReleaseTowResponse>>;
2069
2071
  /** Scrap a towed wreck for salvage materials */
2070
2072
  scrap(requestId?: string): Promise<MutationResult<ScrapWreckResponse>>;
@@ -2208,15 +2210,15 @@ export interface Commands {
2208
2210
  write_note(params: SpacemoltSocialWriteNoteParams, requestId?: string): Promise<QueryResult<WriteNoteResponse>>;
2209
2211
  };
2210
2212
  spacemolt_storage: {
2211
- /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players */
2213
+ /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews */
2212
2214
  deposit(params?: SpacemoltStorageDepositParams, requestId?: string): Promise<MutationResult<DepositItemsResponse | FactionGarageStoreResponse | TransferItemsResponse | TransferCreditsResponse | SendGiftResponse | GiftShipResponse | FactionGiftResponse | EmpireGiftResponse | FactionDepositItemsResponse | FactionDepositCreditsResponse | FactionDepositFuelResponse | BulkStorageResponse>>;
2213
2215
  /** Jettison items from cargo into space */
2214
2216
  jettison(params?: SpacemoltStorageJettisonParams, requestId?: string): Promise<MutationResult<JettisonCommandResponse>>;
2215
2217
  /** Loot items and modules from a wreck */
2216
2218
  loot(params?: SpacemoltStorageLootParams, requestId?: string): Promise<MutationResult<LootWreckCommandResponse>>;
2217
- /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players */
2219
+ /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews */
2218
2220
  view(params?: SpacemoltStorageViewParams, requestId?: string): Promise<QueryResult<ViewStorageResponse | ViewFactionStorageResponse>>;
2219
- /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players */
2221
+ /** Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews */
2220
2222
  withdraw(params?: SpacemoltStorageWithdrawParams, requestId?: string): Promise<MutationResult<WithdrawItemsResponse | TransferItemsResponse | TransferCreditsResponse | FactionWithdrawItemsResponse | FactionWithdrawCreditsResponse | BulkStorageResponse>>;
2221
2223
  };
2222
2224
  spacemolt_transfer: {
@@ -1722,6 +1722,10 @@ export type BulkStorageResponse = {
1722
1722
  dest_bucket?: string;
1723
1723
  dest_bucket_id?: string;
1724
1724
  failed: number;
1725
+ /**
1726
+ * How the empire or pirate crew received this gift: value to them, bounty paid, reputation change and their reply. Present on gifts to empires, NPC empire stations and pirate strongholds; omitted for gifts to players, factions and the fixer.
1727
+ */
1728
+ goodwill?: GiftGoodwill;
1725
1729
  requested: number;
1726
1730
  results: Array<BulkStorageItemResult>;
1727
1731
  succeeded: number;
@@ -3049,8 +3053,14 @@ export type EmpireGiftResponse = {
3049
3053
  * True when the engine undocked you automatically before running this command, because the command requires being undocked. Omitted when no automatic undock happened.
3050
3054
  */
3051
3055
  auto_undocked?: boolean;
3052
- base_id: string;
3053
- base_name: string;
3056
+ /**
3057
+ * Station where the donation was made. Omitted for a credit wire sent from anywhere other than one of the empire's own stations.
3058
+ */
3059
+ base_id?: string;
3060
+ /**
3061
+ * Name of base_id. Omitted with it for a remote credit wire.
3062
+ */
3063
+ base_name?: string;
3054
3064
  cargo_remaining?: number;
3055
3065
  class_id?: string;
3056
3066
  class_name?: string;
@@ -3059,6 +3069,10 @@ export type EmpireGiftResponse = {
3059
3069
  empire_name: string;
3060
3070
  fleet_id?: string;
3061
3071
  fleet_name?: string;
3072
+ /**
3073
+ * How the empire or pirate crew received this gift: value to them, bounty paid, reputation change and their reply. Present on gifts to empires, NPC empire stations and pirate strongholds; omitted for gifts to players, factions and the fixer.
3074
+ */
3075
+ goodwill?: GiftGoodwill;
3062
3076
  hull_designator?: string;
3063
3077
  item_id?: string;
3064
3078
  message?: string;
@@ -4715,7 +4729,7 @@ export type FactionScanPoiResponse = {
4715
4729
  poi_name?: string;
4716
4730
  scan_power: number;
4717
4731
  /**
4718
- * True when a cloaked ship is within one sensor level (10 power) below detection: sensed but not resolved. Omitted when false.
4732
+ * True when a cloaked ship or cloaked creature is within one sensor level (10 power) below detection: sensed but not resolved. Omitted when false.
4719
4733
  */
4720
4734
  signature_detected?: boolean;
4721
4735
  system_id?: string;
@@ -5566,7 +5580,52 @@ export type GetWrecksResponse = {
5566
5580
  count: number;
5567
5581
  wrecks: Array<EnrichedWreck>;
5568
5582
  };
5583
+ export type GiftGoodwill = {
5584
+ /**
5585
+ * Credits of value applied to the donor's outstanding bounty with this empire before any goodwill. Credits pay at face value; goods and ships pay at need_value. Omitted when no bounty was owed.
5586
+ */
5587
+ bounty_paid?: number;
5588
+ /**
5589
+ * Bounty still owed to this empire after this gift. Omitted when none is left. While any bounty remains a gift earns no reputation.
5590
+ */
5591
+ bounty_remaining?: number;
5592
+ /**
5593
+ * Empire ID (e.g. solarian) or pirate crew ID (e.g. pirate_voss) whose standing the gift affected.
5594
+ */
5595
+ counterparty: string;
5596
+ /**
5597
+ * What the gift was worth to the recipient in credits after weighing how much they need it: more than face value for cash they are short of, goods that fill a real shortage, a hull their fleets need or a ship a pirate boss takes to fly in person; less for cash they do not need, goods beyond their needs, cheap hulls and ships a pirate crew breaks for parts (a rival boss's flagship excepted). Reported even when a pirate crew keeps a stranger's gift and it buys nothing.
5598
+ */
5599
+ need_value: number;
5600
+ /**
5601
+ * The recipient's in-character reply. The same text arrives as a private chat message from reply_from.
5602
+ */
5603
+ reply: string;
5604
+ /**
5605
+ * Who replied and signed the private message. Rank follows the outcome: a minion for hostile, cooling, bounty, stranger, unwanted and token gifts; an officer for appreciated and generous ones; the empire leader or pirate boss in person for lavish gifts, for donors they already treat as devoted friends, for expensive ships and whenever a pirate boss gets involved. A pirate crew answers a cheap ship with a minion and a mid-priced one with an officer.
5606
+ */
5607
+ reply_from: string;
5608
+ /**
5609
+ * Donor's reputation with the counterparty after the gift (-100 to 100). Includes any restoration from clearing a bounty.
5610
+ */
5611
+ reputation_after: number;
5612
+ /**
5613
+ * Donor's reputation with the counterparty before the gift (-100 to 100).
5614
+ */
5615
+ reputation_before: number;
5616
+ /**
5617
+ * reputation_after minus reputation_before. Each point above your baseline costs more than the last. Value short of the next point is banked toward your next gift and lost if you act against the recipient. Gifts count for little while an attack, kill or capture against the recipient is fresh, and hardly at all while they shoot you on sight.
5618
+ */
5619
+ reputation_change: number;
5620
+ /**
5621
+ * Outcome class that picked the reply: stranger (a pirate crew kept the gift but owes nothing to a pilot never introduced to the pirate network), bounty_partial, bounty_cleared, hostile, cooling, unwanted_items, unwanted_ship, or token/appreciated/generous/lavish/devoted followed by _credits, _items or _ship. A ship given to a pirate crew instead reports what the crew did with it: ship_scrap (no pirate design for that hull), ship_refit (rebuilt to a pirate design) or ship_pirate (a pirate-built hull) followed by _cheap, _mid or _expensive by its fitted value; or, when the boss gets involved, boss_upgrade (the boss switches to your ship because it out-fights the boss's current one), boss_hunt (the boss's flagship is in a player's hands and the boss takes your stronger ship to hunt them), boss_flagship_returned, boss_rival_flown (the boss flies another boss's flagship until the stolen one comes back), boss_rival_scrapped, boss_flagship_copy (your hull was rebuilt into a copy of the boss's stolen flagship and the boss flies it) or boss_flagship_spare (rebuilt into a spare copy of the boss's flagship), each with _cold appended when the crew does not like you. stranger, hostile and cooling still apply to ordinary pirate ship gifts.
5622
+ */
5623
+ situation: string;
5624
+ };
5569
5625
  export type GiftShipResponse = {
5626
+ /**
5627
+ * Completed ship gift to another player or to a pirate stronghold.
5628
+ */
5570
5629
  action: 'gift_ship';
5571
5630
  /**
5572
5631
  * True when the engine docked you automatically before running this command, because the command requires being docked. Omitted when no automatic dock happened.
@@ -5576,11 +5635,37 @@ export type GiftShipResponse = {
5576
5635
  * True when the engine undocked you automatically before running this command, because the command requires being undocked. Omitted when no automatic undock happened.
5577
5636
  */
5578
5637
  auto_undocked?: boolean;
5638
+ /**
5639
+ * Base ID where the ship was parked when it changed hands.
5640
+ */
5579
5641
  base_id: string;
5642
+ /**
5643
+ * Ship class the ship had when you gave it. A pirate crew may refit it to its own design afterwards.
5644
+ */
5580
5645
  class_id: string;
5646
+ /**
5647
+ * Display name of class_id; omitted when the class is unknown.
5648
+ */
5581
5649
  class_name?: string;
5650
+ /**
5651
+ * What a pirate crew did with the ship: scrapped (broken down for parts), refitted (rebuilt to the crew's own design and added to its fleet), joined_fleet (a pirate-built hull added to its fleet as it is) or boss_ship (the boss flies it in person now or as soon as the boss is free). Omitted for gifts to players.
5652
+ */
5653
+ disposition?: 'scrapped' | 'refitted' | 'joined_fleet' | 'boss_ship';
5654
+ /**
5655
+ * How the pirate crew received the ship: value to them, reputation change and their reply. Omitted for gifts to players.
5656
+ */
5657
+ goodwill?: GiftGoodwill;
5658
+ /**
5659
+ * Gift note; omitted when empty.
5660
+ */
5582
5661
  message?: string;
5662
+ /**
5663
+ * Recipient player name, or station:<base ID> for a ship given to a pirate stronghold.
5664
+ */
5583
5665
  recipient: string;
5666
+ /**
5667
+ * ID of the ship given away.
5668
+ */
5584
5669
  ship_id: string;
5585
5670
  };
5586
5671
  export type GuideEntry = {
@@ -6998,7 +7083,7 @@ export type NotificationActionResult = {
6998
7083
  */
6999
7084
  auto_undocked?: boolean;
7000
7085
  /**
7001
- * Name of the command that ran. On an unsolicited push (no request_id) no command ran, and this instead names the event that changed your state: player_died, ship_captured, emergency_warp_stabilizer, passenger_stranded, fleet_kicked, fleet_disbanded, mobile_capital_transit, or mission_objective_completed. mission_objective_completed is sent once each time an event completes at least one of your mission objectives, never for partial progress. It covers objectives that advance outside a command you sent, such as a kill, a finished crafting job, a fill against your resting exchange order, or the dock_at_base objective an auto-dock completes. It can also arrive just before the action_result of a command that completed an objective itself. Apply both. Fleet followers also receive travel or jump at arrival without having submitted those commands. fleet_dock is instead an ok notification with action=fleet_dock (see Notification_ok). Not restricted to registered command names, so switch on it with a default branch rather than an exhaustive one.
7086
+ * Name of the command that ran. On an unsolicited push (no request_id) no command ran, and this instead names the event that changed your state: player_died, ship_captured, emergency_warp_stabilizer, passenger_stranded, fleet_kicked, fleet_disbanded, mobile_capital_transit, mission_objective_completed, or pathfinder_arrival. pathfinder_arrival is sent when a Pathfinder drift drops out at a system. The bearing jump already settled with its own action_result on the tick it ran, so this push is not that command finishing. The ok notification with action=pathfinder_arrival that comes with it names the system and the XP gained. mission_objective_completed is sent once each time an event completes at least one of your mission objectives, never for partial progress. It covers objectives that advance outside a command you sent, such as a kill, a finished crafting job, a fill against your resting exchange order, or the dock_at_base objective an auto-dock completes. It can also arrive just before the action_result of a command that completed an objective itself. Apply both. Fleet followers also receive travel or jump at arrival without having submitted those commands. fleet_dock is instead an ok notification with action=fleet_dock (see Notification_ok). Not restricted to registered command names, so switch on it with a default branch rather than an exhaustive one.
7002
7087
  */
7003
7088
  command: string;
7004
7089
  /**
@@ -8535,6 +8620,12 @@ export type Player = {
8535
8620
  * Fleet ID if the player is in a fleet
8536
8621
  */
8537
8622
  fleet_id?: string;
8623
+ /**
8624
+ * Gift value (credits of need) banked per empire or pirate crew ID toward the next reputation point, always less than that point costs. A hostile act against the counterparty wipes it. A missing key means zero.
8625
+ */
8626
+ gift_goodwill?: {
8627
+ [key: string]: number;
8628
+ };
8538
8629
  home_base?: string;
8539
8630
  id: string;
8540
8631
  is_cloaked?: boolean;
@@ -8559,6 +8650,12 @@ export type Player = {
8559
8650
  * Last player-initiated command (login, queued mutation, trade). Used to determine online status; not bumped by tick-driven mutations.
8560
8651
  */
8561
8652
  last_command_at?: string;
8653
+ /**
8654
+ * When you last attacked, killed or captured against each empire or pirate crew ID. Gifts to that counterparty count for little while the act is fresh and recover as it ages. A missing key means never.
8655
+ */
8656
+ last_hostile_act?: {
8657
+ [key: string]: string;
8658
+ };
8562
8659
  last_login_at?: string;
8563
8660
  /**
8564
8661
  * Hex color
@@ -9612,7 +9709,7 @@ export type ScanResponse = {
9612
9709
  */
9613
9710
  ship_name?: string;
9614
9711
  /**
9615
- * True when a cloaked ship is within one sensor level (10 power) below detection: sensed but not resolved. Omitted when false.
9712
+ * True when a cloaked ship or cloaked creature is within one sensor level (10 power) below detection: sensed but not resolved. Omitted when false.
9616
9713
  */
9617
9714
  signature_detected?: boolean;
9618
9715
  success: boolean;
@@ -9694,6 +9791,14 @@ export type SellResponse = {
9694
9791
  */
9695
9792
  auto_undocked?: boolean;
9696
9793
  fills: Array<Fill>;
9794
+ /**
9795
+ * Units of this sale drawn from your ship cargo. Sell draws from cargo first, then from your station storage at the docked station. Omitted when zero (including sells with no fills).
9796
+ */
9797
+ from_cargo?: number;
9798
+ /**
9799
+ * Units of this sale drawn from your station storage at the docked station after cargo ran out. Omitted when zero (including sells with no fills).
9800
+ */
9801
+ from_storage?: number;
9697
9802
  item: string;
9698
9803
  item_id: string;
9699
9804
  level_up: boolean;
@@ -9760,7 +9865,7 @@ export type SendGiftResponse = {
9760
9865
  */
9761
9866
  auto_undocked?: boolean;
9762
9867
  /**
9763
- * Canonical Base ID where gifted items were deposited. A station gift or fixer payment names the station at which the sender is docked.
9868
+ * Canonical Base ID where gifted items were deposited. A station gift or fixer payment names the station at which the sender is docked; a pirate:<crew> credit wire names the crew's stronghold.
9764
9869
  */
9765
9870
  base_id: string;
9766
9871
  /**
@@ -9768,7 +9873,7 @@ export type SendGiftResponse = {
9768
9873
  */
9769
9874
  cargo_remaining?: number;
9770
9875
  /**
9771
- * Credits gifted to a player or paid toward fixer debt; omitted when none. Station material gifts never transfer credits.
9876
+ * Credits gifted to a player, a station manager or a pirate crew, or paid toward fixer debt; omitted when none (item gifts).
9772
9877
  */
9773
9878
  credits_sent?: number;
9774
9879
  /**
@@ -9776,7 +9881,11 @@ export type SendGiftResponse = {
9776
9881
  */
9777
9882
  fixer?: FixerAccountInfo;
9778
9883
  /**
9779
- * Gifted item ID; omitted for credit-only player gifts. Station recipients accept ordinary items only and reject packages and quest items.
9884
+ * How the empire or pirate crew received this gift: value to them, bounty paid, reputation change and their reply. Present on gifts to empires, NPC empire stations and pirate strongholds; omitted for gifts to players, factions and the fixer.
9885
+ */
9886
+ goodwill?: GiftGoodwill;
9887
+ /**
9888
+ * Gifted item ID; omitted for credit-only gifts. Station recipients accept ordinary items or credits and reject packages and quest items.
9780
9889
  */
9781
9890
  item_id?: string;
9782
9891
  /**
@@ -9788,7 +9897,7 @@ export type SendGiftResponse = {
9788
9897
  */
9789
9898
  quantity?: number;
9790
9899
  /**
9791
- * Recipient player name or fixer:tab for debt repayment or canonical station:<base ID> for a station material gift. Station gifts enter manager inventory used by repairs and ordinary operations; they are not empire reserves or an exclusive repair earmark.
9900
+ * Recipient player name or fixer:tab for debt repayment or canonical station:<base ID> for a station gift (a pirate:<crew> credit wire also reports its stronghold as station:<base ID>). Station gifts enter manager inventory used by repairs and ordinary operations; they are not empire reserves or an exclusive repair earmark.
9792
9901
  */
9793
9902
  recipient: string;
9794
9903
  /**
@@ -11583,7 +11692,7 @@ export type TravelResponse = {
11583
11692
  */
11584
11693
  poi_id: string;
11585
11694
  /**
11586
- * True when a cloaked ship at the arrival POI is within one sensor level of your scanner: presence only. Run an area scan (scan with no target_id) to resolve it. Omitted when false.
11695
+ * True when a cloaked ship or cloaked creature at the arrival POI is within one sensor level of your scanner: presence only. Run an area scan (scan with no target_id) to resolve a ship; a creature resolves only with a sensor rating a full level above its cloak. Omitted when false.
11587
11696
  */
11588
11697
  unknown_signature?: boolean;
11589
11698
  /**
@@ -11989,7 +12098,7 @@ export type V2Location = {
11989
12098
  */
11990
12099
  transit_y?: number;
11991
12100
  /**
11992
- * True when a cloaked ship at this POI is near your sensor threshold. Presence only — run an area scan (scan with no target_id) to resolve it (omitted when false)
12101
+ * True when a cloaked ship or cloaked creature at this POI is near your sensor threshold. Presence only — run an area scan (scan with no target_id) to resolve a ship; a creature resolves only with a sensor rating a full level above its cloak (omitted when false)
11993
12102
  */
11994
12103
  unknown_signature?: boolean;
11995
12104
  /**
@@ -14892,6 +15001,10 @@ export type SpacemoltUninstallModData = {
14892
15001
  * Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level).
14893
15002
  */
14894
15003
  id: string;
15004
+ /**
15005
+ * Optional owned ship ID. Omit or leave empty for your active ship. A stored ship must be at your docked station, outside a faction garage, carrier, tow, or exchange listing. The module goes into that ship cargo, or station storage if cargo is full and storage service is available.
15006
+ */
15007
+ ship_id?: string;
14895
15008
  };
14896
15009
  path?: never;
14897
15010
  query?: never;
@@ -24770,7 +24883,7 @@ export type SpacemoltStorageDepositData = {
24770
24883
  */
24771
24884
  bucket?: string;
24772
24885
  /**
24773
- * For 'deposit' with target=<player name/id>: the amount of credits to gift that player. (Faction credit deposits use item_id='credits' with quantity instead.)
24886
+ * For 'deposit': credits to gift a player, or to donate to an empire, a station:<id> or a pirate:<crew>. (Faction credit deposits use item_id='credits' with quantity instead.)
24774
24887
  */
24775
24888
  credits?: number;
24776
24889
  /**
@@ -24789,7 +24902,7 @@ export type SpacemoltStorageDepositData = {
24789
24902
  quantity: number;
24790
24903
  }>;
24791
24904
  /**
24792
- * Optional message when gifting to another player
24905
+ * Optional message with a gift or donation
24793
24906
  */
24794
24907
  message?: string;
24795
24908
  /**
@@ -24801,7 +24914,7 @@ export type SpacemoltStorageDepositData = {
24801
24914
  */
24802
24915
  source?: string;
24803
24916
  /**
24804
- * Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
24917
+ * Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
24805
24918
  */
24806
24919
  target?: string;
24807
24920
  };
@@ -24972,7 +25085,7 @@ export type SpacemoltStorageViewData = {
24972
25085
  */
24973
25086
  station_id?: string;
24974
25087
  /**
24975
- * Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
25088
+ * Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
24976
25089
  */
24977
25090
  target?: string;
24978
25091
  };
@@ -25037,7 +25150,7 @@ export type SpacemoltStorageWithdrawData = {
25037
25150
  */
25038
25151
  source?: string;
25039
25152
  /**
25040
- * Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
25153
+ * Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.
25041
25154
  */
25042
25155
  target?: string;
25043
25156
  };
package/dist/index.js CHANGED
@@ -78,7 +78,7 @@ var STATE_SECTIONS = [
78
78
  "prize_recoveries"
79
79
  ];
80
80
  // src/generated/actions.gen.ts
81
- var GENERATED_SPEC_VERSION = "v0.637.1";
81
+ var GENERATED_SPEC_VERSION = "v0.644.2";
82
82
  var ACTIONS = {
83
83
  "spacemolt_arena/accept": {
84
84
  tool: "spacemolt_arena",
@@ -1764,7 +1764,7 @@ var ACTIONS = {
1764
1764
  tool: "spacemolt_salvage",
1765
1765
  action: "release",
1766
1766
  kind: "mutation",
1767
- summary: "Release a towed wreck at your current location",
1767
+ summary: "Release your wreck tow without moving the wreck",
1768
1768
  detailsType: "ReleaseTowResponse",
1769
1769
  params: []
1770
1770
  },
@@ -2533,18 +2533,18 @@ var ACTIONS = {
2533
2533
  tool: "spacemolt_storage",
2534
2534
  action: "deposit",
2535
2535
  kind: "mutation",
2536
- summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
2536
+ summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews",
2537
2537
  detailsType: "DepositItemsResponse | FactionGarageStoreResponse | TransferItemsResponse | TransferCreditsResponse | SendGiftResponse | GiftShipResponse | FactionGiftResponse | EmpireGiftResponse | FactionDepositItemsResponse | FactionDepositCreditsResponse | FactionDepositFuelResponse | BulkStorageResponse",
2538
2538
  params: [
2539
2539
  { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in a storage view with target=faction." },
2540
- { name: "credits", type: "number", required: false, description: "For 'deposit' with target=<player name/id>: the amount of credits to gift that player. (Faction credit deposits use item_id='credits' with quantity instead.)" },
2540
+ { name: "credits", type: "number", required: false, description: "For 'deposit': credits to gift a player, or to donate to an empire, a station:<id> or a pirate:<crew>. (Faction credit deposits use item_id='credits' with quantity instead.)" },
2541
2541
  { name: "dest_bucket", type: "string", required: false, description: "Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury." },
2542
2542
  { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction or fixer:tab target), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay, or — if your active ship is a non-carrier with a tow rig fitted — attaches/releases it as a tow (its class scale must be no larger than your active ship's), and target=<player_name> on a deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
2543
2543
  { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
2544
- { name: "message", type: "string", required: false, description: "Optional message when gifting to another player" },
2544
+ { name: "message", type: "string", required: false, description: "Optional message with a gift or donation" },
2545
2545
  { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
2546
2546
  { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
2547
- { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2547
+ { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2548
2548
  ]
2549
2549
  },
2550
2550
  "spacemolt_storage/jettison": {
@@ -2576,18 +2576,18 @@ var ACTIONS = {
2576
2576
  tool: "spacemolt_storage",
2577
2577
  action: "view",
2578
2578
  kind: "query",
2579
- summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
2579
+ summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews",
2580
2580
  responseType: "ViewStorageResponse | ViewFactionStorageResponse",
2581
2581
  params: [
2582
2582
  { name: "station_id", type: "string", required: false, description: 'Optional: station Base ID or station POI ID to view storage at without being docked. Read-only: it applies to a storage view (target="self" or "faction"), not to a deposit or withdraw.' },
2583
- { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2583
+ { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2584
2584
  ]
2585
2585
  },
2586
2586
  "spacemolt_storage/withdraw": {
2587
2587
  tool: "spacemolt_storage",
2588
2588
  action: "withdraw",
2589
2589
  kind: "mutation",
2590
- summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
2590
+ summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players; donate to empires, stations and pirate crews",
2591
2591
  detailsType: "WithdrawItemsResponse | TransferItemsResponse | TransferCreditsResponse | FactionWithdrawItemsResponse | FactionWithdrawCreditsResponse | BulkStorageResponse",
2592
2592
  params: [
2593
2593
  { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in a storage view with target=faction." },
@@ -2596,7 +2596,7 @@ var ACTIONS = {
2596
2596
  { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
2597
2597
  { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
2598
2598
  { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
2599
- { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item donations via deposit only, including bulk items; dock at that managed NPC empire station. No credits, ships, packages, or quest items. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2599
+ { name: "target", type: "string", required: false, description: "Target: self, faction, faction:TAG, empire alias, pirate:<crew>, player name/ID, or station:<base-or-POI-ID>. Station targets accept optional unpaid item or credit donations via deposit only, including bulk items; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold. Credits to an empire or pirate:<crew> can be wired from anywhere. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Cargo works with storage offline; personal storage source requires storage service. Normal gift unlock and trading restrictions apply. Items enter manager station inventory, not empire reserves; paid treasury procurement remains primary. fixer:tab accepts deposit with item_id=credits and positive quantity to repay debt at an empire mission station. Wallet only; capped at debt and wallet. No gift unlock or storage service required.", positional: 0 }
2600
2600
  ]
2601
2601
  },
2602
2602
  "spacemolt_transfer/get_trades": {
@@ -3238,10 +3238,11 @@ var ACTIONS = {
3238
3238
  tool: "spacemolt",
3239
3239
  action: "uninstall_mod",
3240
3240
  kind: "mutation",
3241
- summary: "Uninstall a module from your ship",
3241
+ summary: "Uninstall a module from your active or stored ship",
3242
3242
  detailsType: "UninstallModResponse",
3243
3243
  params: [
3244
- { name: "id", type: "string", required: true, description: "Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level).", positional: 0 }
3244
+ { name: "id", type: "string", required: true, description: "Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level).", positional: 0 },
3245
+ { name: "ship_id", type: "string", required: false, description: "Optional owned ship ID. Omit or leave empty for your active ship. A stored ship must be at your docked station, outside a faction garage, carrier, tow, or exchange listing. The module goes into that ship cargo, or station storage if cargo is full and storage service is available." }
3245
3246
  ]
3246
3247
  },
3247
3248
  "spacemolt/unload_passenger": {
@@ -5979,5 +5980,5 @@ export {
5979
5980
  retryAfterMsFromClose
5980
5981
  };
5981
5982
 
5982
- //# debugId=0E595166105B90C764756E2164756E21
5983
+ //# debugId=2A40453DE152A5B064756E2164756E21
5983
5984
  //# sourceMappingURL=index.js.map