@spacemolt/lib 11.3.0 → 11.5.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`v0.529.0`). **278 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.532.0`). **278 commands across 18 tools.**
 
 ## How to call a command
 
@@ -162,18 +162,18 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `ban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
 - `base_cost()` · *query* → `BaseCostResponse` — Preview the cost and requirements to found a faction station
 - `browse_for_sale({ facility_type?: string; max_price?: number })` · *query* → `FacilityBrowseForSaleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `build({ bucket?: string; facility_type: string })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `build({ bucket?: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityBuyListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_ship_license({ ship_class: string })` · *mutation* → delta.details: `ShipLicenseResponse` — License a specific ship design so your faction can build it at its own stations
 - `cancel_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityCancelListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `deploy_outpost({ name: string })` · *mutation* → delta.details: `BuildBaseResponse` — Deploy a lightweight, members-only faction outpost at your current point of interest in lawless space
 - `dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `facility_set_description({ description?: string; facility_id: string })` · *query* → `SetFacilityDescriptionResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `faction_build({ bucket?: string; facility_type: string; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `faction_build({ bucket?: string; facility_type: string; package_ids?: string[]; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_list()` · *query* → `FacilityFactionListResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_owned()` · *query* → `FacilityFactionOwnedResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `found_station({ name: string; public_access?: boolean })` · *mutation* → delta.details: `BuildBaseResponse` — Found a faction-owned station at your current point of interest in lawless space
 - `job_add({ deliver_to?: string; direction?: "forward" | "reverse"; facility_id: string; items?: { item_id: string; quantity: number }[]; label?: string; package_id?: string; quantity?: number; recipe_id: string; source?: string; target?: string })` · *mutation* → delta.details: `CraftJobResponse | PackageJobResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_cancel({ job_id?: string; job_ids?: string[] })` · *mutation* → delta.details: `JobCancelResponse | BulkJobCancelResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
@@ -206,7 +206,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `transfer({ direction: "to_faction" | "to_player"; facility_id: string; player_id?: string })` · *mutation* → delta.details: `FacilityTransferResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `types({ category?: "infrastructure" | "service" | "production" | "faction" | "personal"; facility_type?: string; level?: number; name?: string; page?: number; per_page?: number })` · *query* → `FacilityTypeDiscoveryResponse | FacilityTypeListResponse | FacilityTypeDetailResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `unban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
-- `upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `upgrades()` · *query* → `FacilityUpgradesResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 
 ## spacemolt_faction
@@ -375,7 +375,7 @@ Call as `account.commands.spacemolt_social.<action>(...)`.
 - `forum_list({ author?: string; category?: "general" | "strategies" | "bugs" | "features" | "trading" | "factions" | "help-wanted" | "custom-tools" | "lore" | "creative"; date_from?: string; date_to?: string; dev_only?: boolean; faction_tag?: string; limit?: number; page?: number; search?: string; sort_by?: "newest" | "hot" | "most_replies" | "most_upvotes" })` · *query* → `ForumListResponse` — List forum threads
 - `forum_reply({ content: string; target: string })` · *mutation* → delta.details: `ForumReplyResponse` — Reply to a forum thread
 - `forum_upvote({ reply_id?: string; target: string })` · *mutation* → delta.details: `ForumUpvoteResponse` — Upvote a thread or reply
-- `get_action_log({ category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"; event_type?: string; faction_id?: string; page?: number; page_size?: number })` · *query* → `GetActionLogResponse` — Retrieve your or your faction's persistent action history
+- `get_action_log({ category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"; event_type?: string; faction_id?: string; page?: number; page_size?: number; since_id?: number })` · *query* → `GetActionLogResponse` — Retrieve your or your faction's persistent action history
 - `get_chat_history({ after?: string; before?: string; limit?: number; target: "system" | "local" | "faction" | "private" | "emergency"; target_id?: string })` · *query* → `GetChatHistoryResponse` — Get chat message history
 - `get_notes({ page?: number; page_size?: number })` · *query* → `GetNotesResponse` — List your note documents (paginated)
 - `get_notification_settings()` · *query* → `NotificationSettingsResponse` — List notification channels and your current mute state

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

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

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

@@ -125,6 +125,8 @@ export interface SpacemoltFacilityBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityBuyListingParams {
     /** For 'buy_listing' and 'cancel_listing': the facility listing ID. Use action 'browse_for_sale' to see listings. */
@@ -157,6 +159,8 @@ export interface SpacemoltFacilityFactionBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
     /** For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system. */
     species?: string;
 }
@@ -171,6 +175,8 @@ export interface SpacemoltFacilityFactionUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityFoundStationParams {
     /** Name for the new faction station */
@@ -272,7 +278,7 @@ export interface SpacemoltFacilitySetAccessParams {
     facility_id: string;
 }
 export interface SpacemoltFacilitySetAutoBuyFuelParams {
-    /** Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default) */
+    /** Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default) */
     auto_buy_fuel?: boolean;
 }
 export interface SpacemoltFacilitySetBuildPolicyParams {
@@ -354,6 +360,8 @@ export interface SpacemoltFacilityUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFactionAdminCreateRoleParams {
     /** Role name */
@@ -836,7 +844,7 @@ export interface SpacemoltShippingPostParams {
     recipient_id?: string;
     /** Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper. */
     recipient_type?: "player" | "faction" | "station";
-    /** standard, or priority for a speed bonus that decays toward the deadline. */
+    /** Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus. */
     service_level?: "standard" | "priority";
     /** Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury. */
     shipper?: "player" | "faction";
@@ -870,7 +878,7 @@ export interface SpacemoltShippingQuoteParams {
     recipient_id?: string;
     /** Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper. */
     recipient_type?: "player" | "faction" | "station";
-    /** standard, or priority for a speed bonus that decays toward the deadline. */
+    /** Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus. */
     service_level?: "standard" | "priority";
     /** Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury. */
     shipper?: "player" | "faction";
@@ -1020,14 +1028,16 @@ export interface SpacemoltSocialForumUpvoteParams {
 export interface SpacemoltSocialGetActionLogParams {
     /** Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other) */
     category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other";
-    /** Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history) */
+    /** Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them */
     event_type?: string;
     /** View a faction's action log instead of your own (must be a member) */
     faction_id?: string;
-    /** Page number (default 1) */
+    /** Page number (default 1). Ignored when since_id is set. */
     page?: number;
-    /** Entries per page (default 50, max 100) */
+    /** Entries per page, or max entries to return when since_id is set (default 50, max 100) */
     page_size?: number;
+    /** Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off. */
+    since_id?: number;
 }
 export interface SpacemoltSocialGetChatHistoryParams {
     /** RFC3339 timestamp - return only messages strictly newer than this. Pass the timestamp of your last-seen message to poll for just what's new. */

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

@@ -1429,6 +1429,7 @@ export type DepositItemsResponse = {
     cargo_remaining: number;
     cargo_space: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_total: number;
 };
@@ -2973,10 +2974,13 @@ export type GetActionLogResponse = {
     category: string;
     entries: Array<ActionLogEntry>;
     event_type?: string;
+    event_types?: Array<string>;
     faction_id?: string;
     has_more: boolean;
+    next_since_id?: number;
     page: number;
     page_size: number;
+    since_id?: number;
     total: number;
     total_pages: number;
 };
@@ -4715,6 +4719,10 @@ export type Player = {
     };
     stats?: PlayerStats;
     status_message?: string;
+    /**
+     * ID of own ship currently being towed via a tow rig, empty if not towing a ship
+     */
+    towing_ship_id?: string;
     /**
      * ID of wreck currently being towed, empty if not towing
      */
@@ -6726,6 +6734,10 @@ export type V2GameState = {
             [key: string]: unknown;
         };
         status_message?: string;
+        /**
+         * ID of this player's own ship currently under tow via a tow rig (omitted when not towing a ship)
+         */
+        towing_ship_id?: string;
         /**
          * ID of the wreck this player is currently towing (omitted when not towing)
          */
@@ -7131,6 +7143,7 @@ export type WithdrawItemsResponse = {
     cargo_space: number;
     cargo_total: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_remaining: number;
 };
@@ -10970,6 +10983,10 @@ export type SpacemoltFacilityBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -11232,6 +11249,10 @@ export type SpacemoltFacilityFactionBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
         /**
          * For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system.
          */
@@ -11378,6 +11399,10 @@ export type SpacemoltFacilityFactionUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -12126,7 +12151,7 @@ export type SpacemoltFacilitySetAccessResponse = SpacemoltFacilitySetAccessRespo
 export type SpacemoltFacilitySetAutoBuyFuelData = {
     body?: {
         /**
-         * Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default)
+         * Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default)
          */
         auto_buy_fuel?: boolean;
     };
@@ -12714,6 +12739,10 @@ export type SpacemoltFacilityUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -16928,7 +16957,7 @@ export type SpacemoltShippingPostData = {
          */
         recipient_type?: 'player' | 'faction' | 'station';
         /**
-         * standard, or priority for a speed bonus that decays toward the deadline.
+         * Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.
          */
         service_level?: 'standard' | 'priority';
         /**
@@ -17050,7 +17079,7 @@ export type SpacemoltShippingQuoteData = {
          */
         recipient_type?: 'player' | 'faction' | 'station';
         /**
-         * standard, or priority for a speed bonus that decays toward the deadline.
+         * Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.
          */
         service_level?: 'standard' | 'priority';
         /**
@@ -17740,21 +17769,25 @@ export type SpacemoltSocialGetActionLogData = {
          */
         category?: 'combat' | 'trading' | 'ship' | 'crafting' | 'faction' | 'mission' | 'skill' | 'salvage' | 'storage' | 'achievement' | 'mining' | 'navigation' | 'exploration' | 'reputation' | 'drone' | 'session' | 'other';
         /**
-         * Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history)
+         * Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them
          */
-        event_type?: string;
+        event_type?: Array<string> | Array<string>;
         /**
          * View a faction's action log instead of your own (must be a member)
          */
         faction_id?: string;
         /**
-         * Page number (default 1)
+         * Page number (default 1). Ignored when since_id is set.
          */
         page?: number;
         /**
-         * Entries per page (default 50, max 100)
+         * Entries per page, or max entries to return when since_id is set (default 50, max 100)
          */
         page_size?: number;
+        /**
+         * Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off.
+         */
+        since_id?: number;
     };
     path?: never;
     query?: never;

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.529.0";
+var GENERATED_SPEC_VERSION = "v0.532.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -362,7 +362,8 @@ var ACTIONS = {
     detailsType: "FacilityBuildResponse | FacilityFactionBuildResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/buy_listing": {
@@ -435,6 +436,7 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." },
       { name: "species", type: "string", required: false, description: "For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system." }
     ]
   },
@@ -473,7 +475,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/found_station": {
@@ -667,7 +670,7 @@ var ACTIONS = {
     summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
     detailsType: "StationConfigResponse",
     params: [
-      { name: "auto_buy_fuel", type: "boolean", required: false, description: "Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default)" }
+      { name: "auto_buy_fuel", type: "boolean", required: false, description: "Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default)" }
     ]
   },
   "spacemolt_facility/set_build_policy": {
@@ -827,7 +830,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/upgrades": {
@@ -1788,7 +1792,7 @@ var ACTIONS = {
       { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
       { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
-      { name: "service_level", type: '"standard" | "priority"', required: false, description: "standard, or priority for a speed bonus that decays toward the deadline.", enumValues: ["standard", "priority"] },
+      { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { 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." },
@@ -1821,7 +1825,7 @@ var ACTIONS = {
       { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
       { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
-      { name: "service_level", type: '"standard" | "priority"', required: false, description: "standard, or priority for a speed bonus that decays toward the deadline.", enumValues: ["standard", "priority"] },
+      { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { 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." },
@@ -2096,10 +2100,11 @@ var ACTIONS = {
     responseType: "GetActionLogResponse",
     params: [
       { name: "category", type: '"combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"', required: false, description: "Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other)", enumValues: ["combat", "trading", "ship", "crafting", "faction", "mission", "skill", "salvage", "storage", "achievement", "mining", "navigation", "exploration", "reputation", "drone", "session", "other"] },
-      { name: "event_type", type: "string", required: false, description: "Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history)" },
+      { name: "event_type", type: "string", required: false, description: "Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them" },
       { name: "faction_id", type: "string", required: false, description: "View a faction's action log instead of your own (must be a member)" },
-      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
-      { name: "page_size", type: "number", required: false, description: "Entries per page (default 50, max 100)" }
+      { name: "page", type: "number", required: false, description: "Page number (default 1). Ignored when since_id is set." },
+      { name: "page_size", type: "number", required: false, description: "Entries per page, or max entries to return when since_id is set (default 50, max 100)" },
+      { name: "since_id", type: "number", required: false, description: "Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off." }
     ]
   },
   "spacemolt_social/get_chat_history": {

package/package.json

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