@spacemolt/lib 12.0.0 → 12.2.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`v0.543.1`). **280 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.547.0`). **281 commands across 18 tools.**
 
 ## How to call a command
 
@@ -25,7 +25,7 @@ const status = await account.commands.spacemolt.get_status();  // query
 - [`spacemolt_battle`](#spacemolt_battle) — 9 commands
 - [`spacemolt_citizenship`](#spacemolt_citizenship) — 4 commands
 - [`spacemolt_drone`](#spacemolt_drone) — 8 commands
-- [`spacemolt_facility`](#spacemolt_facility) — 51 commands
+- [`spacemolt_facility`](#spacemolt_facility) — 52 commands
 - [`spacemolt_faction`](#spacemolt_faction) — 28 commands
 - [`spacemolt_faction_admin`](#spacemolt_faction_admin) — 6 commands
 - [`spacemolt_faction_commerce`](#spacemolt_faction_commerce) — 2 commands
@@ -170,6 +170,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `cancel_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityCancelListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `deploy_outpost({ name: string })` · *mutation* → delta.details: `BuildBaseResponse` — Deploy a lightweight, members-only faction outpost at your current point of interest in lawless space
 - `dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `dismantle_outpost()` · *mutation* → delta.details: `DismantleOutpostResponse` — Dismantle a faction outpost you're docked at, packing it back into an Outpost Kit
 - `facility_set_description({ description?: string; facility_id: string })` · *query* → `SetFacilityDescriptionResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_build({ bucket?: string; facility_type: string; package_ids?: string[]; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)

package/README.md

@@ -95,6 +95,19 @@ await account.mutate('spacemolt', 'jump', { id: 'sol' });
 await account.send('spacemolt', 'jump', { id: 'sol' }); // auto-routes query/mutation
 ```
 
+Every one of those takes an optional trailing `requestId`. The server echoes it
+back on the response, so you can correlate your own in-flight requests:
+
+```ts
+await account.commands.spacemolt.jump({ id: 'sol' }, 'my-id-1');
+await account.query('spacemolt', 'get_status', undefined, 'my-id-2');
+await account.mutate('spacemolt', 'mine', undefined, undefined, 'my-id-3');
+```
+
+Omit it and the library picks one. Give each request a new id: an id that is
+already in flight is refused with a `duplicate_request_id` error, and an id you
+reuse after its request timed out can settle on the wrong response.
+
 ### Local state cache
 
 Seeded from `get_status` after auth and updated from the delta on every

package/dist/account.d.ts

@@ -256,7 +256,7 @@ export declare class Account {
      * to take long, so a response that never arrives (the server silently
      * drops it rather than erroring) fails cleanly instead of hanging forever.
      */
-    query(tool: string, action: string, payload?: Record<string, unknown>): Promise<QueryResult>;
+    query(tool: string, action: string, payload?: Record<string, unknown>, requestId?: string): Promise<QueryResult>;
     /**
      * Run a mutation; resolves when the action executes on a later tick (after
      * the immediate pending ack). `onAck` fires when the pending ack arrives.
@@ -273,7 +273,7 @@ export declare class Account {
      * every other mutation — `mine`, `craft`, etc. — settles within the tick it
      * was queued on and gets the much shorter `fastMutationTimeoutMs`.
      */
-    mutate(tool: string, action: string, payload?: Record<string, unknown>, onAck?: (ack: MutationAck) => void): Promise<MutationResult>;
+    mutate(tool: string, action: string, payload?: Record<string, unknown>, onAck?: (ack: MutationAck) => void, requestId?: string): Promise<MutationResult>;
     /**
      * Waits for a mutation's outcome with two-phase timeout protection. The
      * pending ack (`result` frame) is a synchronous validation step with no
@@ -292,7 +292,7 @@ export declare class Account {
      * Run a command, dispatching to `query`/`mutate` based on the spec's
      * `x-is-mutation` classification. Unknown commands are treated as queries.
      */
-    send(tool: string, action: string, payload?: Record<string, unknown>): Promise<QueryResult | MutationResult>;
+    send(tool: string, action: string, payload?: Record<string, unknown>, requestId?: string): Promise<QueryResult | MutationResult>;
     /**
      * Listen for a specific server push by msg_type. The handler receives the
      * typed payload for published notification types, or a loosely-typed object
@@ -391,6 +391,18 @@ export declare class Account {
     private beginAuth;
     private sendFrame;
     private nextRequestId;
+    /**
+     * Pick the `request_id` for one frame. A caller-supplied id is echoed by the
+     * server unchanged, which is the point — it lets the caller correlate its own
+     * in-flight requests. An empty id is treated as no id, because the server
+     * drops falsy ids and the request would then hang until it timed out.
+     *
+     * A caller-supplied id must be unique for the life of the connection, not
+     * only while it is in flight. Reusing a live id is refused here. Reusing an
+     * id whose request timed out is not detected, and a late frame for the first
+     * request then settles the second one with the wrong outcome.
+     */
+    private claimRequestId;
     private routeFrame;
     private warnMalformedFrame;
     private handleClose;

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

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