@spacemolt/lib 7.1.0 → 8.0.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.508.0`). **267 commands across 17 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.512.0`). **267 commands across 17 tools.**
 
 ## How to call a command
 
@@ -49,7 +49,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; job_id?: string; job_ids?: string[]; jobs?: Record<string, unknown>[]; preset?: "fast" | "cheap" | "prefer_own" | "workshop"; quantity?: number; source?: string })` · *mutation* → delta.details: `CraftJobResponse` — 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; package_id?: string; preset?: "fast" | "cheap" | "prefer_own" | "workshop"; quantity?: number; source?: string; target?: string })` · *mutation* → delta.details: `CraftJobResponse` — 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
@@ -79,7 +79,7 @@ Call as `account.commands.spacemolt.<action>(...)`.
 - `get_tax_estimate()` · *query* → `TaxEstimateResponse` — Preview what taxes you'd owe right now
 - `get_version({ count?: number; id?: string; page?: number; text?: string })` · *query* → `GetVersionResponse` — Get game version and release notes, with optional changelog pagination
 - `hunt({ id: string })` · *mutation* → delta.details: `HuntResponse` — Hunt a wildlife creature to start a battle
-- `inspect({ id: string })` · *query* → `InspectResponse` — Inspect an item, module, ship class, system, visible POI, or docked base by ID
+- `inspect({ id: string })` · *query* → `InspectResponse` — Inspect a visible package, item, module, ship class, system, POI, or docked base by ID
 - `install_mod({ id: string })` · *mutation* → delta.details: `InstallModResponse` — Install a module on your ship
 - `jettison({ id?: string; items?: { item_id: string; quantity: number }[]; quantity?: number })` · *mutation* → delta.details: `JettisonResponse` — Jettison items from cargo into space
 - `jump({ id: string })` · *mutation* → delta.details: `JumpResponse` — Jump to an adjacent star system, or plot a numeric bearing with a Pathfinder Drive
