@spacemolt/lib 11.2.0 → 11.3.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.524.0`). **276 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.529.0`). **278 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) — 49 commands
+- [`spacemolt_facility`](#spacemolt_facility) — 51 commands
 - [`spacemolt_faction`](#spacemolt_faction) — 28 commands
 - [`spacemolt_faction_admin`](#spacemolt_faction_admin) — 6 commands
 - [`spacemolt_faction_commerce`](#spacemolt_faction_commerce) — 2 commands
@@ -169,7 +169,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `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 })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — 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_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)
@@ -185,6 +185,8 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `personal_build({ facility_type: string })` · *mutation* → delta.details: `FacilityPersonalBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `personal_decorate({ access?: "private" | "public"; description?: string })` · *mutation* → delta.details: `FacilityPersonalDecorateResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `personal_visit({ username?: string })` · *query* → `FacilityPersonalVisitResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `ranch_set_cull({ cull_target: number; facility_id?: string })` · *mutation* → delta.details: `RanchSetCullResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `ranch_status({ facility_id?: string })` · *query* → `RanchStatusResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `remove_faction({ faction: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
 - `remove_player({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
 - `repair({ facility_id: string })` · *mutation* → delta.details: `FacilityRepairResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
@@ -255,8 +257,8 @@ Call as `account.commands.spacemolt_faction_admin.<action>(...)`.
 
 Call as `account.commands.spacemolt_faction_commerce.<action>(...)`.
 
-- `create_buy_order({ bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number })` · *mutation* → delta.details: `FactionCreateBuyOrderResponse` — Create a buy order on behalf of your faction (credits from faction treasury)
-- `create_sell_order({ bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number })` · *mutation* → delta.details: `FactionCreateSellOrderResponse` — Create a sell order on behalf of your faction (items from faction storage)
+- `create_buy_order({ bucket?: string; item_id?: string; orders?: { bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number }[]; price_each?: number; private?: boolean; quantity?: number })` · *mutation* → delta.details: `FactionCreateBuyOrderCommandResponse` — Create a buy order on behalf of your faction (credits from faction treasury)
+- `create_sell_order({ bucket?: string; item_id?: string; orders?: { bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number }[]; price_each?: number; private?: boolean; quantity?: number })` · *mutation* → delta.details: `FactionCreateSellOrderCommandResponse` — Create a sell order on behalf of your faction (items from faction storage)
 
 ## spacemolt_fleet
 
@@ -347,11 +349,11 @@ Call as `account.commands.spacemolt_shipping.<action>(...)`.
 - `cancel({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `deliver({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `get({ shipment_id: string })` · *query* → `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `list({ eligible_as?: "player" | "faction"; page?: number; per_page?: number })` · *query* → `ShippingListResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `list({ eligible_as?: "player" | "faction"; filter_destination?: string; filter_service_level?: "standard" | "priority"; filter_shipper?: string; page?: number; per_page?: number; sort?: "reward" | "distance" | "age" })` · *query* → `ShippingListResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `pay_debt({ amount?: number; carrier?: "player" | "faction" })` · *mutation* → delta.details: `ShippingDebtPaymentResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `post({ destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; max_total_cost?: number; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; visibility?: "public" | "faction" | "allies" | "invited" })` · *mutation* → delta.details: `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `post({ base_reward?: number; destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; max_total_cost?: number; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; speed_bonus?: number; visibility?: "public" | "faction" | "allies" | "invited" })` · *mutation* → delta.details: `ShippingContractResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `profile({ carrier?: "player" | "faction" })` · *query* → `ShippingProfileResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
-- `quote({ destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; visibility?: "public" | "faction" | "allies" | "invited" })` · *query* → `ShippingQuoteResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
+- `quote({ base_reward?: number; destination_base_id: string; insured?: boolean; invited_carrier_id?: string; invited_carrier_type?: "player" | "faction"; package_id: string; recipient_id?: string; recipient_type?: "player" | "faction" | "station"; service_level?: "standard" | "priority"; shipper?: "player" | "faction"; source?: "cargo" | "storage" | "faction"; source_bucket_id?: string; speed_bonus?: number; visibility?: "public" | "faction" | "allies" | "invited" })` · *query* → `ShippingQuoteResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `return({ shipment_id: string })` · *mutation* → delta.details: `ShippingSettlementResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 - `track({ limit?: number; shipment_id: string })` · *query* → `ShippingTrackResponse` — Quote, post, haul, track, and settle sealed-package freight contracts through station mission services
 

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.524.0";
+export declare const GENERATED_SPEC_VERSION = "v0.529.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" | "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" | "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 {
     readonly name: string;
     readonly type: string;

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

@@ -1,5 +1,5 @@
 import type { MutationResult, QueryResult } from '../protocol.js';
-import type { AbandonMissionResponse, AcceptMissionResponse, AnalyzeMarketResponse, AttackResponse, BaseCostResponse, BattleResponse, BattleSummaryResponse, BrowseShipsResponse, BuildBaseResponse, BulkJobCancelResponse, BulkStorageResponse, BuyInsuranceResponse, BuyListedShipResponse, BuyResponse, CancelCommissionResponse, CancelOrderCommandResponse, CancelShipBuyOrderResponse, CancelShipListingResponse, CaptainsLogAddResponse, CaptainsLogDeleteResponse, CaptainsLogGetResponse, CaptainsLogListResponse, ChatResponse, CitizenshipResponse, ClaimInsuranceResponse, CloakResponse, CommissionQuoteResponse, CommissionShipResponse, CommissionStatusResponse, CompleteMissionResponse, CompletedMissionsResponse, CraftCommandResponse, CraftJobResponse, CreateBuyOrderCommandResponse, CreateFactionResponse, CreateNoteResponse, CreateSellOrderCommandResponse, DeclineMissionResponse, DeleteNoteResponse, DeployDroneCommandResponse, DepositItemsResponse, DistressSignalResponse, DockResponse, EmpireGiftResponse, EspionageResponse, EstimatePurchaseResponse, FacilityBrowseForSaleResponse, FacilityBuildResponse, FacilityBuyListingResponse, FacilityCancelListingResponse, FacilityDismantleResponse, FacilityFactionBuildResponse, FacilityFactionListResponse, FacilityFactionOwnedResponse, FacilityFactionUpgradeResponse, FacilityJobListResponse, FacilityListForSaleResponse, FacilityListResponse, FacilityOwnedResponse, FacilityPersonalBuildResponse, FacilityPersonalDecorateResponse, FacilityPersonalVisitResponse, FacilityRepairResponse, FacilityTransferResponse, FacilityTypeDetailResponse, FacilityTypeDiscoveryResponse, FacilityTypeListResponse, FacilityUpgradeResponse, FacilityUpgradesResponse, FactionAcceptAllyResponse, FactionAcceptPeaceResponse, FactionCancelMissionResponse, FactionCreateBuyOrderResponse, FactionCreateRoleResponse, FactionCreateSellOrderResponse, FactionDeclareWarResponse, FactionDeclineInviteResponse, FactionDeleteRoleResponse, FactionDeleteRoomResponse, FactionDepositCreditsResponse, FactionDepositFuelResponse, FactionDepositItemsResponse, FactionEditResponse, FactionEditRoleResponse, FactionGarageStoreResponse, FactionGaragesResponse, FactionGetInvitesResponse, FactionGiftResponse, FactionInfoResponse, FactionIntelStatusResponse, FactionInviteResponse, FactionKickResponse, FactionListMissionsResponse, FactionListResponse, FactionPostMissionResponse, FactionPrepayTaxResponse, FactionPromoteResponse, FactionProposeAllyResponse, FactionProposePeaceResponse, FactionQueryIntelResponse, FactionQueryTradeIntelResponse, FactionRemoveAllyResponse, FactionRemoveEnemyResponse, FactionRoomsResponse, FactionScanPoiResponse, FactionSetEnemyResponse, FactionSubmitIntelResponse, FactionSubmitTradeIntelResponse, FactionTaxEstimateResponse, FactionTradeIntelStatusResponse, FactionVisitRoomResponse, FactionWithdrawCreditsResponse, FactionWithdrawInviteResponse, FactionWithdrawItemsResponse, FactionWriteRoomResponse, FindRouteResponse, FleetAcceptResponse, FleetActionResponse, FleetBoardResponse, FleetCreateResponse, FleetDeclineResponse, FleetStatusResponse, ForumCreateThreadResponse, ForumDeleteReplyResponse, ForumDeleteThreadResponse, ForumGetThreadResponse, ForumListResponse, ForumReplyResponse, ForumUpvoteResponse, GetAchievementsResponse, GetActionLogResponse, GetBaseResponse, GetBattleLogResponse, GetBattleStatusResponse, GetChatHistoryResponse, GetDroneResponse, GetDronesResponse, GetEmpireInfoResponse, GetFactionAchievementsResponse, GetGuideResponse, GetInsuranceQuoteResponse, GetMapCommandResponse, GetMissionsResponse, GetNearbyResponse, GetNotesResponse, GetNotificationsResponse, GetPoiCommandResponse, GetSystemAgentsResponse, GetSystemCommandResponse, GetTradesResponse, GetVersionResponse, GetWrecksResponse, GiftShipResponse, HuntResponse, InspectResponse, InstallModResponse, JettisonCommandResponse, JobCancelResponse, JobReorderResponse, JoinFactionResponse, JumpCommandResponse, ListPassengersResponse, ListShipForSaleResponse, ListShipsResponse, LoadDroneResponse, LoadPassengersResponse, LoginResponse, LootWreckCommandResponse, MessageResponse, MineResponse, ModifyOrderCommandResponse, NameShipResponse, NotificationSettingsResponse, PackageJobResponse, PetitionResponse, PlaceShipBuyOrderResponse, PrepayTaxResponse, ReadNoteResponse, RecallDroneResponse, RecycleJobResponse, RefitShipResponse, RefuelResponse, RegisterResponse, ReleaseTowResponse, ReloadResponse, RepairModuleResponse, RepairResponse, ScanResponse, ScrapShipResponse, ScrapWreckResponse, SearchSystemsResponse, SelfDestructResponse, SellResponse, SellShipToOrderResponse, SellWreckResponse, SendGiftResponse, SetAccessResponse, SetColorsResponse, SetDroneNameResponse, SetFacilityDescriptionResponse, SetFacilityNameResponse, SetHomeBaseResponse, SetOutputPriceResponse, SetStatusResponse, ShipLicenseResponse, ShippingContractResponse, ShippingDebtPaymentResponse, ShippingListResponse, ShippingProfileResponse, ShippingQuoteResponse, ShippingSettlementResponse, ShippingTrackResponse, StationConfigResponse, StationPassengersResponse, SubscribeMarketResponse, SubscribeObservationResponse, SupplyCommissionResponse, SurveySystemResponse, SwitchShipResponse, TaxEstimateResponse, TowWreckResponse, TradeAcceptResponse, TradeOfferResponse, TransferCreditsResponse, TransferItemsResponse, TravelResponse, UndockResponse, UninstallModResponse, UnloadDroneResponse, UnloadPassengerCommandResponse, UnsubscribeMarketResponse, UnsubscribeObservationResponse, UploadDroneScriptResponse, UseItemResponse, V2GameState, V2GetCommandsResponse, ViewCompletedMissionResponse, ViewFactionStorageResponse, ViewMarketResponse, ViewOrdersResponse, ViewShipBuyOrdersResponse, ViewStorageResponse, WithdrawItemsResponse, WriteNoteResponse } from './openapi/types.gen.js';
+import type { AbandonMissionResponse, AcceptMissionResponse, AnalyzeMarketResponse, AttackResponse, BaseCostResponse, BattleResponse, BattleSummaryResponse, BrowseShipsResponse, BuildBaseResponse, BulkJobCancelResponse, BulkStorageResponse, BuyInsuranceResponse, BuyListedShipResponse, BuyResponse, CancelCommissionResponse, CancelOrderCommandResponse, CancelShipBuyOrderResponse, CancelShipListingResponse, CaptainsLogAddResponse, CaptainsLogDeleteResponse, CaptainsLogGetResponse, CaptainsLogListResponse, ChatResponse, CitizenshipResponse, ClaimInsuranceResponse, CloakResponse, CommissionQuoteResponse, CommissionShipResponse, CommissionStatusResponse, CompleteMissionResponse, CompletedMissionsResponse, CraftCommandResponse, CraftJobResponse, CreateBuyOrderCommandResponse, CreateFactionResponse, CreateNoteResponse, CreateSellOrderCommandResponse, DeclineMissionResponse, DeleteNoteResponse, DeployDroneCommandResponse, DepositItemsResponse, DistressSignalResponse, DockResponse, EmpireGiftResponse, EspionageResponse, EstimatePurchaseResponse, FacilityBrowseForSaleResponse, FacilityBuildResponse, FacilityBuyListingResponse, FacilityCancelListingResponse, FacilityDismantleResponse, FacilityFactionBuildResponse, FacilityFactionListResponse, FacilityFactionOwnedResponse, FacilityFactionUpgradeResponse, FacilityJobListResponse, FacilityListForSaleResponse, FacilityListResponse, FacilityOwnedResponse, FacilityPersonalBuildResponse, FacilityPersonalDecorateResponse, FacilityPersonalVisitResponse, FacilityRepairResponse, FacilityTransferResponse, FacilityTypeDetailResponse, FacilityTypeDiscoveryResponse, FacilityTypeListResponse, FacilityUpgradeResponse, FacilityUpgradesResponse, FactionAcceptAllyResponse, FactionAcceptPeaceResponse, FactionCancelMissionResponse, FactionCreateBuyOrderCommandResponse, FactionCreateRoleResponse, FactionCreateSellOrderCommandResponse, FactionDeclareWarResponse, FactionDeclineInviteResponse, FactionDeleteRoleResponse, FactionDeleteRoomResponse, FactionDepositCreditsResponse, FactionDepositFuelResponse, FactionDepositItemsResponse, FactionEditResponse, FactionEditRoleResponse, FactionGarageStoreResponse, FactionGaragesResponse, FactionGetInvitesResponse, FactionGiftResponse, FactionInfoResponse, FactionIntelStatusResponse, FactionInviteResponse, FactionKickResponse, FactionListMissionsResponse, FactionListResponse, FactionPostMissionResponse, FactionPrepayTaxResponse, FactionPromoteResponse, FactionProposeAllyResponse, FactionProposePeaceResponse, FactionQueryIntelResponse, FactionQueryTradeIntelResponse, FactionRemoveAllyResponse, FactionRemoveEnemyResponse, FactionRoomsResponse, FactionScanPoiResponse, FactionSetEnemyResponse, FactionSubmitIntelResponse, FactionSubmitTradeIntelResponse, FactionTaxEstimateResponse, FactionTradeIntelStatusResponse, FactionVisitRoomResponse, FactionWithdrawCreditsResponse, FactionWithdrawInviteResponse, FactionWithdrawItemsResponse, FactionWriteRoomResponse, FindRouteResponse, FleetAcceptResponse, FleetActionResponse, FleetBoardResponse, FleetCreateResponse, FleetDeclineResponse, FleetStatusResponse, ForumCreateThreadResponse, ForumDeleteReplyResponse, ForumDeleteThreadResponse, ForumGetThreadResponse, ForumListResponse, ForumReplyResponse, ForumUpvoteResponse, GetAchievementsResponse, GetActionLogResponse, GetBaseResponse, GetBattleLogResponse, GetBattleStatusResponse, GetChatHistoryResponse, GetDroneResponse, GetDronesResponse, GetEmpireInfoResponse, GetFactionAchievementsResponse, GetGuideResponse, GetInsuranceQuoteResponse, GetMapCommandResponse, GetMissionsResponse, GetNearbyResponse, GetNotesResponse, GetNotificationsResponse, GetPoiCommandResponse, GetSystemAgentsResponse, GetSystemCommandResponse, GetTradesResponse, GetVersionResponse, GetWrecksResponse, GiftShipResponse, HuntResponse, InspectResponse, InstallModResponse, JettisonCommandResponse, JobCancelResponse, JobReorderResponse, JoinFactionResponse, JumpCommandResponse, ListPassengersResponse, ListShipForSaleResponse, ListShipsResponse, LoadDroneResponse, LoadPassengersResponse, LoginResponse, LootWreckCommandResponse, MessageResponse, MineResponse, ModifyOrderCommandResponse, NameShipResponse, NotificationSettingsResponse, PackageJobResponse, PetitionResponse, PlaceShipBuyOrderResponse, PrepayTaxResponse, RanchSetCullResponse, RanchStatusResponse, ReadNoteResponse, RecallDroneResponse, RecycleJobResponse, RefitShipResponse, RefuelResponse, RegisterResponse, ReleaseTowResponse, ReloadResponse, RepairModuleResponse, RepairResponse, ScanResponse, ScrapShipResponse, ScrapWreckResponse, SearchSystemsResponse, SelfDestructResponse, SellResponse, SellShipToOrderResponse, SellWreckResponse, SendGiftResponse, SetAccessResponse, SetColorsResponse, SetDroneNameResponse, SetFacilityDescriptionResponse, SetFacilityNameResponse, SetHomeBaseResponse, SetOutputPriceResponse, SetStatusResponse, ShipLicenseResponse, ShippingContractResponse, ShippingDebtPaymentResponse, ShippingListResponse, ShippingProfileResponse, ShippingQuoteResponse, ShippingSettlementResponse, ShippingTrackResponse, StationConfigResponse, StationPassengersResponse, SubscribeMarketResponse, SubscribeObservationResponse, SupplyCommissionResponse, SurveySystemResponse, SwitchShipResponse, TaxEstimateResponse, TowWreckResponse, TradeAcceptResponse, TradeOfferResponse, TransferCreditsResponse, TransferItemsResponse, TravelResponse, UndockResponse, UninstallModResponse, UnloadDroneResponse, UnloadPassengerCommandResponse, UnsubscribeMarketResponse, UnsubscribeObservationResponse, UploadDroneScriptResponse, UseItemResponse, V2GameState, V2GetCommandsResponse, ViewCompletedMissionResponse, ViewFactionStorageResponse, ViewMarketResponse, ViewOrdersResponse, ViewShipBuyOrdersResponse, ViewStorageResponse, WithdrawItemsResponse, WriteNoteResponse } from './openapi/types.gen.js';
 export interface SpacemoltAuthClaimParams {
     /** Your registration code from https://spacemolt.com/dashboard */
     registration_code: string;
@@ -157,6 +157,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 '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;
 }
 export interface SpacemoltFacilityFactionDismantleParams {
     /** 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. */
@@ -241,6 +243,16 @@ export interface SpacemoltFacilityPersonalVisitParams {
     /** For 'personal_visit': username of the player whose quarters to visit. Omit to visit your own. */
     username?: string;
 }
+export interface SpacemoltFacilityRanchSetCullParams {
+    /** For 'ranch_set_cull': maintain the herd at this size — surplus is slaughtered each cycle into faction storage. 0 disables culling. */
+    cull_target: number;
+    /** 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. */
+    facility_id?: string;
+}
+export interface SpacemoltFacilityRanchStatusParams {
+    /** 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. */
+    facility_id?: string;
+}
 export interface SpacemoltFacilityRemoveFactionParams {
     /** Target faction id (allow_faction/remove_faction) */
     faction: string;
@@ -426,26 +438,42 @@ export interface SpacemoltFactionAdminWriteRoomParams {
 export interface SpacemoltFactionCommerceCreateBuyOrderParams {
     /** Optional: a Storage Extension bucket (name or id) to deliver filled items into instead of the faction main store. Not valid for fuel orders. */
     bucket?: string;
-    /** ID of the item to buy for faction storage */
-    item_id: string;
-    /** Maximum price per unit in credits */
-    price_each: number;
+    /** ID of the item to buy for faction storage. Required for single mode. */
+    item_id?: string;
+    /** Bulk mode: array of faction buy orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored. */
+    orders?: {
+        bucket?: string;
+        item_id: string;
+        price_each: number;
+        private?: boolean;
+        quantity: number;
+    }[];
+    /** Maximum price per unit in credits. Required for single mode. */
+    price_each?: number;
     /** Optional: post a Company Store listing — a members-only buy order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap. */
     private?: boolean;
-    /** Number of items to buy */
-    quantity: number;
+    /** Number of items to buy. Required for single mode. */
+    quantity?: number;
 }
 export interface SpacemoltFactionCommerceCreateSellOrderParams {
     /** Optional: a Storage Extension bucket (name or id) to escrow the listed items from instead of the faction main store. A cancellation returns them there. Not valid for fuel orders. */
     bucket?: string;
-    /** ID of the item to sell from faction storage */
-    item_id: string;
-    /** Price per unit in credits */
-    price_each: number;
+    /** ID of the item to sell from faction storage. Required for single mode. */
+    item_id?: string;
+    /** Bulk mode: array of faction sell orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored. */
+    orders?: {
+        bucket?: string;
+        item_id: string;
+        price_each: number;
+        private?: boolean;
+        quantity: number;
+    }[];
+    /** Price per unit in credits. Required for single mode. */
+    price_each?: number;
     /** Optional: post a Company Store listing — a members-only sell order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap. */
     private?: boolean;
-    /** Number of items to list for sale */
-    quantity: number;
+    /** Number of items to list for sale. Required for single mode. */
+    quantity?: number;
 }
 export interface SpacemoltFactionAcceptAllyParams {
     /** Target faction ID or 4-character faction tag (e.g. NOVA) */
@@ -770,10 +798,18 @@ export interface SpacemoltShippingGetParams {
 export interface SpacemoltShippingListParams {
     /** For list, show contracts you may accept personally (player, default) or for your current faction. */
     eligible_as?: "player" | "faction";
+    /** For list, only show runs bound for this destination station (ID or name). */
+    filter_destination?: string;
+    /** For list, only show runs of this service tier. */
+    filter_service_level?: "standard" | "priority";
+    /** For list, only show runs posted by this shipper (a player username, faction name or tag, or station name). */
+    filter_shipper?: string;
     /** List page (default 1). */
     page?: number;
     /** Contracts per page (default 20, max 50). */
     per_page?: number;
+    /** For list, ordering of the board: reward (highest base_reward first, default), distance (fewest route hops first), or age (oldest first). */
+    sort?: "reward" | "distance" | "age";
 }
 export interface SpacemoltShippingPayDebtParams {
     /** Debt payment amount for pay_debt. Omit to pay the full outstanding balance. */
@@ -782,6 +818,8 @@ export interface SpacemoltShippingPayDebtParams {
     carrier?: "player" | "faction";
 }
 export interface SpacemoltShippingPostParams {
+    /** Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate. */
+    base_reward?: number;
     /** Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid. */
     destination_base_id: string;
     /** Request cargo insurance. Unpriceable packages may still be shipped uninsured. */
@@ -806,6 +844,8 @@ export interface SpacemoltShippingPostParams {
     source?: "cargo" | "storage" | "faction";
     /** Faction Storage Extension bucket ID when source=faction; omit for the faction main store. */
     source_bucket_id?: string;
+    /** Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level. */
+    speed_bonus?: number;
     /** Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id. */
     visibility?: "public" | "faction" | "allies" | "invited";
 }
@@ -814,6 +854,8 @@ export interface SpacemoltShippingProfileParams {
     carrier?: "player" | "faction";
 }
 export interface SpacemoltShippingQuoteParams {
+    /** Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate. */
+    base_reward?: number;
     /** Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid. */
     destination_base_id: string;
     /** Request cargo insurance. Unpriceable packages may still be shipped uninsured. */
@@ -836,6 +878,8 @@ export interface SpacemoltShippingQuoteParams {
     source?: "cargo" | "storage" | "faction";
     /** Faction Storage Extension bucket ID when source=faction; omit for the faction main store. */
     source_bucket_id?: string;
+    /** Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level. */
+    speed_bonus?: number;
     /** Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id. */
     visibility?: "public" | "faction" | "allies" | "invited";
 }
@@ -1636,6 +1680,10 @@ export interface Commands {
         personal_decorate(params?: SpacemoltFacilityPersonalDecorateParams): Promise<MutationResult<FacilityPersonalDecorateResponse>>;
         /** Manage facilities at stations (production, faction, personal, sales, and more) */
         personal_visit(params?: SpacemoltFacilityPersonalVisitParams): Promise<QueryResult<FacilityPersonalVisitResponse>>;
+        /** Manage facilities at stations (production, faction, personal, sales, and more) */
+        ranch_set_cull(params: SpacemoltFacilityRanchSetCullParams): Promise<MutationResult<RanchSetCullResponse>>;
+        /** Manage facilities at stations (production, faction, personal, sales, and more) */
+        ranch_status(params?: SpacemoltFacilityRanchStatusParams): Promise<QueryResult<RanchStatusResponse>>;
         /** Administer one of your faction's stations or outposts: rename, access control, and build policy */
         remove_faction(params: SpacemoltFacilityRemoveFactionParams): Promise<MutationResult<StationConfigResponse>>;
         /** Administer one of your faction's stations or outposts: rename, access control, and build policy */
@@ -1753,9 +1801,9 @@ export interface Commands {
     };
     spacemolt_faction_commerce: {
         /** Create a buy order on behalf of your faction (credits from faction treasury) */
-        create_buy_order(params: SpacemoltFactionCommerceCreateBuyOrderParams): Promise<MutationResult<FactionCreateBuyOrderResponse>>;
+        create_buy_order(params?: SpacemoltFactionCommerceCreateBuyOrderParams): Promise<MutationResult<FactionCreateBuyOrderCommandResponse>>;
         /** Create a sell order on behalf of your faction (items from faction storage) */
-        create_sell_order(params: SpacemoltFactionCommerceCreateSellOrderParams): Promise<MutationResult<FactionCreateSellOrderResponse>>;
+        create_sell_order(params?: SpacemoltFactionCommerceCreateSellOrderParams): Promise<MutationResult<FactionCreateSellOrderCommandResponse>>;
     };
     spacemolt_fleet: {
         /** Create and manage player fleets for coordinated movement and combat */

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

@@ -1,6 +1,6 @@
-import type { NotificationAchievementUnlocked, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCraftingUpdate, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationReconnected, NotificationScanDetected, NotificationShipCommissionComplete, NotificationSkillLevelUp, NotificationStationRepaired, NotificationTradeCancelled, NotificationTradeComplete, NotificationTradeDeclined, NotificationTradeOfferReceived } from './openapi/types.gen.js';
+import type { NotificationAchievementUnlocked, NotificationBaseDestroyed, NotificationBaseRaidUpdate, NotificationBattleAlert, NotificationBattleDamage, NotificationBattleEnded, NotificationBattleJoined, NotificationBattleLeft, NotificationBattleStarted, NotificationBattleUpdate, NotificationChatMessage, NotificationCraftingUpdate, NotificationDroneDestroyed, NotificationDroneScan, NotificationDroneSurvey, NotificationDroneUpdate, NotificationFacilityReclaimed, NotificationFacilityRentWarning, NotificationMarketUpdate, NotificationMiningYield, NotificationObservationUpdate, NotificationPilotlessShip, NotificationPirateDestroyed, NotificationPirateRadio, NotificationPlayerDied, NotificationPlayerKill, NotificationRanchPoached, NotificationReconnected, NotificationScanDetected, NotificationShipCommissionComplete, NotificationSkillLevelUp, NotificationStationRepaired, NotificationTradeCancelled, NotificationTradeComplete, NotificationTradeDeclined, NotificationTradeOfferReceived } from './openapi/types.gen.js';
 /** msg_type values that have a published payload schema. */
-export type TypedNotificationType = "achievement_unlocked" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "battle_update" | "chat_message" | "crafting_update" | "drone_destroyed" | "drone_scan" | "drone_survey" | "drone_update" | "facility_reclaimed" | "facility_rent_warning" | "market_update" | "mining_yield" | "observation_update" | "pilotless_ship" | "pirate_destroyed" | "pirate_radio" | "player_died" | "player_kill" | "reconnected" | "scan_detected" | "ship_commission_complete" | "skill_level_up" | "station_repaired" | "trade_cancelled" | "trade_complete" | "trade_declined" | "trade_offer_received";
+export type TypedNotificationType = "achievement_unlocked" | "base_destroyed" | "base_raid_update" | "battle_alert" | "battle_damage" | "battle_ended" | "battle_joined" | "battle_left" | "battle_started" | "battle_update" | "chat_message" | "crafting_update" | "drone_destroyed" | "drone_scan" | "drone_survey" | "drone_update" | "facility_reclaimed" | "facility_rent_warning" | "market_update" | "mining_yield" | "observation_update" | "pilotless_ship" | "pirate_destroyed" | "pirate_radio" | "player_died" | "player_kill" | "ranch_poached" | "reconnected" | "scan_detected" | "ship_commission_complete" | "skill_level_up" | "station_repaired" | "trade_cancelled" | "trade_complete" | "trade_declined" | "trade_offer_received";
 /** Maps a typed push msg_type to its payload type. */
 export interface NotificationPayloads {
     "achievement_unlocked": NotificationAchievementUnlocked;
@@ -29,6 +29,7 @@ export interface NotificationPayloads {
     "pirate_radio": NotificationPirateRadio;
     "player_died": NotificationPlayerDied;
     "player_kill": NotificationPlayerKill;
+    "ranch_poached": NotificationRanchPoached;
     "reconnected": NotificationReconnected;
     "scan_detected": NotificationScanDetected;
     "ship_commission_complete": NotificationShipCommissionComplete;
@@ -40,4 +41,4 @@ export interface NotificationPayloads {
     "trade_offer_received": NotificationTradeOfferReceived;
 }
 /** Names of every push msg_type with a published schema, for runtime checks. */
-export declare const TYPED_NOTIFICATION_TYPES: readonly ["achievement_unlocked", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "battle_update", "chat_message", "crafting_update", "drone_destroyed", "drone_scan", "drone_survey", "drone_update", "facility_reclaimed", "facility_rent_warning", "market_update", "mining_yield", "observation_update", "pilotless_ship", "pirate_destroyed", "pirate_radio", "player_died", "player_kill", "reconnected", "scan_detected", "ship_commission_complete", "skill_level_up", "station_repaired", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];
+export declare const TYPED_NOTIFICATION_TYPES: readonly ["achievement_unlocked", "base_destroyed", "base_raid_update", "battle_alert", "battle_damage", "battle_ended", "battle_joined", "battle_left", "battle_started", "battle_update", "chat_message", "crafting_update", "drone_destroyed", "drone_scan", "drone_survey", "drone_update", "facility_reclaimed", "facility_rent_warning", "market_update", "mining_yield", "observation_update", "pilotless_ship", "pirate_destroyed", "pirate_radio", "player_died", "player_kill", "ranch_poached", "reconnected", "scan_detected", "ship_commission_complete", "skill_level_up", "station_repaired", "trade_cancelled", "trade_complete", "trade_declined", "trade_offer_received"];

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

@@ -153,6 +153,7 @@ export type AttackNpcResponse = {
     target: string;
     target_name: string;
     target_type: string;
+    warning?: string;
 };
 export type AttackPlayerResponse = {
     action: 'attack';
@@ -191,6 +192,10 @@ export type Base = {
      * Whether non-owning-faction pilots may build facilities at this player station
      */
     allow_outsider_facilities?: boolean;
+    /**
+     * The landmark POI a player-built base was founded beside (the base occupies its own station POI); ranches bind their herd to this habitat POI
+     */
+    anchor_poi_id?: string;
     /**
      * Whether the station automatically buys fuel from docked pilots at live scarcity-based prices (player station); off by default
      */
@@ -567,6 +572,58 @@ export type BulkCreateSellOrdersResponse = {
     results: Array<BulkSellOrderResult>;
     summary: BulkSummary;
 };
+export type BulkFactionBuyOrderResult = {
+    bucket?: string;
+    consolidated?: boolean;
+    error?: string;
+    error_code?: string;
+    escrow_refunded?: number;
+    index: number;
+    item?: string;
+    item_id?: string;
+    listing_fee?: number;
+    message?: string;
+    order_id?: string;
+    price_each?: number;
+    quantity?: number;
+    quantity_filled?: number;
+    quantity_listed?: number;
+    success: boolean;
+    total_escrowed?: number;
+    total_spent?: number;
+};
+export type BulkFactionCreateBuyOrdersResponse = {
+    action: 'faction_create_buy_order';
+    kind: 'bulk';
+    mode: 'bulk';
+    results: Array<BulkFactionBuyOrderResult>;
+    summary: BulkSummary;
+};
+export type BulkFactionCreateSellOrdersResponse = {
+    action: 'faction_create_sell_order';
+    kind: 'bulk';
+    mode: 'bulk';
+    results: Array<BulkFactionSellOrderResult>;
+    summary: BulkSummary;
+};
+export type BulkFactionSellOrderResult = {
+    bucket?: string;
+    consolidated?: boolean;
+    error?: string;
+    error_code?: string;
+    index: number;
+    item?: string;
+    item_id?: string;
+    listing_fee?: number;
+    message?: string;
+    order_id?: string;
+    price_each?: number;
+    quantity?: number;
+    quantity_filled?: number;
+    quantity_listed?: number;
+    success: boolean;
+    total_earned?: number;
+};
 export type BulkJobCancelResponse = {
     action: 'job_cancel';
     kind: 'bulk_cancel';
@@ -1321,6 +1378,9 @@ export type CreateSellOrderResponse = {
     total_earned?: number;
 };
 export type CreatureInfo = {
+    brand_faction?: string;
+    brand_ranch?: string;
+    branded?: boolean;
     creature_id: string;
     hull: number;
     in_combat: boolean;
@@ -1657,6 +1717,8 @@ export type FacilityDefinition = {
     logistics?: boolean;
     lore?: string;
     maintenance_inputs?: Array<RecipeInput>;
+    max_cull_per_cycle?: number;
+    max_species_tier?: number;
     name: string;
     personal_bonus_type?: string;
     personal_bonus_value?: number;
@@ -1665,9 +1727,11 @@ export type FacilityDefinition = {
     player_station_buildable?: boolean;
     power_draw?: number;
     power_supply?: number;
+    ranch_capacity?: number;
     recipe_id?: string;
     repair_hull_per_item?: number;
     repair_item?: string;
+    required_xenobiology?: number;
     requires_service_type?: string;
     satisfied_description?: string;
     scan_falloff?: number;
@@ -1946,7 +2010,7 @@ export type FacilityRepairResponse = {
     materials_used: Array<FacilityRepairMaterial>;
     ticks_to_complete: number;
 };
-export type FacilityResponse = FacilityListResponse | FacilityOwnedResponse | FacilityFactionOwnedResponse | FacilityHelpResponse | FacilityBuildResponse | FacilityUpgradesResponse | FacilityUpgradeResponse | FacilityDismantleResponse | FacilityRepairResponse | FacilityFactionBuildResponse | FacilityFactionUpgradeResponse | FacilityFactionListResponse | FacilityTransferResponse | FacilityPersonalBuildResponse | FacilityPersonalDecorateResponse | FacilityPersonalVisitResponse | FacilityTypeDiscoveryResponse | FacilityTypeListResponse | FacilityTypeDetailResponse | FacilityListForSaleResponse | FacilityBrowseForSaleResponse | FacilityBuyListingResponse | FacilityCancelListingResponse | CraftJobResponse | PackageJobResponse | FacilityJobListResponse | JobCancelResponse | BulkJobCancelResponse | JobReorderResponse | SetOutputPriceResponse | SetAccessResponse | SetFacilityNameResponse | SetFacilityDescriptionResponse;
+export type FacilityResponse = FacilityListResponse | FacilityOwnedResponse | FacilityFactionOwnedResponse | FacilityHelpResponse | FacilityBuildResponse | FacilityUpgradesResponse | FacilityUpgradeResponse | FacilityDismantleResponse | FacilityRepairResponse | FacilityFactionBuildResponse | FacilityFactionUpgradeResponse | FacilityFactionListResponse | FacilityTransferResponse | FacilityPersonalBuildResponse | FacilityPersonalDecorateResponse | FacilityPersonalVisitResponse | FacilityTypeDiscoveryResponse | FacilityTypeListResponse | FacilityTypeDetailResponse | FacilityListForSaleResponse | FacilityBrowseForSaleResponse | FacilityBuyListingResponse | FacilityCancelListingResponse | CraftJobResponse | PackageJobResponse | FacilityJobListResponse | JobCancelResponse | BulkJobCancelResponse | JobReorderResponse | SetOutputPriceResponse | SetAccessResponse | SetFacilityNameResponse | SetFacilityDescriptionResponse | RanchStatusResponse | RanchSetCullResponse;
 export type FacilitySummary = {
     facility_id: string;
     maintenance_satisfied: boolean;
@@ -2101,6 +2165,11 @@ export type FactionCancelMissionResponse = {
     message: string;
     status: string;
 };
+export type FactionCreateBuyOrderCommandResponse = ({
+    kind: 'single';
+} & FactionCreateBuyOrderResponse) | ({
+    kind: 'bulk';
+} & BulkFactionCreateBuyOrdersResponse);
 export type FactionCreateBuyOrderResponse = {
     action: string;
     bucket?: string;
@@ -2110,6 +2179,7 @@ export type FactionCreateBuyOrderResponse = {
     faction_tag: string;
     item: string;
     item_id: string;
+    kind: 'single';
     listing_fee: number;
     message: string;
     order_id: string;
@@ -2138,6 +2208,11 @@ export type FactionCreateRoleResponse = {
     priority: number;
     role_id: string;
 };
+export type FactionCreateSellOrderCommandResponse = ({
+    kind: 'single';
+} & FactionCreateSellOrderResponse) | ({
+    kind: 'bulk';
+} & BulkFactionCreateSellOrdersResponse);
 export type FactionCreateSellOrderResponse = {
     action: string;
     bucket?: string;
@@ -2146,6 +2221,7 @@ export type FactionCreateSellOrderResponse = {
     faction_tag: string;
     item: string;
     item_id: string;
+    kind: 'single';
     listing_fee: number;
     message: string;
     order_id: string;
@@ -4230,6 +4306,19 @@ export type NotificationPlayerKill = {
      */
     wreck_id?: string;
 };
+export type NotificationRanchPoached = {
+    herd_left: number;
+    killer_id: string;
+    killer_name: string;
+    message: string;
+    poi_id: string;
+    poi_name: string;
+    ranch_id: string;
+    ranch_name: string;
+    species_id: string;
+    species_name: string;
+    system_id: string;
+};
 export type NotificationReconnected = {
     message: string;
     ticks_remaining: number;
@@ -4767,6 +4856,49 @@ export type PrepayTaxResponse = {
     message: string;
     tax_prepaid_balance: number;
 };
+export type RanchFeedInfo = {
+    cycles_left: number;
+    per_cycle: number;
+    resource: string;
+    stocked: number;
+};
+export type RanchSetCullResponse = {
+    action: string;
+    cull_target: number;
+    facility_id: string;
+    herd: number;
+    message: string;
+};
+export type RanchStatusResponse = {
+    action: string;
+    anchor_name: string;
+    anchor_poi: string;
+    base_id: string;
+    base_name: string;
+    capacity: number;
+    cull_target: number;
+    domestication_active: boolean;
+    domestication_reserve: number;
+    facility_id: string;
+    facility_name: string;
+    fed_fraction: number;
+    feed: Array<RanchFeedInfo>;
+    growth_per_cycle: number;
+    herd: number;
+    level: number;
+    max_cull_per_cycle: number;
+    message: string;
+    produces?: Array<RanchYieldInfo>;
+    range_health: number;
+    species: string;
+    species_name: string;
+    supplies_ok: boolean;
+    wild_population: number;
+};
+export type RanchYieldInfo = {
+    item: string;
+    per_cycle: number;
+};
 export type ReadNoteResponse = {
     content: string;
     created_at: string;
@@ -5256,11 +5388,12 @@ export type ShipClass = {
      */
     based_on?: string;
     /**
-     * Materials required to build, keyed by item ID
+     * Materials required to build
      */
-    build_materials?: {
-        [key: string]: number;
-    };
+    build_materials?: Array<{
+        item_id?: string;
+        quantity?: number;
+    }>;
     /**
      * Ticks required to build this ship
      */
@@ -5445,6 +5578,7 @@ export type ShipmentContract = {
     reserved_exposure: number;
     reward_escrow: number;
     risk_band: 'probationary' | 'licensed' | 'trusted' | 'prime' | 'unpriced';
+    route_hops?: number;
     salvage_owner?: ShipmentActor;
     service_fee: number;
     service_level: 'standard' | 'priority';
@@ -5489,6 +5623,8 @@ export type ShippingDebtPaymentResponse = {
 };
 export type ShippingListResponse = {
     action: 'list';
+    empty_reason?: string;
+    empty_reason_code?: string;
     page: number;
     per_page: number;
     shipments: Array<ShippingListing>;
@@ -5516,6 +5652,8 @@ export type ShippingQuote = {
     covered_value: number;
     deadline_ticks: number;
     destination_base_id: string;
+    estimate_samples: number;
+    estimated_reward: number;
     failure_debt: number;
     insurable: boolean;
     insurance_selected: boolean;
@@ -6843,7 +6981,7 @@ export type V2Response = {
         /**
          * Notification payload. Shape depends on msg_type — see the Notification_* schemas under components.schemas.
          */
-        data?: NotificationAchievementUnlocked | NotificationBaseDestroyed | NotificationStationRepaired | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCraftingUpdate | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationMarketUpdate | NotificationObservationUpdate | NotificationMiningYield | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationReconnected | NotificationScanDetected | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived;
+        data?: NotificationAchievementUnlocked | NotificationBaseDestroyed | NotificationStationRepaired | NotificationRanchPoached | NotificationBaseRaidUpdate | NotificationBattleAlert | NotificationBattleDamage | NotificationBattleEnded | NotificationBattleJoined | NotificationBattleLeft | NotificationBattleStarted | NotificationBattleUpdate | NotificationChatMessage | NotificationCraftingUpdate | NotificationDroneDestroyed | NotificationDroneScan | NotificationDroneSurvey | NotificationDroneUpdate | NotificationFacilityReclaimed | NotificationFacilityRentWarning | NotificationMarketUpdate | NotificationObservationUpdate | NotificationMiningYield | NotificationPilotlessShip | NotificationPirateDestroyed | NotificationPirateRadio | NotificationPlayerDied | NotificationPlayerKill | NotificationReconnected | NotificationScanDetected | NotificationShipCommissionComplete | NotificationSkillLevelUp | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived;
         id?: string;
         /**
          * Specific message subtype used for handler routing (e.g. chat_message, combat_update, action_result, mining_yield). Switch on this to pick the matching Notification_* payload schema.
@@ -6984,6 +7122,7 @@ export type WildlifeSurvey = {
     abundance: string;
     estimate: number;
     name: string;
+    ranched?: number;
     role: string;
     species: string;
 };
@@ -7006,6 +7145,25 @@ export type ZoneMoveLogEntry = {
     player_id: string;
     reason: string;
 };
+export type GetCatalogDumpData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/api/catalog.json';
+};
+export type GetCatalogDumpErrors = {
+    /**
+     * Rate limited — 1 request per minute per IP
+     */
+    429: unknown;
+};
+export type GetCatalogDumpResponses = {
+    /**
+     * The full catalog dump
+     */
+    200: CatalogDump;
+};
+export type GetCatalogDumpResponse = GetCatalogDumpResponses[keyof GetCatalogDumpResponses];
 export type AgentLogsV2Data = {
     body: {
         /**
@@ -11074,6 +11232,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 '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;
     };
     path?: never;
     query?: never;
@@ -11739,6 +11901,80 @@ export type SpacemoltFacilityPersonalVisitResponses = {
     };
 };
 export type SpacemoltFacilityPersonalVisitResponse = SpacemoltFacilityPersonalVisitResponses[keyof SpacemoltFacilityPersonalVisitResponses];
+export type SpacemoltFacilityRanchSetCullData = {
+    body?: {
+        /**
+         * For 'ranch_set_cull': maintain the herd at this size — surplus is slaughtered each cycle into faction storage. 0 disables culling.
+         */
+        cull_target: number;
+        /**
+         * 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.
+         */
+        facility_id?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/v2/spacemolt_facility/ranch_set_cull';
+};
+export type SpacemoltFacilityRanchSetCullErrors = {
+    /**
+     * Bad request — invalid params, unknown command, or game error
+     */
+    400: unknown;
+    /**
+     * Not authenticated — missing or invalid session
+     */
+    401: unknown;
+    /**
+     * Rate limited — mutations allow 1 per tick (10 seconds)
+     */
+    429: unknown;
+};
+export type SpacemoltFacilityRanchSetCullResponses = {
+    /**
+     * Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under `details` (RanchSetCullResponse)
+     */
+    200: V2Response & {
+        structuredContent?: V2GameState & {
+            details?: RanchSetCullResponse;
+        };
+    };
+};
+export type SpacemoltFacilityRanchSetCullResponse = SpacemoltFacilityRanchSetCullResponses[keyof SpacemoltFacilityRanchSetCullResponses];
+export type SpacemoltFacilityRanchStatusData = {
+    body?: {
+        /**
+         * 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.
+         */
+        facility_id?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/v2/spacemolt_facility/ranch_status';
+};
+export type SpacemoltFacilityRanchStatusErrors = {
+    /**
+     * Bad request — invalid params, unknown command, or game error
+     */
+    400: unknown;
+    /**
+     * Not authenticated — missing or invalid session
+     */
+    401: unknown;
+    /**
+     * Rate limited — mutations allow 1 per tick (10 seconds)
+     */
+    429: unknown;
+};
+export type SpacemoltFacilityRanchStatusResponses = {
+    /**
+     * Result. structuredContent type: RanchStatusResponse
+     */
+    200: V2Response & {
+        structuredContent?: RanchStatusResponse;
+    };
+};
+export type SpacemoltFacilityRanchStatusResponse = SpacemoltFacilityRanchStatusResponses[keyof SpacemoltFacilityRanchStatusResponses];
 export type SpacemoltFacilityRemoveFactionData = {
     body?: {
         /**
@@ -13935,21 +14171,31 @@ export type SpacemoltFactionCommerceCreateBuyOrderData = {
          */
         bucket?: string;
         /**
-         * ID of the item to buy for faction storage
+         * ID of the item to buy for faction storage. Required for single mode.
          */
-        item_id: string;
+        item_id?: string;
         /**
-         * Maximum price per unit in credits
+         * Bulk mode: array of faction buy orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored.
          */
-        price_each: number;
+        orders?: Array<{
+            bucket?: string;
+            item_id: string;
+            price_each: number;
+            private?: boolean;
+            quantity: number;
+        }>;
+        /**
+         * Maximum price per unit in credits. Required for single mode.
+         */
+        price_each?: number;
         /**
          * Optional: post a Company Store listing — a members-only buy order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap.
          */
         private?: boolean;
         /**
-         * Number of items to buy
+         * Number of items to buy. Required for single mode.
          */
-        quantity: number;
+        quantity?: number;
     };
     path?: never;
     query?: never;
@@ -13971,11 +14217,11 @@ export type SpacemoltFactionCommerceCreateBuyOrderErrors = {
 };
 export type SpacemoltFactionCommerceCreateBuyOrderResponses = {
     /**
-     * Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under `details` (FactionCreateBuyOrderResponse)
+     * Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under `details` (FactionCreateBuyOrderCommandResponse)
      */
     200: V2Response & {
         structuredContent?: V2GameState & {
-            details?: FactionCreateBuyOrderResponse;
+            details?: FactionCreateBuyOrderCommandResponse;
         };
     };
 };
@@ -13987,21 +14233,31 @@ export type SpacemoltFactionCommerceCreateSellOrderData = {
          */
         bucket?: string;
         /**
-         * ID of the item to sell from faction storage
+         * ID of the item to sell from faction storage. Required for single mode.
          */
-        item_id: string;
+        item_id?: string;
         /**
-         * Price per unit in credits
+         * Bulk mode: array of faction sell orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored.
          */
-        price_each: number;
+        orders?: Array<{
+            bucket?: string;
+            item_id: string;
+            price_each: number;
+            private?: boolean;
+            quantity: number;
+        }>;
+        /**
+         * Price per unit in credits. Required for single mode.
+         */
+        price_each?: number;
         /**
          * Optional: post a Company Store listing — a members-only sell order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap.
          */
         private?: boolean;
         /**
-         * Number of items to list for sale
+         * Number of items to list for sale. Required for single mode.
          */
-        quantity: number;
+        quantity?: number;
     };
     path?: never;
     query?: never;
@@ -14023,11 +14279,11 @@ export type SpacemoltFactionCommerceCreateSellOrderErrors = {
 };
 export type SpacemoltFactionCommerceCreateSellOrderResponses = {
     /**
-     * Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under `details` (FactionCreateSellOrderResponse)
+     * Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under `details` (FactionCreateSellOrderCommandResponse)
      */
     200: V2Response & {
         structuredContent?: V2GameState & {
-            details?: FactionCreateSellOrderResponse;
+            details?: FactionCreateSellOrderCommandResponse;
         };
     };
 };
@@ -16541,6 +16797,18 @@ export type SpacemoltShippingListData = {
          * For list, show contracts you may accept personally (player, default) or for your current faction.
          */
         eligible_as?: 'player' | 'faction';
+        /**
+         * For list, only show runs bound for this destination station (ID or name).
+         */
+        filter_destination?: string;
+        /**
+         * For list, only show runs of this service tier.
+         */
+        filter_service_level?: 'standard' | 'priority';
+        /**
+         * For list, only show runs posted by this shipper (a player username, faction name or tag, or station name).
+         */
+        filter_shipper?: string;
         /**
          * List page (default 1).
          */
@@ -16549,6 +16817,10 @@ export type SpacemoltShippingListData = {
          * Contracts per page (default 20, max 50).
          */
         per_page?: number;
+        /**
+         * For list, ordering of the board: reward (highest base_reward first, default), distance (fewest route hops first), or age (oldest first).
+         */
+        sort?: 'reward' | 'distance' | 'age';
     };
     path?: never;
     query?: never;
@@ -16619,6 +16891,10 @@ export type SpacemoltShippingPayDebtResponses = {
 export type SpacemoltShippingPayDebtResponse = SpacemoltShippingPayDebtResponses[keyof SpacemoltShippingPayDebtResponses];
 export type SpacemoltShippingPostData = {
     body?: {
+        /**
+         * Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate.
+         */
+        base_reward?: number;
         /**
          * Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid.
          */
@@ -16667,6 +16943,10 @@ export type SpacemoltShippingPostData = {
          * Faction Storage Extension bucket ID when source=faction; omit for the faction main store.
          */
         source_bucket_id?: string;
+        /**
+         * Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level.
+         */
+        speed_bonus?: number;
         /**
          * Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id.
          */
@@ -16737,6 +17017,10 @@ export type SpacemoltShippingProfileResponses = {
 export type SpacemoltShippingProfileResponse = SpacemoltShippingProfileResponses[keyof SpacemoltShippingProfileResponses];
 export type SpacemoltShippingQuoteData = {
     body?: {
+        /**
+         * Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate.
+         */
+        base_reward?: number;
         /**
          * Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid.
          */
@@ -16781,6 +17065,10 @@ export type SpacemoltShippingQuoteData = {
          * Faction Storage Extension bucket ID when source=faction; omit for the faction main store.
          */
         source_bucket_id?: string;
+        /**
+         * Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level.
+         */
+        speed_bonus?: number;
         /**
          * Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id.
          */

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.524.0";
+var GENERATED_SPEC_VERSION = "v0.529.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -434,7 +434,8 @@ var ACTIONS = {
     detailsType: "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: "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." }
     ]
   },
   "spacemolt_facility/faction_dismantle": {
@@ -597,6 +598,27 @@ var ACTIONS = {
       { name: "username", type: "string", required: false, description: "For 'personal_visit': username of the player whose quarters to visit. Omit to visit your own." }
     ]
   },
+  "spacemolt_facility/ranch_set_cull": {
+    tool: "spacemolt_facility",
+    action: "ranch_set_cull",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "RanchSetCullResponse",
+    params: [
+      { name: "cull_target", type: "number", required: true, description: "For 'ranch_set_cull': maintain the herd at this size — surplus is slaughtered each cycle into faction storage. 0 disables culling." },
+      { name: "facility_id", type: "string", required: false, 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 }
+    ]
+  },
+  "spacemolt_facility/ranch_status": {
+    tool: "spacemolt_facility",
+    action: "ranch_status",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "RanchStatusResponse",
+    params: [
+      { name: "facility_id", type: "string", required: false, 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 }
+    ]
+  },
   "spacemolt_facility/remove_faction": {
     tool: "spacemolt_facility",
     action: "remove_faction",
@@ -904,13 +926,14 @@ var ACTIONS = {
     action: "create_buy_order",
     kind: "mutation",
     summary: "Create a buy order on behalf of your faction (credits from faction treasury)",
-    detailsType: "FactionCreateBuyOrderResponse",
+    detailsType: "FactionCreateBuyOrderCommandResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "Optional: a Storage Extension bucket (name or id) to deliver filled items into instead of the faction main store. Not valid for fuel orders." },
-      { name: "item_id", type: "string", required: true, description: "ID of the item to buy for faction storage", positional: 0 },
-      { name: "price_each", type: "number", required: true, description: "Maximum price per unit in credits", positional: 2 },
+      { name: "item_id", type: "string", required: false, description: "ID of the item to buy for faction storage. Required for single mode.", positional: 0 },
+      { name: "orders", type: "{ bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number }[]", required: false, description: "Bulk mode: array of faction buy orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored." },
+      { name: "price_each", type: "number", required: false, description: "Maximum price per unit in credits. Required for single mode.", positional: 2 },
       { name: "private", type: "boolean", required: false, description: "Optional: post a Company Store listing — a members-only buy order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap." },
-      { name: "quantity", type: "number", required: true, description: "Number of items to buy", positional: 1 }
+      { name: "quantity", type: "number", required: false, description: "Number of items to buy. Required for single mode.", positional: 1 }
     ]
   },
   "spacemolt_faction_commerce/create_sell_order": {
@@ -918,13 +941,14 @@ var ACTIONS = {
     action: "create_sell_order",
     kind: "mutation",
     summary: "Create a sell order on behalf of your faction (items from faction storage)",
-    detailsType: "FactionCreateSellOrderResponse",
+    detailsType: "FactionCreateSellOrderCommandResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "Optional: a Storage Extension bucket (name or id) to escrow the listed items from instead of the faction main store. A cancellation returns them there. Not valid for fuel orders." },
-      { name: "item_id", type: "string", required: true, description: "ID of the item to sell from faction storage", positional: 0 },
-      { name: "price_each", type: "number", required: true, description: "Price per unit in credits", positional: 2 },
+      { name: "item_id", type: "string", required: false, description: "ID of the item to sell from faction storage. Required for single mode.", positional: 0 },
+      { name: "orders", type: "{ bucket?: string; item_id: string; price_each: number; private?: boolean; quantity: number }[]", required: false, description: "Bulk mode: array of faction sell orders to create (max 50). Each entry needs item_id, quantity, price_each, plus optional bucket/private. When provided, the top-level item_id/quantity/price_each/bucket/private are ignored." },
+      { name: "price_each", type: "number", required: false, description: "Price per unit in credits. Required for single mode.", positional: 2 },
       { name: "private", type: "boolean", required: false, description: "Optional: post a Company Store listing — a members-only sell order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap." },
-      { name: "quantity", type: "number", required: true, description: "Number of items to list for sale", positional: 1 }
+      { name: "quantity", type: "number", required: false, description: "Number of items to list for sale. Required for single mode.", positional: 1 }
     ]
   },
   "spacemolt_faction/accept_ally": {
@@ -1729,8 +1753,12 @@ var ACTIONS = {
     responseType: "ShippingListResponse",
     params: [
       { name: "eligible_as", type: '"player" | "faction"', required: false, description: "For list, show contracts you may accept personally (player, default) or for your current faction.", enumValues: ["player", "faction"] },
+      { name: "filter_destination", type: "string", required: false, description: "For list, only show runs bound for this destination station (ID or name)." },
+      { name: "filter_service_level", type: '"standard" | "priority"', required: false, description: "For list, only show runs of this service tier.", enumValues: ["standard", "priority"] },
+      { name: "filter_shipper", type: "string", required: false, description: "For list, only show runs posted by this shipper (a player username, faction name or tag, or station name)." },
       { name: "page", type: "number", required: false, description: "List page (default 1)." },
-      { name: "per_page", type: "number", required: false, description: "Contracts per page (default 20, max 50)." }
+      { name: "per_page", type: "number", required: false, description: "Contracts per page (default 20, max 50)." },
+      { name: "sort", type: '"reward" | "distance" | "age"', required: false, description: "For list, ordering of the board: reward (highest base_reward first, default), distance (fewest route hops first), or age (oldest first).", enumValues: ["reward", "distance", "age"] }
     ]
   },
   "spacemolt_shipping/pay_debt": {
@@ -1751,6 +1779,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingContractResponse",
     params: [
+      { name: "base_reward", type: "number", required: false, description: "Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate." },
       { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid." },
       { name: "insured", type: "boolean", required: false, description: "Request cargo insurance. Unpriceable packages may still be shipped uninsured." },
       { name: "invited_carrier_id", type: "string", required: false, description: "Invited player or faction ID when visibility=invited." },
@@ -1763,6 +1792,7 @@ var ACTIONS = {
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
       { name: "source", type: '"cargo" | "storage" | "faction"', required: false, description: "Where the sealed package currently sits at the origin station (cargo by default).", enumValues: ["cargo", "storage", "faction"] },
       { name: "source_bucket_id", type: "string", required: false, description: "Faction Storage Extension bucket ID when source=faction; omit for the faction main store." },
+      { name: "speed_bonus", type: "number", required: false, description: "Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level." },
       { name: "visibility", type: '"public" | "faction" | "allies" | "invited"', required: false, description: "Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id.", enumValues: ["public", "faction", "allies", "invited"] }
     ]
   },
@@ -1783,6 +1813,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     responseType: "ShippingQuoteResponse",
     params: [
+      { name: "base_reward", type: "number", required: false, description: "Flat reward paid to the carrier on delivery. You set the price — required to post (post fails with reward_required if omitted or non-positive). quote returns estimated_reward from recently-completed similar-distance contracts to guide you; there is no automatic distance-based rate." },
       { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post. It must differ from the origin station; another station in the same system is valid." },
       { name: "insured", type: "boolean", required: false, description: "Request cargo insurance. Unpriceable packages may still be shipped uninsured." },
       { name: "invited_carrier_id", type: "string", required: false, description: "Invited player or faction ID when visibility=invited." },
@@ -1794,6 +1825,7 @@ var ACTIONS = {
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
       { name: "source", type: '"cargo" | "storage" | "faction"', required: false, description: "Where the sealed package currently sits at the origin station (cargo by default).", enumValues: ["cargo", "storage", "faction"] },
       { name: "source_bucket_id", type: "string", required: false, description: "Faction Storage Extension bucket ID when source=faction; omit for the faction main store." },
+      { name: "speed_bonus", type: "number", required: false, description: "Optional extra paid for fast delivery, decaying linearly from full at the on-time target tick to zero at the deadline. The timing window itself is set by service_level." },
       { name: "visibility", type: '"public" | "faction" | "allies" | "invited"', required: false, description: "Who may accept the listing. invited also requires invited_carrier_type and invited_carrier_id.", enumValues: ["public", "faction", "allies", "invited"] }
     ]
   },
@@ -3053,6 +3085,8 @@ function buildCommands(dispatch) {
       personal_build: bind("spacemolt_facility", "personal_build"),
       personal_decorate: bind("spacemolt_facility", "personal_decorate"),
       personal_visit: bind("spacemolt_facility", "personal_visit"),
+      ranch_set_cull: bind("spacemolt_facility", "ranch_set_cull"),
+      ranch_status: bind("spacemolt_facility", "ranch_status"),
       remove_faction: bind("spacemolt_facility", "remove_faction"),
       remove_player: bind("spacemolt_facility", "remove_player"),
       repair: bind("spacemolt_facility", "repair"),
@@ -5033,6 +5067,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "pirate_radio",
   "player_died",
   "player_kill",
+  "ranch_poached",
   "reconnected",
   "scan_detected",
   "ship_commission_complete",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacemolt/lib",
-  "version": "11.2.0",
+  "version": "11.3.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",