@spacemolt/lib 17.2.0 → 17.2.1

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.700.0`). **312 commands across 19 tools.**
4
+ Every command in `@spacemolt/lib`, generated from the live server spec (`v0.707.0`). **312 commands across 19 tools.**
5
5
 
6
6
  ## How to call a command
7
7
 
package/README.md CHANGED
@@ -220,8 +220,9 @@ handshake, on by default) is a fallback underneath the batching, in case
220
220
  something unexpected still trips the cap (e.g. other traffic sharing the IP).
221
221
  This is the path to reach for.
222
222
 
223
- Reconnect is close-code-aware: a `session_replaced` (someone else logged in as
224
- that player) or a deliberate `close()` is terminal; transient drops reconnect
223
+ Reconnect is close-code-aware: a `session_replaced` (the player opened one
224
+ connection more than the 4 the server allows per account, and this was the
225
+ oldest) or a deliberate `close()` is terminal; transient drops reconnect
225
226
  with backoff and restore subscriptions.
226
227
 
227
228
  ### Getting a Clerk API key
@@ -1,5 +1,5 @@
1
1
  /** The gameserver spec version this command surface was generated from. */
2
- export declare const GENERATED_SPEC_VERSION = "v0.700.0";
2
+ export declare const GENERATED_SPEC_VERSION = "v0.707.0";
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" | "fit_preview" | "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_gate_site" | "found_station" | "garages" | "generator" | "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" | "interact_poi" | "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_gate_access" | "set_home" | "set_market_fee" | "set_name" | "set_output_price" | "set_public" | "set_refuel_price" | "set_repair_price" | "set_service_access" | "set_status" | "set_toll" | "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 {
@@ -325,7 +325,7 @@ export interface SpacemoltFacilitySetDescriptionParams {
325
325
  description?: string;
326
326
  }
327
327
  export interface SpacemoltFacilitySetGateAccessParams {
328
- /** Access level for set_service_access; public or faction for set_gate_access */
328
+ /** Access level for set_service_access; public, allies or faction for set_gate_access */
329
329
  access: "public" | "allies" | "faction";
330
330
  }
331
331
  export interface SpacemoltFacilitySetMarketFeeParams {
@@ -357,7 +357,7 @@ export interface SpacemoltFacilitySetRepairPriceParams {
357
357
  price?: number;
358
358
  }
359
359
  export interface SpacemoltFacilitySetServiceAccessParams {
360
- /** Access level for set_service_access; public or faction for set_gate_access */
360
+ /** Access level for set_service_access; public, allies or faction for set_gate_access */
361
361
  access: "public" | "allies" | "faction";
362
362
  /** Service type for set_service_access (market, refuel, repair, shipyard, crafting, salvage_yard, missions) */
363
363
  service: string;
@@ -1213,7 +1213,7 @@ export interface SpacemoltSocialGetChatHistoryParams {
1213
1213
  limit?: number;
1214
1214
  /** Chat channel to get history for (system, local, faction, private, emergency) */
1215
1215
  target: "system" | "local" | "faction" | "private" | "emergency";
1216
- /** Player ID or username for a specific conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you. */
1216
+ /** Player ID or username, or the sender_id of an empire or NPC authority DM (such as the Interstellar Revenue Service), for one conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you. */
1217
1217
  target_id?: string;
1218
1218
  }
1219
1219
  export interface SpacemoltSocialGetNotesParams {
@@ -961,6 +961,10 @@ export type Base = {
961
961
  * Present only when this outpost is one end of a player-built jump gate; omitted otherwise. The owning faction's station info action describes it in full.
962
962
  */
963
963
  gate?: {
964
+ /**
965
+ * True when only the owning faction and its allies may cross; omitted otherwise
966
+ */
967
+ allies_only?: boolean;
964
968
  /**
965
969
  * True when only the owning faction may cross; omitted when public
966
970
  */
@@ -3880,6 +3884,10 @@ export type FacilityEntry = {
3880
3884
  * Station service this facility provides to everyone docked here, for example market, repair, refuel, shipyard, storage, crafting, missions, salvage_yard, personnel, marine_training, medical or police. Omitted when the facility provides no station service.
3881
3885
  */
3882
3886
  service?: string;
3887
+ /**
3888
+ * Game ticks left until construction finishes. Present only on player_facilities and faction_facilities entries while under_construction is true; omitted otherwise.
3889
+ */
3890
+ ticks_until_complete?: number;
3883
3891
  /**
3884
3892
  * True for a dining or leisure venue whose upkeep stock and labor scale with recent paying guests instead of a fixed bill; see maintenance_per_cycle and labor_per_cycle. Omitted means false.
3885
3893
  */
@@ -4933,6 +4941,10 @@ export type FactionOwnedFacilityEntry = {
4933
4941
  rental_fee_per_run?: number;
4934
4942
  repair_complete_tick?: number;
4935
4943
  system_id?: string;
4944
+ /**
4945
+ * Game ticks left until construction finishes. Present only while under_construction is true; omitted otherwise.
4946
+ */
4947
+ ticks_until_complete?: number;
4936
4948
  type: string;
4937
4949
  under_construction?: boolean;
4938
4950
  };
@@ -6018,6 +6030,10 @@ export type GaragedShipEntry = {
6018
6030
  ship_id: string;
6019
6031
  };
6020
6032
  export type GateStatus = {
6033
+ /**
6034
+ * True when only the owning faction and its allies may cross. Omitted otherwise.
6035
+ */
6036
+ allies_only?: boolean;
6021
6037
  /**
6022
6038
  * True when this end is built.
6023
6039
  */
@@ -8168,6 +8184,7 @@ export type Module = {
8168
8184
  * Percentage points subtracted from hostile sensor-dampener reach reduction. Fitted bonuses stack up to the combat resistance cap.
8169
8185
  */
8170
8186
  targeting_resistance?: number;
8187
+ telescope_grade?: number;
8171
8188
  tow_speed_penalty?: number;
8172
8189
  tracking_bonus?: number;
8173
8190
  type: string;
@@ -8308,7 +8325,7 @@ export type NotificationActionError = {
8308
8325
  tick: number;
8309
8326
  };
8310
8327
  /**
8311
- * A state update from the server. Two producers send it. A queued action that completed on a later tick 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. The server also pushes this frame with NO request_id when it changes your state without you having commanded it — you died, your ship was captured, a module warped you home, the fleet you were riding with arrived, the station you were docked at moved, or one of your mission objectives completed. Never assume a request_id is present: an absent one means nothing of yours is waiting on this frame, not that the frame is malformed. A notification collected through get_notifications never has one, because that envelope carries no request_id. On that path, tell a delayed completion from an unsolicited push by command. A registered command name (mine, dock, buy) is a completion. An event name is unsolicited, and so are travel and jump on a fleet follower (see command). A death or a capture arrives as two notifications. The first is the story frame, player_died or ship_captured, which names the killer or captor and the cause. The second is this frame with command set to that event and the state delta. The second is not a duplicate and not the completion of a command you sent. Apply the delta. Read the story frame for the cause. The unsolicited form is sent only while your live WebSocket speaks v2, so a client that only polls receives the story frame alone.
8328
+ * A state update from the server. Two producers send it. A queued action that completed on a later tick 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. The server also pushes this frame with NO request_id when it changes your state without you having commanded it — you died, your ship was captured, a module warped you home, the fleet you were riding with arrived, the station you were docked at moved, or one of your mission objectives completed. Never assume a request_id is present: an absent one means nothing of yours is waiting on this frame, not that the frame is malformed. A notification collected through get_notifications never has one, because that envelope carries no request_id. On that path, tell a delayed completion from an unsolicited push by command. A registered command name (mine, dock, buy) is a completion. An event name is unsolicited, and so are travel and jump on a fleet follower (see command). Over WebSocket, a registered command name with no request_id is an action that another connection of your account sent. A death or a capture arrives as two notifications. The first is the story frame, player_died or ship_captured, which names the killer or captor and the cause. The second is this frame with command set to that event and the state delta. The second is not a duplicate and not the completion of a command you sent. Apply the delta. Read the story frame for the cause. The unsolicited form is sent only while every live WebSocket of your account speaks v2, so a client that only polls receives the story frame alone.
8312
8329
  */
8313
8330
  export type NotificationActionResult = {
8314
8331
  /**
@@ -9774,6 +9791,10 @@ export type OwnedFacilityEntry = {
9774
9791
  rental_fee_per_run?: number;
9775
9792
  repair_complete_tick?: number;
9776
9793
  system_id?: string;
9794
+ /**
9795
+ * Game ticks left until construction finishes. Present only while under_construction is true; omitted otherwise.
9796
+ */
9797
+ ticks_until_complete?: number;
9777
9798
  type: string;
9778
9799
  under_construction?: boolean;
9779
9800
  };
@@ -10682,7 +10703,7 @@ export type PlayerStats = {
10682
10703
  */
10683
10704
  gate_crossings?: number;
10684
10705
  /**
10685
- * Jump gate ends you founded with build_gate_site. Omitted until the first.
10706
+ * Jump gate ends you founded with found_gate_site (v1: build_gate_site). Omitted until the first.
10686
10707
  */
10687
10708
  gate_sites_founded?: number;
10688
10709
  gifts_received?: number;
@@ -12997,6 +13018,20 @@ export type SovereignMintStatus = {
12997
13018
  */
12998
13019
  status: 'blocked_inputs' | 'blocked_internal' | 'price_limited';
12999
13020
  };
13021
+ export type StarSighting = {
13022
+ /**
13023
+ * Compass bearing to the star in degrees, in the convention of a numeric jump bearing.
13024
+ */
13025
+ bearing: number;
13026
+ /**
13027
+ * Apparent brightness of the star from the current position. Higher is brighter.
13028
+ */
13029
+ brightness: number;
13030
+ /**
13031
+ * Surface temperature read from the light of the star, in kelvin.
13032
+ */
13033
+ temperature: number;
13034
+ };
13000
13035
  export type StationConfigResponse = {
13001
13036
  /**
13002
13037
  * The station action that ran, lower-cased. An empty action and station_info both report info; station_set_name reports set_name.
@@ -14514,6 +14549,10 @@ export type V2Location = {
14514
14549
  */
14515
14550
  resources: Array<V2Resource>;
14516
14551
  security_status: string;
14552
+ /**
14553
+ * Stars a fitted telescope resolves from the current position, brightest first. Present only in get_location; omitted when the ship has no working telescope or none is in view.
14554
+ */
14555
+ star_sightings?: Array<StarSighting>;
14517
14556
  system_id: string;
14518
14557
  system_name: string;
14519
14558
  /**
@@ -14737,7 +14776,7 @@ export type V2Response = {
14737
14776
  */
14738
14777
  code?: string;
14739
14778
  /**
14740
- * Optional structured details about the error. Always an object; its keys vary by error code. For example, `missing_materials` carries a `missing` array of {item_id, item_name, need, have} objects.
14779
+ * Optional structured details about the error. Always an object; its keys vary by error code. For example, `missing_materials` carries a `missing` array of {item_id, item_name, need, have} objects, and a `safe_passage` refusal from attack or battle carries grantor_id, faction_id, system_id, granted_tick, until_tick and source.
14741
14780
  */
14742
14781
  details?: {
14743
14782
  [key: string]: unknown;
@@ -14906,6 +14945,14 @@ export type V2Ship = {
14906
14945
  * Fit crew required for full operational efficiency
14907
14946
  */
14908
14947
  minimum_crew: number;
14948
+ /**
14949
+ * CPU the fitted modules draw before the engineering efficiency bonus
14950
+ */
14951
+ module_cpu: number;
14952
+ /**
14953
+ * Power the fitted modules draw before the engineering efficiency bonus
14954
+ */
14955
+ module_power: number;
14909
14956
  /**
14910
14957
  * Display name of the ship (custom name if set, otherwise the class name)
14911
14958
  */
@@ -20863,7 +20910,7 @@ export type SpacemoltFacilitySetDescriptionResponse = SpacemoltFacilitySetDescri
20863
20910
  export type SpacemoltFacilitySetGateAccessData = {
20864
20911
  body?: {
20865
20912
  /**
20866
- * Access level for set_service_access; public or faction for set_gate_access
20913
+ * Access level for set_service_access; public, allies or faction for set_gate_access
20867
20914
  */
20868
20915
  access: 'public' | 'allies' | 'faction';
20869
20916
  };
@@ -21123,7 +21170,7 @@ export type SpacemoltFacilitySetRepairPriceResponse = SpacemoltFacilitySetRepair
21123
21170
  export type SpacemoltFacilitySetServiceAccessData = {
21124
21171
  body?: {
21125
21172
  /**
21126
- * Access level for set_service_access; public or faction for set_gate_access
21173
+ * Access level for set_service_access; public, allies or faction for set_gate_access
21127
21174
  */
21128
21175
  access: 'public' | 'allies' | 'faction';
21129
21176
  /**
@@ -27210,7 +27257,7 @@ export type SpacemoltSocialGetChatHistoryData = {
27210
27257
  */
27211
27258
  target: 'system' | 'local' | 'faction' | 'private' | 'emergency';
27212
27259
  /**
27213
- * Player ID or username for a specific conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you.
27260
+ * Player ID or username, or the sender_id of an empire or NPC authority DM (such as the Interstellar Revenue Service), for one conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you.
27214
27261
  */
27215
27262
  target_id?: string;
27216
27263
  };
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.700.0";
81
+ var GENERATED_SPEC_VERSION = "v0.707.0";
82
82
  var ACTIONS = {
83
83
  "spacemolt_arena/accept": {
84
84
  tool: "spacemolt_arena",
@@ -862,7 +862,7 @@ var ACTIONS = {
862
862
  summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
863
863
  detailsType: "StationConfigResponse",
864
864
  params: [
865
- { name: "access", type: '"public" | "allies" | "faction"', required: true, description: "Access level for set_service_access; public or faction for set_gate_access", enumValues: ["public", "allies", "faction"] }
865
+ { name: "access", type: '"public" | "allies" | "faction"', required: true, description: "Access level for set_service_access; public, allies or faction for set_gate_access", enumValues: ["public", "allies", "faction"] }
866
866
  ]
867
867
  },
868
868
  "spacemolt_facility/set_market_fee": {
@@ -934,7 +934,7 @@ var ACTIONS = {
934
934
  summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
935
935
  detailsType: "StationConfigResponse",
936
936
  params: [
937
- { name: "access", type: '"public" | "allies" | "faction"', required: true, description: "Access level for set_service_access; public or faction for set_gate_access", enumValues: ["public", "allies", "faction"] },
937
+ { name: "access", type: '"public" | "allies" | "faction"', required: true, description: "Access level for set_service_access; public, allies or faction for set_gate_access", enumValues: ["public", "allies", "faction"] },
938
938
  { name: "service", type: "string", required: true, description: "Service type for set_service_access (market, refuel, repair, shipyard, crafting, salvage_yard, missions)" }
939
939
  ]
940
940
  },
@@ -2492,7 +2492,7 @@ var ACTIONS = {
2492
2492
  { name: "before", type: "string", required: false, description: "RFC3339 timestamp for cursor-based pagination - get messages before this time" },
2493
2493
  { name: "limit", type: "number", required: false, description: "Max messages to return (default 50, max 100)" },
2494
2494
  { name: "target", type: '"system" | "local" | "faction" | "private" | "emergency"', required: true, description: "Chat channel to get history for (system, local, faction, private, emergency)", enumValues: ["system", "local", "faction", "private", "emergency"], positional: 0 },
2495
- { name: "target_id", type: "string", required: false, description: "Player ID or username for a specific conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you." }
2495
+ { name: "target_id", type: "string", required: false, description: "Player ID or username, or the sender_id of an empire or NPC authority DM (such as the Interstellar Revenue Service), for one conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you." }
2496
2496
  ]
2497
2497
  },
2498
2498
  "spacemolt_social/get_notes": {
@@ -6077,5 +6077,5 @@ export {
6077
6077
  retryAfterMsFromClose
6078
6078
  };
6079
6079
 
6080
- //# debugId=6C9A8FADF74B7E5C64756E2164756E21
6080
+ //# debugId=9967D9D35468DB2264756E2164756E21
6081
6081
  //# sourceMappingURL=index.js.map