@@ -176,7 +176,7 @@ Call as `account.commands.spacemolt_facility.<action>(...)`.
 - `faction_owned()` · *query* → `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `faction_upgrade({ bucket?: string; facility_id: string; facility_type: string })` · *mutation* → delta.details: `FacilityResponse` — 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; quantity?: number; recipe_id: string; source?: string })` · *mutation* → delta.details: `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
+- `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: `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_cancel({ job_id?: string; job_ids?: string[] })` · *mutation* → delta.details: `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_list({ facility_id: string })` · *query* → `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)
 - `job_reorder({ facility_id: string; job_id: string; position?: number })` · *mutation* → delta.details: `FacilityResponse` — Manage facilities at stations (production, faction, personal, sales, and more)

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.508.0";
+export declare const GENERATED_SPEC_VERSION = "v0.512.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_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_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" | "deploy" | "deploy_outpost" | "deposit" | "disassemble" | "disband" | "disembark" | "dismantle" | "distress_signal" | "dock" | "edit" | "edit_role" | "engage" | "espionage" | "estimate_purchase" | "facility_set_description" | "faction_build" | "faction_disassemble" | "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" | "personal_build" | "personal_decorate" | "personal_visit" | "petition" | "place_ship_buy_order" | "policies" | "post_mission" | "prepay_tax" | "promote" | "propose_ally" | "propose_peace" | "query_intel" | "query_trade_intel" | "quote" | "read_note" | "recall" | "recycle" | "refit_ship" | "refuel" | "register" | "release" | "reload" | "remove_ally" | "remove_enemy" | "remove_faction" | "remove_player" | "rename_ship" | "renounce" | "repair" | "repair_module" | "retreat" | "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" | "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

@@ -191,12 +191,23 @@ export interface SpacemoltFacilityJobAddParams {
     direction?: "forward" | "reverse";
     /** Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs. */
     facility_id: string;
+    /** For job_add pack_package: selected manifest items. */
+    items?: {
+        item_id: string;
+        quantity: number;
+    }[];
+    /** For job_add pack_package: player label. */
+    label?: string;
+    /** For job_add unpack_package: package ID. */
+    package_id?: string;
     /** For 'job_add': number of runs to queue. */
     quantity?: number;
     /** Recipe ID to run (for 'job_add' action). */
     recipe_id: string;
     /** Input source for 'job_add': where inputs/credits are pulled from. Same values as deliver_to; defaults to deliver_to. */
     source?: string;
+    /** Package job_add output destination; defaults to source. */
+    target?: string;
 }
 export interface SpacemoltFacilityJobCancelParams {
     /** Job ID (for 'job_cancel', 'job_reorder'). Use action 'job_list' to see job IDs. */
@@ -221,7 +232,7 @@ export interface SpacemoltFacilityListForSaleParams {
     facility_id: string;
     /** For 'list_for_sale': set true to list a faction-owned facility (requires manage_facilities permission). */
     faction?: boolean;
-    /** For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected. */
+    /** For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected. */
     price: number;
 }
 export interface SpacemoltFacilityPersonalBuildParams {
@@ -281,7 +292,7 @@ export interface SpacemoltFacilitySetNameParams {
 export interface SpacemoltFacilitySetOutputPriceParams {
     /** Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs. */
     facility_id: string;
-    /** For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected. */
+    /** For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected. */
     price?: number;
 }
 export interface SpacemoltFacilitySetPublicParams {
@@ -1082,18 +1093,43 @@ export interface SpacemoltCraftParams {
     facility_id?: string;
     /** Recipe ID to craft (use catalog with type=recipes to see available recipes). Inputs are escrowed from station storage at enqueue. */
     id?: string;
+    /** For pack_package: selected items to pack; total unpacked size may not exceed 100. */
+    items?: {
+        item_id: string;
+        quantity: number;
+    }[];
     /** Cancel this queued job (refunding its unconsumed inputs, labor, and rental fee) instead of crafting. Use action='queue' to list your job IDs. Setting job_id implies cancel. */
     job_id?: string;
     /** 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. */
     job_ids?: string[];
-    /** Bulk mode: queue many crafts in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is queued independently (partial success). Max 50. */
-    jobs?: Record<string, unknown>[];
+    /** 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. */
+    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;
+    }[];
+    /** For pack_package: player-authored package label. */
+    label?: string;
+    /** For unpack_package: package instance ID to unpack. */
+    package_id?: string;
     /** Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility. */
     preset?: "fast" | "cheap" | "prefer_own" | "workshop";
     /** Number of output items to make (default 1). Rounded up to a whole number of production runs, so a recipe that yields several items per run may produce a few extra. */
     quantity?: number;
     /** 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. */
     source?: string;
+    /** For package recipes: output destination (storage, cargo, faction, or faction:<bucket>); defaults to source. deliver_to is accepted as an alias. */
+    target?: string;
 }
 export interface SpacemoltDeclineMissionParams {
     /** Mission template ID to decline (one of template_id/mission_id required) */
@@ -1144,7 +1180,7 @@ export interface SpacemoltHuntParams {
     id: string;
 }
 export interface SpacemoltInspectParams {
-    /** Item, module, ship class, system, POI, or base ID to inspect */
+    /** Visible package, item, module, ship class, system, POI, or base ID to inspect */
     id: string;
 }
 export interface SpacemoltInstallModParams {
@@ -1336,7 +1372,7 @@ export interface Commands {
         get_version(params?: SpacemoltGetVersionParams): Promise<QueryResult<GetVersionResponse>>;
         /** Hunt a wildlife creature to start a battle */
         hunt(params: SpacemoltHuntParams): Promise<MutationResult<HuntResponse>>;
-        /** Inspect an item, module, ship class, system, visible POI, or docked base by ID */
+        /** Inspect a visible package, item, module, ship class, system, POI, or docked base by ID */
         inspect(params: SpacemoltInspectParams): Promise<QueryResult<InspectResponse>>;
         /** Install a module on your ship */
         install_mod(params: SpacemoltInstallModParams): Promise<MutationResult<InstallModResponse>>;

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

@@ -658,6 +658,7 @@ export type CatalogResponse = {
             item_id: string;
             quantity: number;
         }>;
+        package_operation?: string;
     } | {
         allows_contraband?: boolean;
         always_on: boolean;
@@ -690,6 +691,7 @@ export type CatalogResponse = {
         level: number;
         life_support_draw?: number;
         life_support_supply?: number;
+        logistics?: boolean;
         lore?: string;
         maintenance_inputs?: Array<{
             item_id: string;
@@ -746,6 +748,7 @@ export type CatalogResponse = {
             item_id: string;
             quantity: number;
         }>;
+        package_operation?: string;
     }>;
     produced_by_facilities?: Array<{
         definition_id: string;
@@ -770,6 +773,7 @@ export type CatalogResponse = {
             item_id: string;
             quantity: number;
         }>;
+        package_operation?: string;
     }>;
     total: number;
     total_pages: number;
@@ -1042,8 +1046,10 @@ export type CraftJobResponse = {
         external?: boolean;
         facility_id: string;
         job_id: string;
+        label?: string;
         mode: string;
         orderer: string;
+        package_id?: string;
         position: number;
         produces?: Array<{
             item_id: string;
@@ -1078,7 +1084,9 @@ export type CraftJobResponse = {
         external?: boolean;
         index: number;
         job_id?: string;
+        label?: string;
         message?: string;
+        package_id?: string;
         recipe?: string;
         runs?: number;
         success: boolean;
@@ -1106,6 +1114,7 @@ export type CraftJobResponse = {
     est_completion_tick: number;
     external?: boolean;
     facility_id: string;
+    have_capacity?: boolean;
     have_credits: boolean;
     have_inputs: boolean;
     message: string;
@@ -1157,6 +1166,24 @@ export type CraftJobResponse = {
         succeeded: number;
         total: number;
     };
+} | {
+    action: string;
+    escrowed: {
+        fee?: number;
+        inputs?: Array<{
+            item_id: string;
+            name: string;
+            quantity: number;
+        }>;
+        labor?: number;
+    };
+    eta_ticks: number;
+    external?: boolean;
+    job_id: string;
+    label: string;
+    message: string;
+    package_id: string;
+    venue: string;
 };
 export type CreateBuyOrderResponse = {
     action: string;
@@ -1647,6 +1674,7 @@ export type FacilityDefinition = {
     level: number;
     life_support_draw?: number;
     life_support_supply?: number;
+    logistics?: boolean;
     lore?: string;
     maintenance_inputs?: Array<{
         item_id: string;
@@ -1751,13 +1779,16 @@ export type FacilityResponse = {
             backlog_ticks: number;
             items_per_hour?: number;
             output_per_run?: number;
+            output_price_per_operation?: number;
             output_price_per_unit?: number;
+            pack_operations_per_hour?: number;
             public?: boolean;
             queued_items: number;
             queued_runs: number;
             recipe?: string;
             rental_fee_per_run?: number;
             ticks_per_run?: number;
+            unpack_operations_per_hour?: number;
         };
         recipe_id?: string;
         rent_paid_until_tick?: number;
@@ -1825,13 +1856,16 @@ export type FacilityResponse = {
             backlog_ticks: number;
             items_per_hour?: number;
             output_per_run?: number;
+            output_price_per_operation?: number;
             output_price_per_unit?: number;
+            pack_operations_per_hour?: number;
             public?: boolean;
             queued_items: number;
             queued_runs: number;
             recipe?: string;
             rental_fee_per_run?: number;
             ticks_per_run?: number;
+            unpack_operations_per_hour?: number;
         };
         recipe_id?: string;
         rent_paid_until_tick?: number;
@@ -1895,13 +1929,16 @@ export type FacilityResponse = {
             backlog_ticks: number;
             items_per_hour?: number;
             output_per_run?: number;
+            output_price_per_operation?: number;
             output_price_per_unit?: number;
+            pack_operations_per_hour?: number;
             public?: boolean;
             queued_items: number;
             queued_runs: number;
             recipe?: string;
             rental_fee_per_run?: number;
             ticks_per_run?: number;
+            unpack_operations_per_hour?: number;
         };
         recipe_id?: string;
         rent_paid_until_tick?: number;
@@ -1944,13 +1981,16 @@ export type FacilityResponse = {
             backlog_ticks: number;
             items_per_hour?: number;
             output_per_run?: number;
+            output_price_per_operation?: number;
             output_price_per_unit?: number;
+            pack_operations_per_hour?: number;
             public?: boolean;
             queued_items: number;
             queued_runs: number;
             recipe?: string;
             rental_fee_per_run?: number;
             ticks_per_run?: number;
+            unpack_operations_per_hour?: number;
         };
         recipe_id?: string;
         rent_paid_until_tick?: number;
@@ -2467,6 +2507,24 @@ export type FacilityResponse = {
     runs: number;
     venue: string;
     venue_type: string;
+} | {
+    action: string;
+    escrowed: {
+        fee?: number;
+        inputs?: Array<{
+            item_id: string;
+            name: string;
+            quantity: number;
+        }>;
+        labor?: number;
+    };
+    eta_ticks: number;
+    external?: boolean;
+    job_id: string;
+    label: string;
+    message: string;
+    package_id: string;
+    venue: string;
 } | {
     action: string;
     facility_id: string;
@@ -2475,8 +2533,10 @@ export type FacilityResponse = {
         external?: boolean;
         facility_id: string;
         job_id: string;
+        label?: string;
         mode: string;
         orderer: string;
+        package_id?: string;
         position: number;
         produces?: Array<{
             item_id: string;
@@ -4323,12 +4383,14 @@ export type GetTradesResponse = {
         offer_credits?: number;
         offer_items: Array<{
             item_id: string;
+            name?: string;
             quantity: number;
         }>;
         offerer_name?: string;
         request_credits?: number;
         request_items: Array<{
             item_id: string;
+            name?: string;
             quantity: number;
         }>;
         target_name?: string;
@@ -4339,12 +4401,14 @@ export type GetTradesResponse = {
         offer_credits?: number;
         offer_items: Array<{
             item_id: string;
+            name?: string;
             quantity: number;
         }>;
         offerer_name?: string;
         request_credits?: number;
         request_items: Array<{
             item_id: string;
+            name?: string;
             quantity: number;
         }>;
         target_name?: string;
@@ -4748,6 +4812,7 @@ export type InspectResponse = {
                 item_id: string;
                 quantity: number;
             }>;
+            package_operation?: string;
         } | {
             allows_contraband?: boolean;
             always_on: boolean;
@@ -4780,6 +4845,7 @@ export type InspectResponse = {
             level: number;
             life_support_draw?: number;
             life_support_supply?: number;
+            logistics?: boolean;
             lore?: string;
             maintenance_inputs?: Array<{
                 item_id: string;
@@ -4836,6 +4902,7 @@ export type InspectResponse = {
                 item_id: string;
                 quantity: number;
             }>;
+            package_operation?: string;
         }>;
         produced_by_facilities?: Array<{
             definition_id: string;
@@ -4860,6 +4927,7 @@ export type InspectResponse = {
                 item_id: string;
                 quantity: number;
             }>;
+            package_operation?: string;
         }>;
         total: number;
         total_pages: number;
@@ -4925,6 +4993,34 @@ export type InspectResponse = {
     };
     id: string;
     kind: string;
+    package?: {
+        contents: Array<{
+            item_id: string;
+            name: string;
+            quantity: number;
+            size: number;
+        }>;
+        created_at: string;
+        creator: {
+            faction?: {
+                id: string;
+                name?: string;
+                tag?: string;
+                type: string;
+            };
+            player_id: string;
+            username?: string;
+        };
+        label: string;
+        owner: {
+            id: string;
+            name?: string;
+            tag?: string;
+            type: string;
+        };
+        package_id: string;
+        size: number;
+    };
     poi?: {
         detail?: {
             active_battle?: {
@@ -7020,6 +7116,7 @@ export type Recipe = {
         item_id: string;
         quantity: number;
     }>;
+    package_operation?: string;
 };
 export type RecycleJobResponse = {
     action: string;
@@ -7066,7 +7163,9 @@ export type RecycleJobResponse = {
         external?: boolean;
         index: number;
         job_id?: string;
+        label?: string;
         message?: string;
+        package_id?: string;
         recipe?: string;
         runs?: number;
         success: boolean;
@@ -7094,6 +7193,7 @@ export type RecycleJobResponse = {
     est_completion_tick: number;
     external?: boolean;
     facility_id: string;
+    have_capacity?: boolean;
     have_credits: boolean;
     have_inputs: boolean;
     message: string;
@@ -8076,6 +8176,7 @@ export type StorageResponse = {
             size: number;
         }>;
         name: string;
+        package_cap: number;
     }>;
     credits: number;
     faction_fuel_capacity?: number;
@@ -9947,6 +10048,13 @@ export type SpacemoltCraftData = {
          * Recipe ID to craft (use catalog with type=recipes to see available recipes). Inputs are escrowed from station storage at enqueue.
          */
         id?: string;
+        /**
+         * For pack_package: selected items to pack; total unpacked size may not exceed 100.
+         */
+        items?: Array<{
+            item_id: string;
+            quantity: number;
+        }>;
         /**
          * Cancel this queued job (refunding its unconsumed inputs, labor, and rental fee) instead of crafting. Use action='queue' to list your job IDs. Setting job_id implies cancel.
          */
@@ -9956,11 +10064,31 @@ export type SpacemoltCraftData = {
          */
         job_ids?: Array<string>;
         /**
-         * Bulk mode: queue many crafts in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is queued independently (partial success). Max 50.
+         * 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.
          */
         jobs?: Array<{
-            [key: string]: unknown;
+            deliver_to?: string;
+            facility_id?: string;
+            items?: Array<{
+                item_id: string;
+                quantity: number;
+            }>;
+            label?: string;
+            package_id?: string;
+            preset?: string;
+            quantity?: number;
+            recipe_id: string;
+            source?: string;
+            target?: string;
         }>;
+        /**
+         * For pack_package: player-authored package label.
+         */
+        label?: string;
+        /**
+         * For unpack_package: package instance ID to unpack.
+         */
+        package_id?: string;
         /**
          * Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.
          */
@@ -9973,6 +10101,10 @@ export type SpacemoltCraftData = {
          * 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.
          */
         source?: string;
+        /**
+         * For package recipes: output destination (storage, cargo, faction, or faction:<bucket>); defaults to source. deliver_to is accepted as an alias.
+         */
+        target?: string;
     };
     path?: never;
     query?: never;
@@ -10998,7 +11130,7 @@ export type SpacemoltHuntResponse = SpacemoltHuntResponses[keyof SpacemoltHuntRe
 export type SpacemoltInspectData = {
     body?: {
         /**
-         * Item, module, ship class, system, POI, or base ID to inspect
+         * Visible package, item, module, ship class, system, POI, or base ID to inspect
          */
         id: string;
     };
@@ -13934,6 +14066,21 @@ export type SpacemoltFacilityJobAddData = {
          * Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.
          */
         facility_id: string;
+        /**
+         * For job_add pack_package: selected manifest items.
+         */
+        items?: Array<{
+            item_id: string;
+            quantity: number;
+        }>;
+        /**
+         * For job_add pack_package: player label.
+         */
+        label?: string;
+        /**
+         * For job_add unpack_package: package ID.
+         */
+        package_id?: string;
         /**
          * For 'job_add': number of runs to queue.
          */
@@ -13946,6 +14093,10 @@ export type SpacemoltFacilityJobAddData = {
          * Input source for 'job_add': where inputs/credits are pulled from. Same values as deliver_to; defaults to deliver_to.
          */
         source?: string;
+        /**
+         * Package job_add output destination; defaults to source.
+         */
+        target?: string;
     };
     path?: never;
     query?: never;
@@ -14136,7 +14287,7 @@ export type SpacemoltFacilityListForSaleData = {
          */
         faction?: boolean;
         /**
-         * For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected.
+         * For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected.
          */
         price: number;
     };
@@ -14649,7 +14800,7 @@ export type SpacemoltFacilitySetOutputPriceData = {
          */
         facility_id: string;
         /**
-         * For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected.
+         * For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected.
          */
         price?: number;
     };

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.508.0";
+var GENERATED_SPEC_VERSION = "v0.512.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -516,9 +516,13 @@ var ACTIONS = {
       { name: "deliver_to", type: "string", required: false, description: "Output destination for 'job_add': 'storage' (default), 'faction' (faction main store), or 'faction:<bucket name or id>' for a Storage Extension bucket." },
       { name: "direction", type: '"forward" | "reverse"', required: false, description: "Job direction: 'forward' runs the recipe normally (craft); 'reverse' recycles existing items back to inputs.", enumValues: ["forward", "reverse"] },
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "For job_add pack_package: selected manifest items." },
+      { name: "label", type: "string", required: false, description: "For job_add pack_package: player label." },
+      { name: "package_id", type: "string", required: false, description: "For job_add unpack_package: package ID." },
       { name: "quantity", type: "number", required: false, description: "For 'job_add': number of runs to queue." },
       { name: "recipe_id", type: "string", required: true, description: "Recipe ID to run (for 'job_add' action)." },
-      { name: "source", type: "string", required: false, description: "Input source for 'job_add': where inputs/credits are pulled from. Same values as deliver_to; defaults to deliver_to." }
+      { name: "source", type: "string", required: false, description: "Input source for 'job_add': where inputs/credits are pulled from. Same values as deliver_to; defaults to deliver_to." },
+      { name: "target", type: "string", required: false, description: "Package job_add output destination; defaults to source." }
     ]
   },
   "spacemolt_facility/job_cancel": {
@@ -571,7 +575,7 @@ var ACTIONS = {
     params: [
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
       { name: "faction", type: "boolean", required: false, description: "For 'list_for_sale': set true to list a faction-owned facility (requires manage_facilities permission)." },
-      { name: "price", type: "number", required: true, description: "For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected." }
+      { name: "price", type: "number", required: true, description: "For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected." }
     ]
   },
   "spacemolt_facility/owned": {
@@ -713,7 +717,7 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'dismantle', 'disassemble', 'faction_dismantle', 'faction_disassemble', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
-      { name: "price", type: "number", required: false, description: "For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price others pay, applied to the facility's recipe output(s) automatically — may be fractional (e.g. 0.25), the per-run fee is price × output quantity rounded to a whole credit. Used literally: 0 rents the facility out for free; negative is rejected." }
+      { name: "price", type: "number", required: false, description: "For 'list_for_sale': asking price in whole credits. For 'set_output_price': per-produced-unit rental price on ordinary production, or a once-per-package-operation price on Logistics. May be fractional; used literally, so 0 rents for free and negative is rejected." }
     ]
   },
   "spacemolt_facility/set_public": {
@@ -2263,12 +2267,16 @@ var ACTIONS = {
       { name: "dry_run", type: "boolean", required: false, description: "Return a cost+time quote (materials, labor, rental fee, auto-routed venue, ETA) without queuing or spending anything. Not supported with bulk jobs." },
       { name: "facility_id", type: "string", required: false, description: "Route to a specific facility ID (overrides auto-selection)." },
       { name: "id", type: "string", required: false, description: "Recipe ID to craft (use catalog with type=recipes to see available recipes). Inputs are escrowed from station storage at enqueue.", positional: 0 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "For pack_package: selected items to pack; total unpacked size may not exceed 100." },
       { name: "job_id", type: "string", required: false, description: "Cancel this queued job (refunding its unconsumed inputs, labor, and rental fee) instead of crafting. Use action='queue' to list your job IDs. Setting job_id implies cancel." },
       { name: "job_ids", type: "string[]", required: false, description: "Bulk cancel: cancel many queued jobs in one action. Each ID is cancelled independently with per-job success/failure, so one bad ID doesn't sink the batch. Refunds the unconsumed escrow of every cancelled job." },
-      { name: "jobs", type: "Record<string, unknown>[]", required: false, description: "Bulk mode: queue many crafts in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is queued independently (partial success). Max 50." },
+      { name: "jobs", type: "{ deliver_to?: string; facility_id?: string; items?: { item_id: string; quantity: number }[]; label?: string; package_id?: string; preset?: string; quantity?: number; recipe_id: string; source?: string; target?: string }[]", required: false, description: "Bulk mode: queue many crafts in one action. Package entries may include items, package_id, label, and target. Each job commits independently with partial success. Max 50." },
+      { name: "label", type: "string", required: false, description: "For pack_package: player-authored package label." },
+      { name: "package_id", type: "string", required: false, description: "For unpack_package: package instance ID to unpack." },
       { name: "preset", type: '"fast" | "cheap" | "prefer_own" | "workshop"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee) — both pick the best facility globally, so a busy own facility may route to an idle public rental. Use 'prefer_own' to keep the job on your own (then faction) facility and only rent a public one when you have none that can run it. Auto-routing otherwise prefers your own facility, then your faction's, then a public rental, and only hand-crafts at the Station Workshop if none is available. Use 'workshop' to force hand-crafting even when you have a facility.", enumValues: ["fast", "cheap", "prefer_own", "workshop"] },
       { name: "quantity", type: "number", required: false, description: "Number of output items to make (default 1). Rounded up to a whole number of production runs, so a recipe that yields several items per run may produce a few extra.", positional: 1 },
-      { name: "source", type: "string", required: false, description: "Where inputs and labor/rental credits are pulled FROM. Same values as deliver_to: 'storage', 'faction', or 'faction:<bucket>'. Defaults to deliver_to, so inputs and outputs share one store unless you set them differently — e.g. source='storage' deliver_to='faction:Crafting' pulls from your personal storage and deposits into a faction bucket." }
+      { name: "source", type: "string", required: false, description: "Where inputs and labor/rental credits are pulled FROM. Same values as deliver_to: 'storage', 'faction', or 'faction:<bucket>'. Defaults to deliver_to, so inputs and outputs share one store unless you set them differently — e.g. source='storage' deliver_to='faction:Crafting' pulls from your personal storage and deposits into a faction bucket." },
+      { name: "target", type: "string", required: false, description: "For package recipes: output destination (storage, cargo, faction, or faction:<bucket>); defaults to source. deliver_to is accepted as an alias." }
     ]
   },
   "spacemolt/decline_mission": {
@@ -2531,10 +2539,10 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "inspect",
     kind: "query",
-    summary: "Inspect an item, module, ship class, system, visible POI, or docked base by ID",
+    summary: "Inspect a visible package, item, module, ship class, system, POI, or docked base by ID",
     responseType: "InspectResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Item, module, ship class, system, POI, or base ID to inspect", positional: 0 }
+      { name: "id", type: "string", required: true, description: "Visible package, item, module, ship class, system, POI, or base ID to inspect", positional: 0 }
     ]
   },
   "spacemolt/install_mod": {

package/package.json

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