@spacemolt/lib 11.4.0 → 11.6.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`v0.530.1`). **278 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.537.2`). **278 commands across 18 tools.**
 
 ## How to call a command
 
@@ -50,7 +50,7 @@ Call as `account.commands.spacemolt.<action>(...)`.
 - `cloak({ enable?: boolean; quantity?: number })` · *mutation* → delta.details: `CloakResponse` — Toggle cloaking device
 - `complete_mission({ id: string })` · *mutation* → delta.details: `CompleteMissionResponse` — Complete a mission and claim rewards
 - `completed_missions()` · *query* → `CompletedMissionsResponse` — List all missions you have completed
-- `craft({ count?: number; deliver_to?: string; dry_run?: boolean; facility_id?: string; id?: string; items?: { item_id: string; quantity: number }[]; job_id?: string; job_ids?: string[]; jobs?: { 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 }[]; label?: string; package_id?: string; preset?: "fast" | "cheap" | "prefer_own" | "workshop"; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `CraftCommandResponse` — Queue a crafting job (auto-routes to your own/faction facility, or hand-crafts at the Station Workshop)
+- `craft({ count?: number; deliver_to?: string; dry_run?: boolean; facility_id?: string; id?: string; items?: { item_id: string; quantity: number }[]; job_id?: string; job_ids?: string[]; jobs?: { 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 }[]; label?: string; output_package_label?: string; package_id?: string; package_ids?: string[]; preset?: "fast" | "cheap" | "prefer_own" | "workshop"; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `CraftCommandResponse` — Queue a crafting job (auto-routes to your own/faction facility, or hand-crafts at the Station Workshop)
 - `decline_mission({ id?: string; mission_id?: string })` · *query* → `DeclineMissionResponse` — Decline a mission and hear the NPC's response
 - `distress_signal({ distress_type?: "fuel" | "repair" | "combat" })` · *mutation* → delta.details: `DistressSignalResponse` — Broadcast a distress signal to nearby players for emergency rescue
 - `dock()` · *mutation* → delta.details: `DockResponse` — Dock at a base
@@ -162,18 +162,18 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `ban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
 - `base_cost()` · *query* → `BaseCostResponse` — Preview the cost and requirements to found a faction station
 - `browse_for_sale({ facility_type?: string; max_price?: number })` · *query* → `FacilityBrowseForSaleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `build({ bucket?: string; facility_type: string })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `build({ bucket?: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityBuildResponse | FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityBuyListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `buy_ship_license({ ship_class: string })` · *mutation* → delta.details: `ShipLicenseResponse` — License a specific ship design so your faction can build it at its own stations
 - `cancel_listing({ listing_id: string })` · *mutation* → delta.details: `FacilityCancelListingResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `deploy_outpost({ name: string })` · *mutation* → delta.details: `BuildBaseResponse` — Deploy a lightweight, members-only faction outpost at your current point of interest in lawless space
 - `dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `facility_set_description({ description?: string; facility_id: string })` · *query* → `SetFacilityDescriptionResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `faction_build({ bucket?: string; facility_type: string; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `faction_build({ bucket?: string; facility_type: string; package_ids?: string[]; species?: string })` · *mutation* → delta.details: `FacilityFactionBuildResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_dismantle({ facility_id: string })` · *mutation* → delta.details: `FacilityDismantleResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_list()` · *query* → `FacilityFactionListResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_owned()` · *query* → `FacilityFactionOwnedResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
-- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `found_station({ name: string; public_access?: boolean })` · *mutation* → delta.details: `BuildBaseResponse` — Found a faction-owned station at your current point of interest in lawless space
 - `job_add({ deliver_to?: string; direction?: "forward" | "reverse"; facility_id: string; items?: { item_id: string; quantity: number }[]; label?: string; package_id?: string; quantity?: number; recipe_id: string; source?: string; target?: string })` · *mutation* → delta.details: `CraftJobResponse | PackageJobResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_cancel({ job_id?: string; job_ids?: string[] })` · *mutation* → delta.details: `JobCancelResponse | BulkJobCancelResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
@@ -206,7 +206,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `transfer({ direction: "to_faction" | "to_player"; facility_id: string; player_id?: string })` · *mutation* → delta.details: `FacilityTransferResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `types({ category?: "infrastructure" | "service" | "production" | "faction" | "personal"; facility_type?: string; level?: number; name?: string; page?: number; per_page?: number })` · *query* → `FacilityTypeDiscoveryResponse | FacilityTypeListResponse | FacilityTypeDetailResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `unban({ player: string })` · *mutation* → delta.details: `StationConfigResponse` — Administer one of your faction's stations or outposts: rename, access control, and build policy
-- `upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `upgrade({ bucket?: string; facility_id: string; facility_type: string; package_ids?: string[] })` · *mutation* → delta.details: `FacilityUpgradeResponse | FacilityFactionUpgradeResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `upgrades()` · *query* → `FacilityUpgradesResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 
 ## spacemolt_faction

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

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

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

@@ -125,6 +125,8 @@ export interface SpacemoltFacilityBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityBuyListingParams {
     /** For 'buy_listing' and 'cancel_listing': the facility listing ID. Use action 'browse_for_sale' to see listings. */
@@ -157,6 +159,8 @@ export interface SpacemoltFacilityFactionBuildParams {
     bucket?: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
     /** For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system. */
     species?: string;
 }
@@ -171,6 +175,8 @@ export interface SpacemoltFacilityFactionUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFacilityFoundStationParams {
     /** Name for the new faction station */
@@ -354,6 +360,8 @@ export interface SpacemoltFacilityUpgradeParams {
     facility_id: string;
     /** Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to. */
     facility_type: string;
+    /** For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall. */
+    package_ids?: string[];
 }
 export interface SpacemoltFactionAdminCreateRoleParams {
     /** Role name */
@@ -1260,8 +1268,12 @@ export interface SpacemoltCraftParams {
     }[];
     /** For pack_package: player-authored package label. */
     label?: string;
+    /** Bundle the outputs into one package: instead of depositing outputs loose per run, the job holds them and seals them into a single new package with this label in the destination on completion, consuming one cargo_container. Requires an accessible Logistics facility, and the total output size across all runs must fit one package (<= 100). Cancelling refunds the inputs and produces no package. */
+    output_package_label?: string;
     /** For unpack_package: package instance ID to unpack. */
     package_id?: string;
+    /** Source this craft's inputs from these packages (raw id or 'package:<id>' form) instead of loose storage items. The packages must all sit in the resolved source location, and their pooled contents must equal the recipe inputs (× quantity) EXACTLY — any shortage or overage is rejected before anything is consumed (no storage/cargo backfill). Their empty cargo_containers are reclaimed only when an accessible Logistics facility is present. */
+    package_ids?: string[];
     /** 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. */

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

@@ -4,6 +4,8 @@ export type AbandonMissionResponse = {
     title: string;
 };
 export type AcceptMissionResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     expires_at: string;
     message: string;
     mission_id: string;
@@ -113,6 +115,8 @@ export type AnalysisStep = {
     recipe_id: string;
 };
 export type AnalyzeMarketResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     insights: Array<MarketInsight>;
     message: string;
     skill_level: number;
@@ -481,6 +485,8 @@ export type BrowseShipsResponse = {
     listings: Array<ShipListing>;
 };
 export type BuildBaseResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_id: string;
     fee_paid: number;
     hint: string;
@@ -526,6 +532,8 @@ export type BulkCancelOrderResult = {
 };
 export type BulkCancelOrdersResponse = {
     action: 'cancel_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkCancelOrderResult>;
@@ -538,6 +546,8 @@ export type BulkCancelReturns = {
 };
 export type BulkCraftResponse = {
     action: 'craft' | 'recycle';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk_craft';
     mode: 'bulk';
     results: Array<BulkCraftResult>;
@@ -560,6 +570,8 @@ export type BulkCraftResult = {
 };
 export type BulkCreateBuyOrdersResponse = {
     action: 'create_buy_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkBuyOrderResult>;
@@ -567,6 +579,8 @@ export type BulkCreateBuyOrdersResponse = {
 };
 export type BulkCreateSellOrdersResponse = {
     action: 'create_sell_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkSellOrderResult>;
@@ -594,6 +608,8 @@ export type BulkFactionBuyOrderResult = {
 };
 export type BulkFactionCreateBuyOrdersResponse = {
     action: 'faction_create_buy_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkFactionBuyOrderResult>;
@@ -601,6 +617,8 @@ export type BulkFactionCreateBuyOrdersResponse = {
 };
 export type BulkFactionCreateSellOrdersResponse = {
     action: 'faction_create_sell_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkFactionSellOrderResult>;
@@ -626,6 +644,8 @@ export type BulkFactionSellOrderResult = {
 };
 export type BulkJobCancelResponse = {
     action: 'job_cancel';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk_cancel';
     message: string;
     mode: 'bulk';
@@ -645,6 +665,8 @@ export type BulkModifyOrderResult = {
 };
 export type BulkModifyOrdersResponse = {
     action: 'modify_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'bulk';
     mode: 'bulk';
     results: Array<BulkModifyOrderResult>;
@@ -689,6 +711,8 @@ export type BulkStorageItemResult = {
 };
 export type BulkStorageResponse = {
     action: 'bulk_deposit' | 'bulk_withdraw' | 'bulk_transfer';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     bucket_id?: string;
     dest_bucket?: string;
@@ -711,6 +735,8 @@ export type BurnLogEntry = {
     ticks_remaining: number;
 };
 export type BuyInsuranceResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     coverage: number;
     expires_at: string;
     factors?: Array<RiskFactor>;
@@ -721,6 +747,8 @@ export type BuyInsuranceResponse = {
     risk_score?: number;
 };
 export type BuyListedShipResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     class_id: string;
     credits_left: number;
     message: string;
@@ -730,7 +758,9 @@ export type BuyListedShipResponse = {
 };
 export type BuyResponse = {
     action: string;
+    auto_docked?: boolean;
     auto_listed?: AutoListedOrder;
+    auto_undocked?: boolean;
     delivered_to_cargo?: number;
     delivered_to_storage?: number;
     fills: Array<Fill>;
@@ -757,6 +787,8 @@ export type CancelOrderCommandResponse = ({
 } & BulkCancelOrdersResponse);
 export type CancelOrderResponse = {
     action: 'cancel_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     delivered_to?: string;
     faction_order?: boolean;
     kind: 'single';
@@ -1066,6 +1098,8 @@ export type ClientSystemInfo = {
     security_status?: string;
 };
 export type CloakResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cloak_strength: number;
     enabled: boolean;
     message: string;
@@ -1161,6 +1195,8 @@ export type CommissionMaterialStatus = {
     needed: number;
 };
 export type CommissionQuoteResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     blockers?: Array<string>;
     build_materials?: Array<CargoItem>;
     build_time?: number;
@@ -1181,6 +1217,8 @@ export type CommissionQuoteResponse = {
     yard_margin?: number;
 };
 export type CommissionShipResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     build_time?: number;
     commission_id: string;
     credits_left: number;
@@ -1198,6 +1236,8 @@ export type CommissionStatusResponse = {
     count: number;
 };
 export type CompleteMissionResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     chain_next?: string;
     community_contributed?: {
         [key: string]: number;
@@ -1246,6 +1286,8 @@ export type CraftCommandResponse = ({
 } & PackageJobResponse);
 export type CraftJobResponse = {
     action: 'craft' | 'recycle' | 'job_add';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     effective_time_per_run: number;
     escrowed: EscrowSummary;
     est_completion_tick: number;
@@ -1263,6 +1305,8 @@ export type CraftJobResponse = {
 };
 export type CraftQueueResponse = {
     action: 'queue';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     jobs: Array<JobView>;
     kind: 'queue';
     message?: string;
@@ -1270,6 +1314,8 @@ export type CraftQueueResponse = {
 };
 export type CraftQuoteResponse = {
     action: 'craft' | 'recycle';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cost: EscrowSummary;
     credits_total: number;
     dry_run: boolean;
@@ -1315,6 +1361,8 @@ export type CreateBuyOrderCommandResponse = ({
 } & BulkCreateBuyOrdersResponse);
 export type CreateBuyOrderResponse = {
     action: 'create_buy_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     consolidated?: boolean;
     delivered_to_cargo?: number;
     delivered_to_storage?: number;
@@ -1356,6 +1404,8 @@ export type CreateSellOrderCommandResponse = ({
 } & BulkCreateSellOrdersResponse);
 export type CreateSellOrderResponse = {
     action: 'create_sell_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     consolidated?: boolean;
     fills?: Array<Fill>;
     from_cargo?: number;
@@ -1390,6 +1440,8 @@ export type CreatureInfo = {
     species: string;
 };
 export type DeclineMissionResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     giver?: MissionGiverInfo;
     message: string;
     template_id: string;
@@ -1402,6 +1454,8 @@ export type DeleteNoteResponse = {
 };
 export type DeployAllDronesResponse = {
     action: 'deploy_all_drones';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bandwidth_total: number;
     bandwidth_used: number;
     deployed: number;
@@ -1415,6 +1469,8 @@ export type DeployDroneCommandResponse = ({
 } & DeployAllDronesResponse);
 export type DeployDroneResponse = {
     action: 'deploy_drone';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bandwidth_total: number;
     bandwidth_used: number;
     drone_id: string;
@@ -1426,14 +1482,19 @@ export type DeployDroneResponse = {
 };
 export type DepositItemsResponse = {
     action: 'deposit_items';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_remaining: number;
     cargo_space: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_total: number;
 };
 export type DistressSignalResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     distress_type: string;
     expires_seconds: number;
     message: string;
@@ -1491,6 +1552,8 @@ export type DroneInfo = {
 };
 export type EmpireGiftResponse = {
     action: 'empire_gift_credits' | 'empire_gift_items' | 'empire_gift_ship';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_id: string;
     base_name: string;
     cargo_remaining?: number;
@@ -1598,6 +1661,8 @@ export type EscrowedRewards = {
 };
 export type EspionageResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     intel_type?: string;
     outcome: string;
     story: string;
@@ -1716,6 +1781,7 @@ export type FacilityDefinition = {
     life_support_supply?: number;
     logistics?: boolean;
     lore?: string;
+    maintenance_fuel?: number;
     maintenance_inputs?: Array<RecipeInput>;
     max_cull_per_cycle?: number;
     max_species_tier?: number;
@@ -2172,6 +2238,8 @@ export type FactionCreateBuyOrderCommandResponse = ({
 } & BulkFactionCreateBuyOrdersResponse);
 export type FactionCreateBuyOrderResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     consolidated?: boolean;
     escrow_refunded?: number;
@@ -2215,6 +2283,8 @@ export type FactionCreateSellOrderCommandResponse = ({
 } & BulkFactionCreateSellOrdersResponse);
 export type FactionCreateSellOrderResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     consolidated?: boolean;
     faction_id: string;
@@ -2254,11 +2324,15 @@ export type FactionDeleteRoomResponse = {
 export type FactionDepositCreditsResponse = {
     action: 'faction_deposit_credits';
     amount: number;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     faction_credits: number;
     player_credits: number;
 };
 export type FactionDepositFuelResponse = {
     action: 'faction_deposit_fuel';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     fuel: number;
     fuel_capacity: number;
     ship_fuel: number;
@@ -2266,6 +2340,8 @@ export type FactionDepositFuelResponse = {
 };
 export type FactionDepositItemsResponse = {
     action: 'faction_deposit_items';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     bucket_id?: string;
     cargo_remaining: number;
@@ -2322,6 +2398,8 @@ export type FactionGarageStationEntry = {
 };
 export type FactionGarageStoreResponse = {
     action: 'faction_garage_store';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_id: string;
     capacity: number;
     hint: string;
@@ -2339,6 +2417,8 @@ export type FactionGetInvitesResponse = {
 };
 export type FactionGiftResponse = {
     action: 'faction_gift';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     credits_sent: number;
     faction_id: string;
     faction_name: string;
@@ -2469,6 +2549,8 @@ export type FactionPeaceProposal = {
     terms?: string;
 };
 export type FactionPostMissionResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     escrowed: EscrowedRewards;
     message: string;
     status: string;
@@ -2666,6 +2748,8 @@ export type FactionWarInfo = {
 export type FactionWithdrawCreditsResponse = {
     action: 'faction_withdraw_credits';
     amount: number;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     faction_credits: number;
     player_credits: number;
 };
@@ -2675,6 +2759,8 @@ export type FactionWithdrawInviteResponse = {
 };
 export type FactionWithdrawItemsResponse = {
     action: 'faction_withdraw_items';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     bucket_id?: string;
     cargo_space: number;
@@ -3223,6 +3309,8 @@ export type GiftNotification = {
 };
 export type GiftShipResponse = {
     action: 'gift_ship';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_id: string;
     class_id: string;
     class_name?: string;
@@ -3236,6 +3324,8 @@ export type GuideEntry = {
     title: string;
 };
 export type HuntResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     command: string;
     message: string;
     pending: boolean;
@@ -3298,6 +3388,8 @@ export type InspectResponse = {
     system?: MapSystemInfo;
 };
 export type InstallModResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cpu_used: number;
     current_ammo?: number;
     loaded_ammo?: string;
@@ -3406,6 +3498,8 @@ export type JailRecord = {
 };
 export type JettisonBulkResponse = {
     action: 'bulk_jettison';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     container_id?: string;
     failed: number;
     message: string;
@@ -3428,6 +3522,8 @@ export type JettisonItemResult = {
 };
 export type JettisonResponse = {
     action: 'jettison';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     container_id?: string;
     item_id: string;
     item_name: string;
@@ -3436,6 +3532,8 @@ export type JettisonResponse = {
 };
 export type JobCancelResponse = {
     action: 'job_cancel';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     job_id: string;
     kind: 'cancel';
     message: string;
@@ -3516,6 +3614,8 @@ export type ListPassengersResponse = {
     passengers: Array<PassengerView>;
 };
 export type ListShipForSaleResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     credits_left: number;
     fee: number;
     listing_id: string;
@@ -3542,6 +3642,8 @@ export type LoadDroneResponse = {
     status: string;
 };
 export type LoadPassengersResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     count: number;
     loaded: Array<PassengerView>;
     message: string;
@@ -3575,6 +3677,8 @@ export type LoginResponse = {
 };
 export type LootWreckAllResponse = {
     action: 'loot_wreck_all';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     looted: Array<LootedItem>;
     looted_modules?: Array<LootedModule>;
     message: string;
@@ -3591,6 +3695,8 @@ export type LootWreckCommandResponse = ({
 } & LootWreckAllResponse);
 export type LootWreckResponse = {
     action: 'loot_wreck';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     item_id?: string;
     module_id?: string;
     module_type_id?: string;
@@ -3613,6 +3719,8 @@ export type LootedModule = {
     wear: number;
 };
 export type LoungeCheckInResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     capacity: number;
     checked_in: Array<PassengerView>;
     count: number;
@@ -3798,6 +3906,8 @@ export type ModifyOrderCommandResponse = ({
 } & BulkModifyOrdersResponse);
 export type ModifyOrderResponse = {
     action: 'modify_order';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     kind: 'single';
     listing_fee?: number;
     message: string;
@@ -4497,6 +4607,8 @@ export type Poi = {
 };
 export type PackageJobResponse = {
     action: 'pack' | 'unpack';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     escrowed: EscrowSummary;
     eta_ticks: number;
     external?: boolean;
@@ -4580,6 +4692,8 @@ export type PathfinderJumpResponse = {
     origin_y?: number;
 };
 export type PendingActionResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     command: string;
     message: string;
     pending: boolean;
@@ -4606,6 +4720,8 @@ export type PirateInfo = {
     tier: string;
 };
 export type PlaceShipBuyOrderResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     class_id: string;
     credits_left: number;
     message: string;
@@ -4718,6 +4834,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
      */
@@ -4962,6 +5082,8 @@ export type RecycleJobResponse = ({
     kind: 'bulk_cancel';
 } & BulkJobCancelResponse);
 export type RefitShipResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_returned: number;
     class_id: string;
     default_modules: number;
@@ -5044,6 +5166,8 @@ export type ReloadResponse = {
     weapon_name: string;
 };
 export type RepairModuleResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     message: string;
     module_id: string;
     repair_amount: number;
@@ -5149,6 +5273,8 @@ export type ScrapShipResponse = {
 };
 export type ScrapWreckResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     materials: Array<SalvageMaterial>;
     message: string;
     ship_class?: string;
@@ -5173,7 +5299,9 @@ export type SelfDestructResponse = {
 };
 export type SellResponse = {
     action: string;
+    auto_docked?: boolean;
     auto_listed?: AutoListedOrder;
+    auto_undocked?: boolean;
     fills: Array<Fill>;
     item: string;
     item_id: string;
@@ -5188,6 +5316,8 @@ export type SellResponse = {
     xp_gained?: number;
 };
 export type SellShipToOrderResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     class_id: string;
     credits_left: number;
     message: string;
@@ -5196,6 +5326,8 @@ export type SellShipToOrderResponse = {
 };
 export type SellWreckResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_value?: number;
     message: string;
     new_balance: number;
@@ -5206,6 +5338,8 @@ export type SellWreckResponse = {
 };
 export type SendGiftResponse = {
     action: 'send_gift';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_id: string;
     cargo_remaining?: number;
     credits_sent?: number;
@@ -5244,6 +5378,8 @@ export type SetFacilityNameResponse = {
     message: string;
 };
 export type SetHomeBaseResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     home_base: string;
     message: string;
     old_home_base?: string;
@@ -5914,6 +6050,8 @@ export type SubscribeObservationResponse = {
 };
 export type SupplyCommissionResponse = {
     all_sourced: boolean;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     commission_id: string;
     commission_status: string;
     credits?: number;
@@ -5950,6 +6088,8 @@ export type SurveyedPoi = {
 export type SwitchShipResponse = {
     active_ship_class: string;
     active_ship_id: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_note?: string;
     cargo_to_storage?: Array<SoldCargoItem>;
     claimed_from_faction_garage?: boolean;
@@ -6091,6 +6231,8 @@ export type TaxableIncomeByCategoryEntry = {
 };
 export type TowWreckResponse = {
     action: string;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_count?: number;
     insured: boolean;
     message: string;
@@ -6156,6 +6298,8 @@ export type TradeOfferResponse = {
 export type TransferCreditsResponse = {
     action: 'transfer';
     amount: number;
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     dest_credits: number;
     destination: string;
     source: string;
@@ -6163,6 +6307,8 @@ export type TransferCreditsResponse = {
 };
 export type TransferItemsResponse = {
     action: 'transfer';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     bucket?: string;
     bucket_id?: string;
     dest_bucket?: string;
@@ -6175,6 +6321,8 @@ export type TransferItemsResponse = {
     source_remaining: number;
 };
 export type TransferPassengersResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     count: number;
     kind: 'transfer';
     message: string;
@@ -6247,6 +6395,8 @@ export type UndockResponse = {
     action: string;
 };
 export type UninstallModResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cpu_used: number;
     damaged: boolean;
     destroyed?: boolean;
@@ -6258,6 +6408,8 @@ export type UninstallModResponse = {
     wear_status?: string;
 };
 export type UnloadAllPassengersResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     delivered: Array<PassengerView>;
     fare_collected: number;
     kind: 'all';
@@ -6282,6 +6434,8 @@ export type UnloadPassengerCommandResponse = ({
     kind: 'lounge_checkin';
 } & LoungeCheckInResponse);
 export type UnloadPassengerResponse = {
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     base_fare?: number;
     delivered: boolean;
     fare_collected: number;
@@ -6729,6 +6883,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,9 +7289,12 @@ export type WildlifeSurvey = {
 };
 export type WithdrawItemsResponse = {
     action: 'withdraw_items';
+    auto_docked?: boolean;
+    auto_undocked?: boolean;
     cargo_space: number;
     cargo_total: number;
     item_id: string;
+    message?: string;
     quantity: number;
     storage_remaining: number;
 };
@@ -7584,10 +7745,18 @@ export type SpacemoltCraftData = {
          * For pack_package: player-authored package label.
          */
         label?: string;
+        /**
+         * Bundle the outputs into one package: instead of depositing outputs loose per run, the job holds them and seals them into a single new package with this label in the destination on completion, consuming one cargo_container. Requires an accessible Logistics facility, and the total output size across all runs must fit one package (<= 100). Cancelling refunds the inputs and produces no package.
+         */
+        output_package_label?: string;
         /**
          * For unpack_package: package instance ID to unpack.
          */
         package_id?: string;
+        /**
+         * Source this craft's inputs from these packages (raw id or 'package:<id>' form) instead of loose storage items. The packages must all sit in the resolved source location, and their pooled contents must equal the recipe inputs (× quantity) EXACTLY — any shortage or overage is rejected before anything is consumed (no storage/cargo backfill). Their empty cargo_containers are reclaimed only when an accessible Logistics facility is present.
+         */
+        package_ids?: Array<string>;
         /**
          * 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.
          */
@@ -10973,6 +11142,10 @@ export type SpacemoltFacilityBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -11235,6 +11408,10 @@ export type SpacemoltFacilityFactionBuildData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
         /**
          * For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system.
          */
@@ -11381,6 +11558,10 @@ export type SpacemoltFacilityFactionUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -12717,6 +12898,10 @@ export type SpacemoltFacilityUpgradeData = {
          * Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.
          */
         facility_type: string;
+        /**
+         * For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.
+         */
+        package_ids?: Array<string>;
     };
     path?: never;
     query?: never;

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.530.1";
+var GENERATED_SPEC_VERSION = "v0.537.2";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -362,7 +362,8 @@ var ACTIONS = {
     detailsType: "FacilityBuildResponse | FacilityFactionBuildResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/buy_listing": {
@@ -435,6 +436,7 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." },
       { name: "species", type: "string", required: false, description: "For 'faction_build' of a ranch facility: the grazer species to ranch (fixed for the facility's life). survey_system shows what lives in the system." }
     ]
   },
@@ -473,7 +475,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/found_station": {
@@ -827,7 +830,8 @@ var ACTIONS = {
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'faction_dismantle', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
+      { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 },
+      { name: "package_ids", type: "string[]", required: false, description: "For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall." }
     ]
   },
   "spacemolt_facility/upgrades": {
@@ -2424,7 +2428,9 @@ var ACTIONS = {
       { 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: "{ 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: "output_package_label", type: "string", required: false, description: "Bundle the outputs into one package: instead of depositing outputs loose per run, the job holds them and seals them into a single new package with this label in the destination on completion, consuming one cargo_container. Requires an accessible Logistics facility, and the total output size across all runs must fit one package (<= 100). Cancelling refunds the inputs and produces no package." },
       { name: "package_id", type: "string", required: false, description: "For unpack_package: package instance ID to unpack." },
+      { name: "package_ids", type: "string[]", required: false, description: "Source this craft's inputs from these packages (raw id or 'package:<id>' form) instead of loose storage items. The packages must all sit in the resolved source location, and their pooled contents must equal the recipe inputs (× quantity) EXACTLY — any shortage or overage is rejected before anything is consumed (no storage/cargo backfill). Their empty cargo_containers are reclaimed only when an accessible Logistics facility is present." },
       { 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." },

package/package.json

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