@spacemolt/lib 11.0.0 → 11.2.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`unknown`). **276 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.524.0`). **276 commands across 18 tools.**
 
 ## How to call a command
 
@@ -162,7 +162,7 @@ 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({ facility_type: string })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — 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)
 - `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)
@@ -204,7 +204,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({ 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 })` · *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
@@ -245,7 +245,7 @@ Call as `account.commands.spacemolt_faction.<action>(...)`.
 Call as `account.commands.spacemolt_faction_admin.<action>(...)`.
 
 - `create_role({ name: string; permissions?: Record<string, unknown>; priority: number })` · *query* → `FactionCreateRoleResponse` — Create a custom faction role
-- `edit({ ally_fuel_access?: boolean; ally_intel_opt_out?: boolean; charter?: string; description?: string; primary_color?: string; secondary_color?: string })` · *query* → `FactionEditResponse` — Update faction description, charter, colors, and ally-sharing toggles
+- `edit({ ally_facility_access?: boolean; ally_fuel_access?: boolean; ally_intel_opt_out?: boolean; charter?: string; description?: string; primary_color?: string; secondary_color?: string })` · *query* → `FactionEditResponse` — Update faction description, charter, colors, and ally-sharing toggles
 - `edit_role({ name?: string; permissions?: Record<string, unknown>; role_id: string })` · *query* → `FactionEditRoleResponse` — Edit a custom faction role
 - `post_mission({ description: string; dialog?: Record<string, unknown>; expiration_hours?: number; giver_name?: string; giver_title?: string; objectives: { description: string; item_id?: string; quantity?: number; system_id?: string; target_id?: string; type: string }[]; rewards: { credits?: number; items?: Record<string, unknown>[] }; title: string; triggers?: string[]; type: string })` · *mutation* → delta.details: `FactionPostMissionResponse` — Post a mission on your faction's mission board
 - `promote({ player_id: string; role_id: "recruit" | "member" | "officer" | "leader" })` · *mutation* → delta.details: `FactionPromoteResponse` — Promote or demote a faction member

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 = "unknown";
+export declare const GENERATED_SPEC_VERSION = "v0.524.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 interface ActionParam {

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

@@ -121,6 +121,8 @@ export interface SpacemoltFacilityBrowseForSaleParams {
     max_price?: number;
 }
 export interface SpacemoltFacilityBuildParams {
+    /** 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. */
+    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;
 }
@@ -334,6 +336,8 @@ export interface SpacemoltFacilityUnbanParams {
     player: string;
 }
 export interface SpacemoltFacilityUpgradeParams {
+    /** 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. */
+    bucket?: string;
     /** 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;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
@@ -348,6 +352,8 @@ export interface SpacemoltFactionAdminCreateRoleParams {
     priority: number;
 }
 export interface SpacemoltFactionAdminEditParams {
+    /** True to let allied faction members use your faction's facilities for free. Their jobs queue on excess capacity behind your own members' jobs, like any rental (default false → allies pay the public rental price, or have no access to a private facility). */
+    ally_facility_access?: boolean;
     /** True to let allied faction members refuel for free from your faction's bunker reserves (default false → opt-in). */
     ally_fuel_access?: boolean;
     /** True to withhold your intel pool from allied factions (default false → sharing on). */
@@ -744,7 +750,7 @@ export interface SpacemoltShipListShipForSaleParams {
     price: number;
 }
 export interface SpacemoltShippingAcceptParams {
-    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. */
+    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance. */
     carrier?: "player" | "faction";
     /** Freight contract ID for get, track, accept, deliver, return, or cancel. */
     shipment_id: string;
@@ -772,11 +778,11 @@ export interface SpacemoltShippingListParams {
 export interface SpacemoltShippingPayDebtParams {
     /** Debt payment amount for pay_debt. Omit to pay the full outstanding balance. */
     amount?: number;
-    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. */
+    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance. */
     carrier?: "player" | "faction";
 }
 export interface SpacemoltShippingPostParams {
-    /** Destination station/base ID for quote or post. */
+    /** 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. */
     insured?: boolean;
@@ -804,11 +810,11 @@ export interface SpacemoltShippingPostParams {
     visibility?: "public" | "faction" | "allies" | "invited";
 }
 export interface SpacemoltShippingProfileParams {
-    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. */
+    /** Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance. */
     carrier?: "player" | "faction";
 }
 export interface SpacemoltShippingQuoteParams {
-    /** Destination station/base ID for quote or post. */
+    /** 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. */
     insured?: boolean;
@@ -1210,7 +1216,7 @@ export interface SpacemoltCraftParams {
     label?: string;
     /** For unpack_package: package instance ID to unpack. */
     package_id?: string;
-    /** Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility. */
+    /** Auto-routing preset: 'fast' (fewest ticks, default) picks the best facility globally, so a busy own facility may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's facilities are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority), then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility. */
     preset?: "fast" | "cheap" | "prefer_own" | "workshop";
     /** Number of output items to make (default 1). Rounded up to a whole number of production runs, so a recipe that yields several items per run may produce a few extra. */
     quantity?: number;
@@ -1313,7 +1319,7 @@ export interface SpacemoltRecycleParams {
     job_ids?: string[];
     /** Bulk mode: recycle many recipes in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is processed independently (partial success). Max 50. */
     jobs?: Record<string, unknown>[];
-    /** Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best eligible recycler globally. Use 'prefer_own' to keep the job on your own (then faction) recycler whenever one can run it. 'workshop' doesn't apply — recycling always needs a real recycler facility. */
+    /** Auto-routing preset: 'fast' (fewest ticks, default) picks the best eligible recycler globally, so a busy own recycler may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) recycler whenever one can run it. Auto-routing otherwise prefers your own recycler, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority). 'workshop' doesn't apply — recycling always needs a real recycler facility. */
     preset?: "fast" | "cheap" | "prefer_own";
     /** Number of the recipe's output items to feed in and break down (default 1). Rounded up to a whole number of recycling runs. */
     quantity?: number;

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, 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, 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" | "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" | "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;
@@ -31,6 +31,7 @@ export interface NotificationPayloads {
     "player_kill": NotificationPlayerKill;
     "reconnected": NotificationReconnected;
     "scan_detected": NotificationScanDetected;
+    "ship_commission_complete": NotificationShipCommissionComplete;
     "skill_level_up": NotificationSkillLevelUp;
     "station_repaired": NotificationStationRepaired;
     "trade_cancelled": NotificationTradeCancelled;
@@ -39,4 +40,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", "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", "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

@@ -784,7 +784,6 @@ export type CarrierProfile = {
     breaches: number;
     defaults: number;
     delivered_value: number;
-    house_deliveries: number;
     last_consequence_at?: string;
     last_recovery_at?: string;
     outstanding_debt: number;
@@ -798,12 +797,12 @@ export type CarrierTierProgress = {
     at_maximum_tier: boolean;
     current_tier: 'probationary' | 'licensed' | 'trusted' | 'prime';
     delivered_value: number;
-    house_deliveries: number;
     next_tier?: 'licensed' | 'trusted' | 'prime';
     remaining_delivered_value: number;
-    remaining_house_deliveries: number;
+    remaining_successful_deliveries: number;
     required_delivered_value: number;
-    required_house_deliveries: number;
+    required_successful_deliveries: number;
+    successful_deliveries: number;
 };
 export type CatalogAchievement = {
     after?: string;
@@ -2214,6 +2213,7 @@ export type FactionEditRoleUpdates = {
     permissions?: FactionCreateRolePermissions;
 };
 export type FactionEditUpdates = {
+    ally_facility_access?: boolean;
     ally_fuel_access?: boolean;
     ally_intel_opt_out?: boolean;
     charter?: string;
@@ -3766,7 +3766,6 @@ export type Module = {
     power_usage: number;
     precision_factor?: number;
     quest_item?: boolean;
-    range?: number;
     reach?: number;
     remote_repair_power?: number;
     required_skills?: {
@@ -3788,7 +3787,6 @@ export type Module = {
     speed_bonus?: number;
     speed_penalty?: number;
     survey_power?: number;
-    survey_range?: number;
     tow_speed_penalty?: number;
     tracking_bonus?: number;
     type: string;
@@ -4244,6 +4242,15 @@ export type NotificationScanDetected = {
     scanner_ship_class?: string;
     scanner_username: string;
 };
+export type NotificationShipCommissionComplete = {
+    base_id: string;
+    base_name: string;
+    commission_id: string;
+    ship_class: string;
+    ship_id: string;
+    ship_name: string;
+    tick: number;
+};
 /**
  * Notification that a player's skill leveled up.
  */
@@ -5416,11 +5423,10 @@ export type ShipmentContract = {
     claim_paid?: number;
     contractor?: ShipmentActor;
     covered_value?: number;
-    created_by_npc?: boolean;
     deadline_tick?: number;
-    default_fine: number;
     delivered_at?: string;
     destination_base_id: string;
+    failure_debt: number;
     id: string;
     insurable: boolean;
     insurer?: ShipmentActor;
@@ -5435,6 +5441,7 @@ export type ShipmentContract = {
     posted_at: string;
     premium?: number;
     recipient: ShipmentActor;
+    reputation_eligible?: boolean;
     reserved_exposure: number;
     reward_escrow: number;
     risk_band: 'probationary' | 'licensed' | 'trusted' | 'prime' | 'unpriced';
@@ -5508,8 +5515,8 @@ export type ShippingQuote = {
     consequences: string;
     covered_value: number;
     deadline_ticks: number;
-    default_fine: number;
     destination_base_id: string;
+    failure_debt: number;
     insurable: boolean;
     insurance_selected: boolean;
     invited_carrier?: ShipmentActor;
@@ -6515,7 +6522,7 @@ export type V2GameState = {
         size?: number;
         slot?: string;
         /**
-         * Module-type-specific stats (damage, range, shield_bonus, mining_power, etc.); omitted when empty
+         * Module-type-specific stats (damage, reach, shield_bonus, mining_power, etc.); omitted when empty
          */
         stats?: {
             [key: string]: unknown;
@@ -6836,7 +6843,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 | NotificationSkillLevelUp | NotificationTradeCancelled | NotificationTradeComplete | NotificationTradeDeclined | NotificationTradeOfferReceived;
+        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;
         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.
@@ -7421,7 +7428,7 @@ export type SpacemoltCraftData = {
          */
         package_id?: string;
         /**
-         * Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.
+         * Auto-routing preset: 'fast' (fewest ticks, default) picks the best facility globally, so a busy own facility may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's facilities are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority), then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.
          */
         preset?: 'fast' | 'cheap' | 'prefer_own' | 'workshop';
         /**
@@ -8811,7 +8818,7 @@ export type SpacemoltRecycleData = {
             [key: string]: unknown;
         }>;
         /**
-         * Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best eligible recycler globally. Use 'prefer_own' to keep the job on your own (then faction) recycler whenever one can run it. 'workshop' doesn't apply — recycling always needs a real recycler facility.
+         * Auto-routing preset: 'fast' (fewest ticks, default) picks the best eligible recycler globally, so a busy own recycler may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) recycler whenever one can run it. Auto-routing otherwise prefers your own recycler, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority). 'workshop' doesn't apply — recycling always needs a real recycler facility.
          */
         preset?: 'fast' | 'cheap' | 'prefer_own';
         /**
@@ -10797,6 +10804,10 @@ export type SpacemoltFacilityBrowseForSaleResponses = {
 export type SpacemoltFacilityBrowseForSaleResponse = SpacemoltFacilityBrowseForSaleResponses[keyof SpacemoltFacilityBrowseForSaleResponses];
 export type SpacemoltFacilityBuildData = {
     body?: {
+        /**
+         * 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.
+         */
+        bucket?: string;
         /**
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
@@ -12455,6 +12466,10 @@ export type SpacemoltFacilityUnbanResponses = {
 export type SpacemoltFacilityUnbanResponse = SpacemoltFacilityUnbanResponses[keyof SpacemoltFacilityUnbanResponses];
 export type SpacemoltFacilityUpgradeData = {
     body?: {
+        /**
+         * 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.
+         */
+        bucket?: string;
         /**
          * 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.
          */
@@ -13602,6 +13617,10 @@ export type SpacemoltFactionAdminCreateRoleResponses = {
 export type SpacemoltFactionAdminCreateRoleResponse = SpacemoltFactionAdminCreateRoleResponses[keyof SpacemoltFactionAdminCreateRoleResponses];
 export type SpacemoltFactionAdminEditData = {
     body?: {
+        /**
+         * True to let allied faction members use your faction's facilities for free. Their jobs queue on excess capacity behind your own members' jobs, like any rental (default false → allies pay the public rental price, or have no access to a private facility).
+         */
+        ally_facility_access?: boolean;
         /**
          * True to let allied faction members refuel for free from your faction's bunker reserves (default false → opt-in).
          */
@@ -16337,7 +16356,7 @@ export type SpacemoltShipViewShipBuyOrdersResponse = SpacemoltShipViewShipBuyOrd
 export type SpacemoltShippingAcceptData = {
     body?: {
         /**
-         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.
+         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.
          */
         carrier?: 'player' | 'faction';
         /**
@@ -16565,7 +16584,7 @@ export type SpacemoltShippingPayDebtData = {
          */
         amount?: number;
         /**
-         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.
+         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.
          */
         carrier?: 'player' | 'faction';
     };
@@ -16601,7 +16620,7 @@ export type SpacemoltShippingPayDebtResponse = SpacemoltShippingPayDebtResponses
 export type SpacemoltShippingPostData = {
     body?: {
         /**
-         * Destination station/base ID for quote or post.
+         * 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;
         /**
@@ -16685,7 +16704,7 @@ export type SpacemoltShippingPostResponse = SpacemoltShippingPostResponses[keyof
 export type SpacemoltShippingProfileData = {
     body?: {
         /**
-         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.
+         * Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.
          */
         carrier?: 'player' | 'faction';
     };
@@ -16719,7 +16738,7 @@ export type SpacemoltShippingProfileResponse = SpacemoltShippingProfileResponses
 export type SpacemoltShippingQuoteData = {
     body?: {
         /**
-         * Destination station/base ID for quote or post.
+         * 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;
         /**

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "unknown";
+var GENERATED_SPEC_VERSION = "v0.524.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -361,6 +361,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     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 }
     ]
   },
@@ -802,6 +803,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityUpgradeResponse | FacilityFactionUpgradeResponse",
     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 }
     ]
@@ -833,6 +835,7 @@ var ACTIONS = {
     summary: "Update faction description, charter, colors, and ally-sharing toggles",
     responseType: "FactionEditResponse",
     params: [
+      { name: "ally_facility_access", type: "boolean", required: false, description: "True to let allied faction members use your faction's facilities for free. Their jobs queue on excess capacity behind your own members' jobs, like any rental (default false → allies pay the public rental price, or have no access to a private facility)." },
       { name: "ally_fuel_access", type: "boolean", required: false, description: "True to let allied faction members refuel for free from your faction's bunker reserves (default false → opt-in)." },
       { name: "ally_intel_opt_out", type: "boolean", required: false, description: "True to withhold your intel pool from allied factions (default false → sharing on)." },
       { name: "charter", type: "string", required: false, description: "Faction's founding document (max 4000 chars)" },
@@ -1684,7 +1687,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingContractResponse",
     params: [
-      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.", enumValues: ["player", "faction"] },
+      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.", enumValues: ["player", "faction"] },
       { name: "shipment_id", type: "string", required: true, description: "Freight contract ID for get, track, accept, deliver, return, or cancel." }
     ]
   },
@@ -1738,7 +1741,7 @@ var ACTIONS = {
     detailsType: "ShippingDebtPaymentResponse",
     params: [
       { name: "amount", type: "number", required: false, description: "Debt payment amount for pay_debt. Omit to pay the full outstanding balance." },
-      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.", enumValues: ["player", "faction"] }
+      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.", enumValues: ["player", "faction"] }
     ]
   },
   "spacemolt_shipping/post": {
@@ -1748,7 +1751,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     detailsType: "ShippingContractResponse",
     params: [
-      { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post." },
+      { 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." },
       { name: "invited_carrier_type", type: '"player" | "faction"', required: false, description: "Invited prime carrier kind when visibility=invited.", enumValues: ["player", "faction"] },
@@ -1770,7 +1773,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     responseType: "ShippingProfileResponse",
     params: [
-      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences.", enumValues: ["player", "faction"] }
+      { name: "carrier", type: '"player" | "faction"', required: false, description: "Prime carrier accepting the contract: you personally (player, default) or your current faction. The selected actor permanently owns the consequences. Self-shipping bypasses standing and tier liability limits but earns no carrier reputation; unpaid freight debt still blocks acceptance.", enumValues: ["player", "faction"] }
     ]
   },
   "spacemolt_shipping/quote": {
@@ -1780,7 +1783,7 @@ var ACTIONS = {
     summary: "Quote, post, haul, track, and settle sealed-package freight contracts through station mission services",
     responseType: "ShippingQuoteResponse",
     params: [
-      { name: "destination_base_id", type: "string", required: true, description: "Destination station/base ID for quote or post." },
+      { 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." },
       { name: "invited_carrier_type", type: '"player" | "faction"', required: false, description: "Invited prime carrier kind when visibility=invited.", enumValues: ["player", "faction"] },
@@ -2389,7 +2392,7 @@ var ACTIONS = {
       { name: "jobs", type: "{ deliver_to?: string; facility_id?: string; items?: { item_id: string; quantity: number }[]; label?: string; package_id?: string; preset?: string; quantity?: number; recipe_id: string; source?: string; target?: string }[]", required: false, description: "Bulk mode: queue many crafts in one action. Package entries may include items, package_id, label, and target. Each job commits independently with partial success. Max 50." },
       { name: "label", type: "string", required: false, description: "For pack_package: player-authored package label." },
       { name: "package_id", type: "string", required: false, description: "For unpack_package: package instance ID to unpack." },
-      { name: "preset", type: '"fast" | "cheap" | "prefer_own" | "workshop"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.", enumValues: ["fast", "cheap", "prefer_own", "workshop"] },
+      { name: "preset", type: '"fast" | "cheap" | "prefer_own" | "workshop"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) picks the best facility globally, so a busy own facility may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's facilities are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority), then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.", enumValues: ["fast", "cheap", "prefer_own", "workshop"] },
       { name: "quantity", type: "number", required: false, description: "Number of output items to make (default 1). Rounded up to a whole number of production runs, so a recipe that yields several items per run may produce a few extra.", positional: 1 },
       { name: "source", type: "string", required: false, description: "Where inputs and labor/rental credits are pulled FROM. Same values as deliver_to: 'storage', 'faction', or 'faction:<bucket>'. Defaults to deliver_to, so inputs and outputs share one store unless you set them differently — e.g. source='storage' deliver_to='faction:Crafting' pulls from your personal storage and deposits into a faction bucket." },
       { name: "target", type: "string", required: false, description: "For package recipes: output destination (storage, cargo, faction, or faction:<bucket>); defaults to source. deliver_to is accepted as an alias." }
@@ -2751,7 +2754,7 @@ var ACTIONS = {
       { name: "job_id", type: "string", required: false, description: "Cancel this queued job (refunding its unconsumed escrow) instead of recycling. Setting job_id implies cancel." },
       { name: "job_ids", type: "string[]", required: false, description: "Bulk cancel: cancel many queued jobs in one action. Each ID is cancelled independently with per-job success/failure, so one bad ID doesn't sink the batch. Refunds the unconsumed escrow of every cancelled job." },
       { name: "jobs", type: "Record<string, unknown>[]", required: false, description: "Bulk mode: recycle many recipes in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is processed independently (partial success). Max 50." },
-      { name: "preset", type: '"fast" | "cheap" | "prefer_own"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best eligible recycler globally. Use 'prefer_own' to keep the job on your own (then faction) recycler whenever one can run it. 'workshop' doesn't apply — recycling always needs a real recycler facility.", enumValues: ["fast", "cheap", "prefer_own"] },
+      { name: "preset", type: '"fast" | "cheap" | "prefer_own"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) picks the best eligible recycler globally, so a busy own recycler may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) recycler whenever one can run it. Auto-routing otherwise prefers your own recycler, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority). 'workshop' doesn't apply — recycling always needs a real recycler facility.", enumValues: ["fast", "cheap", "prefer_own"] },
       { name: "quantity", type: "number", required: false, description: "Number of the recipe's output items to feed in and break down (default 1). Rounded up to a whole number of recycling runs.", positional: 1 },
       { name: "source", type: "string", required: false, description: "Where feedstock (and labor/rental credits) are pulled FROM. Same values as deliver_to. Defaults to deliver_to." }
     ]
@@ -5032,6 +5035,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "player_kill",
   "reconnected",
   "scan_detected",
+  "ship_commission_complete",
   "skill_level_up",
   "station_repaired",
   "trade_cancelled",

package/package.json

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