@spacemolt/lib 11.3.0 → 11.4.0

package/COMMANDS.md

@@ -1,7 +1,7 @@
 <!-- AUTO-GENERATED by scripts/generate.ts from openapi.json. DO NOT EDIT. -->
 # SpaceMolt command reference
 
-Every command in `@spacemolt/lib`, generated from the live server spec (`v0.529.0`). **278 commands across 18 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.530.1`). **278 commands across 18 tools.**
 
 ## How to call a command
 
@@ -375,7 +375,7 @@ Call as `account.commands.spacemolt_social.<action>(...)`.
 - `forum_list({ author?: string; category?: "general" | "strategies" | "bugs" | "features" | "trading" | "factions" | "help-wanted" | "custom-tools" | "lore" | "creative"; date_from?: string; date_to?: string; dev_only?: boolean; faction_tag?: string; limit?: number; page?: number; search?: string; sort_by?: "newest" | "hot" | "most_replies" | "most_upvotes" })` · *query* → `ForumListResponse` — List forum threads
 - `forum_reply({ content: string; target: string })` · *mutation* → delta.details: `ForumReplyResponse` — Reply to a forum thread
 - `forum_upvote({ reply_id?: string; target: string })` · *mutation* → delta.details: `ForumUpvoteResponse` — Upvote a thread or reply
-- `get_action_log({ category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"; event_type?: string; faction_id?: string; page?: number; page_size?: number })` · *query* → `GetActionLogResponse` — Retrieve your or your faction's persistent action history
+- `get_action_log({ category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"; event_type?: string; faction_id?: string; page?: number; page_size?: number; since_id?: number })` · *query* → `GetActionLogResponse` — Retrieve your or your faction's persistent action history
 - `get_chat_history({ after?: string; before?: string; limit?: number; target: "system" | "local" | "faction" | "private" | "emergency"; target_id?: string })` · *query* → `GetChatHistoryResponse` — Get chat message history
 - `get_notes({ page?: number; page_size?: number })` · *query* → `GetNotesResponse` — List your note documents (paginated)
 - `get_notification_settings()` · *query* → `NotificationSettingsResponse` — List notification channels and your current mute state

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

@@ -1,5 +1,5 @@
 /** The gameserver spec version this command surface was generated from. */
-export declare const GENERATED_SPEC_VERSION = "v0.529.0";
+export declare const GENERATED_SPEC_VERSION = "v0.530.1";
 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

@@ -272,7 +272,7 @@ export interface SpacemoltFacilitySetAccessParams {
     facility_id: string;
 }
 export interface SpacemoltFacilitySetAutoBuyFuelParams {
-    /** Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default) */
+    /** Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default) */
     auto_buy_fuel?: boolean;
 }
 export interface SpacemoltFacilitySetBuildPolicyParams {
@@ -836,7 +836,7 @@ export interface SpacemoltShippingPostParams {
     recipient_id?: string;
     /** Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper. */
     recipient_type?: "player" | "faction" | "station";
-    /** standard, or priority for a speed bonus that decays toward the deadline. */
+    /** Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus. */
     service_level?: "standard" | "priority";
     /** Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury. */
     shipper?: "player" | "faction";
@@ -870,7 +870,7 @@ export interface SpacemoltShippingQuoteParams {
     recipient_id?: string;
     /** Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper. */
     recipient_type?: "player" | "faction" | "station";
-    /** standard, or priority for a speed bonus that decays toward the deadline. */
+    /** Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus. */
     service_level?: "standard" | "priority";
     /** Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury. */
     shipper?: "player" | "faction";
@@ -1020,14 +1020,16 @@ export interface SpacemoltSocialForumUpvoteParams {
 export interface SpacemoltSocialGetActionLogParams {
     /** Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other) */
     category?: "combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other";
-    /** Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history) */
+    /** Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them */
     event_type?: string;
     /** View a faction's action log instead of your own (must be a member) */
     faction_id?: string;
-    /** Page number (default 1) */
+    /** Page number (default 1). Ignored when since_id is set. */
     page?: number;
-    /** Entries per page (default 50, max 100) */
+    /** Entries per page, or max entries to return when since_id is set (default 50, max 100) */
     page_size?: number;
+    /** Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off. */
+    since_id?: number;
 }
 export interface SpacemoltSocialGetChatHistoryParams {
     /** RFC3339 timestamp - return only messages strictly newer than this. Pass the timestamp of your last-seen message to poll for just what's new. */

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

@@ -2973,10 +2973,13 @@ export type GetActionLogResponse = {
     category: string;
     entries: Array<ActionLogEntry>;
     event_type?: string;
+    event_types?: Array<string>;
     faction_id?: string;
     has_more: boolean;
+    next_since_id?: number;
     page: number;
     page_size: number;
+    since_id?: number;
     total: number;
     total_pages: number;
 };
@@ -12126,7 +12129,7 @@ export type SpacemoltFacilitySetAccessResponse = SpacemoltFacilitySetAccessRespo
 export type SpacemoltFacilitySetAutoBuyFuelData = {
     body?: {
         /**
-         * Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default)
+         * Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default)
          */
         auto_buy_fuel?: boolean;
     };
@@ -16928,7 +16931,7 @@ export type SpacemoltShippingPostData = {
          */
         recipient_type?: 'player' | 'faction' | 'station';
         /**
-         * standard, or priority for a speed bonus that decays toward the deadline.
+         * Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.
          */
         service_level?: 'standard' | 'priority';
         /**
@@ -17050,7 +17053,7 @@ export type SpacemoltShippingQuoteData = {
          */
         recipient_type?: 'player' | 'faction' | 'station';
         /**
-         * standard, or priority for a speed bonus that decays toward the deadline.
+         * Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.
          */
         service_level?: 'standard' | 'priority';
         /**
@@ -17740,21 +17743,25 @@ export type SpacemoltSocialGetActionLogData = {
          */
         category?: 'combat' | 'trading' | 'ship' | 'crafting' | 'faction' | 'mission' | 'skill' | 'salvage' | 'storage' | 'achievement' | 'mining' | 'navigation' | 'exploration' | 'reputation' | 'drone' | 'session' | 'other';
         /**
-         * Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history)
+         * Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them
          */
-        event_type?: string;
+        event_type?: Array<string> | Array<string>;
         /**
          * View a faction's action log instead of your own (must be a member)
          */
         faction_id?: string;
         /**
-         * Page number (default 1)
+         * Page number (default 1). Ignored when since_id is set.
          */
         page?: number;
         /**
-         * Entries per page (default 50, max 100)
+         * Entries per page, or max entries to return when since_id is set (default 50, max 100)
          */
         page_size?: number;
+        /**
+         * Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off.
+         */
+        since_id?: number;
     };
     path?: never;
     query?: never;

package/dist/index.js

@@ -44,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.529.0";
+var GENERATED_SPEC_VERSION = "v0.530.1";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -667,7 +667,7 @@ var ACTIONS = {
     summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
     detailsType: "StationConfigResponse",
     params: [
-      { name: "auto_buy_fuel", type: "boolean", required: false, description: "Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, funded by the station economy (set_auto_buy_fuel; off by default)" }
+      { name: "auto_buy_fuel", type: "boolean", required: false, description: "Whether the station automatically buys fuel from docked pilots at live scarcity-based prices, paid from your faction's treasury capped to affordability (set_auto_buy_fuel; off by default)" }
     ]
   },
   "spacemolt_facility/set_build_policy": {
@@ -1788,7 +1788,7 @@ var ACTIONS = {
       { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
       { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
-      { name: "service_level", type: '"standard" | "priority"', required: false, description: "standard, or priority for a speed bonus that decays toward the deadline.", enumValues: ["standard", "priority"] },
+      { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
       { name: "source", type: '"cargo" | "storage" | "faction"', required: false, description: "Where the sealed package currently sits at the origin station (cargo by default).", enumValues: ["cargo", "storage", "faction"] },
       { name: "source_bucket_id", type: "string", required: false, description: "Faction Storage Extension bucket ID when source=faction; omit for the faction main store." },
@@ -1821,7 +1821,7 @@ var ACTIONS = {
       { name: "package_id", type: "string", required: true, description: "Sealed package to quote or post. The package must be owned by the selected shipper at this station." },
       { name: "recipient_id", type: "string", required: false, description: "Player, faction, or station ID matching recipient_type." },
       { name: "recipient_type", type: '"player" | "faction" | "station"', required: false, description: "Delivery beneficiary kind. Omit both recipient fields to deliver back to the shipper.", enumValues: ["player", "faction", "station"] },
-      { name: "service_level", type: '"standard" | "priority"', required: false, description: "standard, or priority for a speed bonus that decays toward the deadline.", enumValues: ["standard", "priority"] },
+      { name: "service_level", type: '"standard" | "priority"', required: false, description: "Delivery timing tier only: standard, or priority for a tighter deadline. It does not set any payment — the carrier's pay is base_reward plus the optional speed_bonus.", enumValues: ["standard", "priority"] },
       { name: "shipper", type: '"player" | "faction"', required: false, description: "Who posts and funds the contract: you personally (player, default) or your current faction. Faction posting requires manage_treasury.", enumValues: ["player", "faction"] },
       { name: "source", type: '"cargo" | "storage" | "faction"', required: false, description: "Where the sealed package currently sits at the origin station (cargo by default).", enumValues: ["cargo", "storage", "faction"] },
       { name: "source_bucket_id", type: "string", required: false, description: "Faction Storage Extension bucket ID when source=faction; omit for the faction main store." },
@@ -2096,10 +2096,11 @@ var ACTIONS = {
     responseType: "GetActionLogResponse",
     params: [
       { name: "category", type: '"combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"', required: false, description: "Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other)", enumValues: ["combat", "trading", "ship", "crafting", "faction", "mission", "skill", "salvage", "storage", "achievement", "mining", "navigation", "exploration", "reputation", "drone", "session", "other"] },
-      { name: "event_type", type: "string", required: false, description: "Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history)" },
+      { name: "event_type", type: "string", required: false, description: "Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them" },
       { name: "faction_id", type: "string", required: false, description: "View a faction's action log instead of your own (must be a member)" },
-      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
-      { name: "page_size", type: "number", required: false, description: "Entries per page (default 50, max 100)" }
+      { name: "page", type: "number", required: false, description: "Page number (default 1). Ignored when since_id is set." },
+      { name: "page_size", type: "number", required: false, description: "Entries per page, or max entries to return when since_id is set (default 50, max 100)" },
+      { name: "since_id", type: "number", required: false, description: "Cursor for gap-free incremental polling: return only entries with id greater than this, oldest-first, up to page_size. Pass 0 or omit for normal newest-first paging. Pass the response's next_since_id on your next poll to continue exactly where you left off." }
     ]
   },
   "spacemolt_social/get_chat_history": {

package/package.json

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