@spacemolt/lib 11.4.0 → 11.5.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.530.1`). **278 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.532.0`). **278 commands across 18 tools.**
 
 ## How to call a command
 
@@ -162,18 +162,18 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `ban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
 - `base_cost()` · *query* → `BaseCostResponse` — Preview the cost and requirements to found a faction station
 - `browse_for_sale({ facility_type?: string; max_price?: number })` · *query* → `FacilityBrowseForSaleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `build({ bucket?: string; facility_type: string })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `build({ bucket?: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityBuyListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_ship_license({ ship_class: string })` · *mutation* → delta.details: `ShipLicenseResponse` — License a specific ship design so your faction can build it at its own stations
 - `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)
 - `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; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — 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)
 - `faction_list()` · *query* → `FacilityFactionListResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_owned()` · *query* → `FacilityFactionOwnedResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `found_station({ name: string; public_access?: boolean })` · *mutation* → delta.details: `BuildBaseResponse` — Found a faction-owned station at your current point of interest in lawless space
 - `job_add({ deliver_to?: string; direction?: "forward" | "reverse"; facility_id: string; items?: { item_id: string; quantity: number }[]; label?: string; package_id?: string; quantity?: number; recipe_id: string; source?: string; target?: string })` · *mutation* → delta.details: `CraftJobResponse | PackageJobResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_cancel({ job_id?: string; job_ids?: string[] })` · *mutation* → delta.details: `JobCancelResponse | BulkJobCancelResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
@@ -206,7 +206,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `transfer({ direction: "to_faction" | "to_player"; facility_id: string; player_id?: string })` · *mutation* → delta.details: `FacilityTransferResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `types({ category?: "infrastructure" | "service" | "production" | "faction" | "personal"; facility_type?: string; level?: number; name?: string; page?: number; per_page?: number })` · *query* → `FacilityTypeDiscoveryResponse | FacilityTypeListResponse | FacilityTypeDetailResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `unban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
-- `upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `upgrades()` · *query* → `FacilityUpgradesResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 
 ## spacemolt_faction

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

@@ -1,5 +1,5 @@
 /** The gameserver spec version this command surface was generated from. */
-export declare const GENERATED_SPEC_VERSION = "v0.530.1";
+export declare const GENERATED_SPEC_VERSION = "v0.532.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_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 {

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

@@ -125,6 +125,8 @@ export interface SpacemoltFacilityBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityBuyListingParams {
     /** For 'buy_listing' and 'cancel_listing': the facility listing ID. Use action 'browse_for_sale' to see listings. */
@@ -157,6 +159,8 @@ export interface SpacemoltFacilityFactionBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
     /** For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system. */
     species?: string;
 }
@@ -171,6 +175,8 @@ export interface SpacemoltFacilityFactionUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityFoundStationParams {
     /** Name for the new faction station */
@@ -354,6 +360,8 @@ export interface SpacemoltFacilityUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFactionAdminCreateRoleParams {
     /** Role name */

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

@@ -1429,6 +1429,7 @@ export type DepositItemsResponse = {
     cargo_remaining: number;
     cargo_space: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_total: number;
 };
@@ -4718,6 +4719,10 @@ export type Player = {
     };
     stats?: PlayerStats;
     status_message?: string;
+    /**
+     * ID of own ship currently being towed via a tow rig, empty if not towing a ship
+     */
+    towing_ship_id?: string;
     /**
      * ID of wreck currently being towed, empty if not towing
      */
@@ -6729,6 +6734,10 @@ export type V2GameState = {
             [key: string]: unknown;
         };
         status_message?: string;
+        /**
+         * ID of this player's own ship currently under tow via a tow rig (omitted when not towing a ship)
+         */
+        towing_ship_id?: string;
         /**
          * ID of the wreck this player is currently towing (omitted when not towing)
          */
@@ -7134,6 +7143,7 @@ export type WithdrawItemsResponse = {
     cargo_space: number;
     cargo_total: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_remaining: number;
 };
@@ -10973,6 +10983,10 @@ export type SpacemoltFacilityBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -11235,6 +11249,10 @@ export type SpacemoltFacilityFactionBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
         /**
          * For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system.
          */
@@ -11381,6 +11399,10 @@ export type SpacemoltFacilityFactionUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -12717,6 +12739,10 @@ export type SpacemoltFacilityUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.530.1";
+var GENERATED_SPEC_VERSION = "v0.532.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -362,7 +362,8 @@ var ACTIONS = {
     detailsType: "FacilityBuildResponse | FacilityFactionBuildResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/buy_listing": {
@@ -435,6 +436,7 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." },
       { name: "species", type: "string", required: false, description: "For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system." }
     ]
   },
@@ -473,7 +475,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/found_station": {
@@ -827,7 +830,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/upgrades": {

package/package.json

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