@spacemolt/lib 14.2.1 → 15.0.1

package/dist/index.js

@@ -78,7 +78,7 @@ var STATE_SECTIONS = [
   "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.593.0";
+var GENERATED_SPEC_VERSION = "v0.609.4";
 var ACTIONS = {
   "spacemolt_arena/accept": {
     tool: "spacemolt_arena",
@@ -246,10 +246,11 @@ var ACTIONS = {
     action: "reload",
     kind: "mutation",
     summary: "Reload a weapon's magazine from ammo in cargo",
-    detailsType: "ReloadResponse",
+    detailsType: "ReloadResponse | BulkReloadResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Instance ID of the fitted weapon to reload (use get_ship to see weapon instance IDs)", positional: 0 },
-      { name: "target", type: "string", required: false, description: "Item ID of ammo to load from cargo (must match the weapon's ammo type). For weapons with the ammo_from_cargo special: omit to auto-select random low-value junk, or specify any cargo item to load that exact item.", positional: 1 }
+      { name: "id", type: "string", required: false, description: "Instance ID of the fitted weapon to reload (use get_ship to see weapon instance IDs)", positional: 0 },
+      { name: "target", type: "string", required: false, description: "Item ID of ammo to load from cargo (must match the weapon's ammo type). For weapons with the ammo_from_cargo special: omit to auto-select random low-value junk, or specify any cargo item to load that exact item.", positional: 1 },
+      { name: "weapons", type: "string[]", required: false, description: "Bulk reload: array of {weapon_instance_id, ammo_item_id?} entries loaded in a single action for one tick, however many weapons. Omit weapon_instance_id/ammo_item_id when using this. Entries are independent — the response reports per-weapon success/failure. Maximum 50 entries." }
     ]
   },
   "spacemolt_battle/retreat": {
@@ -506,7 +507,7 @@ var ACTIONS = {
     summary: "License a specific ship design so your faction can build it at its own stations",
     detailsType: "ShipLicenseResponse",
     params: [
-      { name: "ship_class", type: "string", required: true, description: "Ship class id to license (from ship_catalog), e.g. solarian_frigate" }
+      { name: "ship_class", type: "string", required: true, description: "Ship class id to license (from catalog type=ships), e.g. solarian_frigate" }
     ]
   },
   "spacemolt_facility/cancel_listing": {
@@ -1025,8 +1026,8 @@ var ACTIONS = {
       { name: "expiration_hours", type: "number", required: false, description: "Hours before mission expires (default 72, max 720)" },
       { name: "giver_name", type: "string", required: false, description: "Optional: NPC name who gives the mission" },
       { name: "giver_title", type: "string", required: false, description: "Optional: NPC title" },
-      { name: "objectives", type: "{ description: string; item_id?: string; quantity?: number; system_id?: string; target_base_id?: string; target_id?: string; type: string }[]", required: true, description: "List of mission objectives" },
-      { name: "rewards", type: "{ credits?: number; items?: Record<string, unknown>[] }", required: true, description: "Mission rewards (credits, items, reputation)" },
+      { name: "objectives", type: "{ description: string; item_id?: string; pirate_tier?: string; quantity?: number; system_id?: string; target_base_id?: string; target_id?: string; type: string }[]", required: true, description: "List of mission objectives" },
+      { name: "rewards", type: "{ credits?: number; items?: Record<string, unknown> }", required: true, description: "Mission rewards (credits, items, reputation)" },
       { name: "title", type: "string", required: true, description: "Mission title" },
       { name: "triggers", type: "string[]", required: false, description: "Optional: triggers like 'open_to_all' to allow non-members" },
       { name: "type", type: "string", required: true, description: "Mission type (delivery, combat, exploration, bounty, etc.)" }
@@ -1511,7 +1512,7 @@ var ACTIONS = {
     summary: "Submit system intel to your faction's shared map",
     detailsType: "FactionSubmitIntelResponse",
     params: [
-      { name: "systems", type: "Record<string, unknown>[]", required: true, description: "Array of system intel reports. Each entry: system_id (required), name (required), description, empire, police_level, connections (array of {system_id, name, distance} objects or bare ID strings), pois (array of {id, type, name, description, class, position:{x,y}, base_id, base_name, resources:[{resource_id, richness, remaining, max_remaining}]})" }
+      { name: "systems", type: "Record<string, unknown>[]", required: true, description: "Array of system intel reports. Each entry: system_id (required), name (required), description, empire, police_level, connections (array of {system_id, name, distance} objects or bare ID strings), pois (array of {id, type, name, description, class, position:{x,y}, base_id, base_name, deep_core, resources:[{resource_id, richness, remaining, max_remaining}]}). deep_core marks a hidden deep core POI, where the mining too-sparse cutoff never applies" }
     ]
   },
   "spacemolt_intel/submit_trade_intel": {
@@ -1676,7 +1677,7 @@ var ACTIONS = {
     params: [
       { name: "id", type: "string", required: false, description: "UUID of the wreck to loot. Omit when towing a wreck to default to your towed wreck.", positional: 0 },
       { name: "item_id", type: "string", required: false, description: "Specific cargo item ID to loot. Omit to loot everything (all cargo and modules go to cargo hold)." },
-      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot directly onto your ship (requires free slot, CPU, and power). Get module IDs from get_wrecks. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level)." },
+      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot into your cargo hold. Get module IDs from get_wrecks; fit it later at a station with install_mod." },
       { name: "quantity", type: "number", required: false, description: "Quantity of cargo item to loot (only used with item_id)" }
     ]
   },
@@ -1728,7 +1729,8 @@ var ACTIONS = {
     detailsType: "PrizeServiceResponse",
     params: [
       { name: "id", type: "string", required: true, description: "Claimed intact prize record ID at your current POI", positional: 0 },
-      { name: "quantity", type: "number", required: false, description: "Optional quantity. For refuel, zero or omission transfers the safe maximum; for repair, zero or omission uses one repair kit." },
+      { name: "item_id", type: "string", required: false, description: "Optional repair item to spend on repair. Omit to use the cheapest repair item in your cargo." },
+      { name: "quantity", type: "number", required: false, description: "Optional quantity. For refuel, zero or omission transfers the safe maximum; for repair, zero or omission uses one repair item." },
       { name: "service_action", type: '"stop" | "resume" | "redirect" | "refuel" | "repair"', required: true, description: "Physical recovery action to perform", enumValues: ["stop", "resume", "redirect", "refuel", "repair"] },
       { name: "target", type: "string", required: false, description: "Accessible replacement station for redirect" }
     ]
@@ -1834,7 +1836,7 @@ var ACTIONS = {
     params: [
       { name: "bare_hull", type: "boolean", required: false, description: "If true, commission only the hull without its default module loadout. Defaults to false so ships arrive fitted." },
       { name: "fund_from_faction", type: "boolean", required: false, description: "At your own faction's station: build from faction storage and treasury (requires ManageTreasury). Required there; credits-only and provide_materials are rejected." },
-      { name: "id", type: "string", required: true, description: "Ship class ID to commission (use ship_catalog to see options)", positional: 0 },
+      { name: "id", type: "string", required: true, description: "Ship class ID to commission (use catalog type=ships to see options)", positional: 0 },
       { name: "provide_materials", type: "boolean", required: false, description: "At an empire/NPC shipyard: if true, supply build materials from cargo/storage (cheaper); if false, pay credits for everything (default)." },
       { name: "source_missing_materials", type: "boolean", required: false, description: "At an empire/NPC shipyard: take available requirements from cargo then station storage and charge only to source the deficit. Do not combine with provide_materials." }
     ]
@@ -2479,7 +2481,7 @@ var ACTIONS = {
     detailsType: "LootWreckCommandResponse",
     params: [
       { name: "item_id", type: "string", required: false, description: "Specific cargo item ID to loot. Omit to loot everything (all cargo and modules go to cargo hold).", positional: 1 },
-      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot directly onto your ship (requires free slot, CPU, and power). Get module IDs from get_wrecks. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level)." },
+      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot into your cargo hold. Get module IDs from get_wrecks; fit it later at a station with install_mod." },
       { name: "quantity", type: "number", required: false, description: "Quantity of cargo item to loot (only used with item_id)", positional: 2 },
       { name: "wreck_id", type: "string", required: false, description: "UUID of the wreck to loot. Omit when towing a wreck to default to your towed wreck." }
     ]
@@ -2656,7 +2658,7 @@ var ACTIONS = {
       { 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: "preset", type: '"fast" | "cheap" | "prefer_own" | "workshop"', required: false, description: "Auto-routing preset. 'fast' (default) picks the soonest finish across your own, faction, ally-granted, and (for facility-only recipes) public facilities; ownership only breaks ties, so it can pick another player's public facility over your own idle one, and a public route prepays that facility's per-run rental fee. 'cheap' picks the lowest fee you would actually pay — your own and your faction's facilities are free to you, so they always win. 'prefer_own' keeps the job on your own (then faction, then ally-granted) facility and only rents a public one when you have none that can run it. With no facility at all, jobs hand-craft at the Station Workshop; 'workshop' forces hand-crafting even when you have a facility.", enumValues: ["fast", "cheap", "prefer_own", "workshop"] },
       { name: "quantity", type: "number", required: false, description: "Number of output items to make (default 1). Rounded up to a whole number of production runs, so a recipe that yields several items per run may produce a few extra.", positional: 1 },
       { name: "source", type: "string", required: false, description: "Where inputs and labor/rental credits are pulled FROM. Same values as deliver_to: 'storage', 'faction', or 'faction:<bucket>'. Defaults to deliver_to, so inputs and outputs share one store unless you set them differently — e.g. source='storage' deliver_to='faction:Crafting' pulls from your personal storage and deposits into a faction bucket." },
       { name: "target", type: "string", required: false, description: "For package recipes: output destination (storage, cargo, faction, or faction:<bucket>); defaults to source. deliver_to is accepted as an alias." }
@@ -2893,7 +2895,7 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "get_tax_estimate",
     kind: "query",
-    summary: "Preview what taxes you'd owe right now",
+    summary: "See current tax estimates, missed-tax payment guidance, and your latest weekly statement",
     responseType: "TaxEstimateResponse",
     params: []
   },
@@ -3000,7 +3002,7 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "pay_bounty",
     kind: "mutation",
-    summary: "Settle your outstanding bounty with an empire from anywhere",
+    summary: "Pay missed taxes and other outstanding bounties with an empire from anywhere",
     detailsType: "PayBountyResponse",
     params: [
       { name: "id", type: "string", required: false, description: "Empire whose bounty to clear: solarian, voidborn, crimson, nebula, outerrim. Omit when you owe exactly one empire.", positional: 0 },
@@ -3031,7 +3033,7 @@ var ACTIONS = {
       { name: "job_id", type: "string", required: false, description: "Act on this queued job instead of recycling. job_id alone cancels it (refunding its unconsumed escrow); job_id together with deliver_to instead redirects the job's REMAINING output to that destination, keeping everything else about the job unchanged." },
       { name: "job_ids", type: "string[]", required: false, description: "Bulk cancel: cancel many queued jobs in one action. Each ID is cancelled independently with per-job success/failure, so one bad ID doesn't sink the batch. Refunds the unconsumed escrow of every cancelled job." },
       { name: "jobs", type: "Record<string, unknown>[]", required: false, description: "Bulk mode: recycle many recipes in one action. Each entry: {recipe_id, quantity, facility_id?, preset?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is processed independently (partial success). Max 50." },
-      { name: "preset", type: '"fast" | "cheap" | "prefer_own"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) picks the best eligible recycler globally, so a busy own recycler may route to an idle public rental. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. Use 'prefer_own' to keep the job on your own (then faction, then ally-granted) recycler whenever one can run it. Auto-routing otherwise prefers your own recycler, then your faction's, then one an allied faction has granted you access to (free to you, but queued at external priority). 'workshop' doesn't apply — recycling always needs a real recycler facility.", enumValues: ["fast", "cheap", "prefer_own"] },
+      { name: "preset", type: '"fast" | "cheap" | "prefer_own"', required: false, description: "Auto-routing preset. 'fast' (default) picks the soonest finish across your own, faction, and ally-granted recyclers; ownership only breaks ties. 'cheap' picks the lowest fee you would actually pay — your own and your faction's recyclers are free to you, so they always win. 'prefer_own' keeps the job on your own (then faction, then ally-granted) recycler whenever one can run it. 'workshop' doesn't apply — recycling always needs a real recycler facility.", enumValues: ["fast", "cheap", "prefer_own"] },
       { name: "quantity", type: "number", required: false, description: "Number of the recipe's output items to feed in and break down (default 1). Rounded up to a whole number of recycling runs.", positional: 1 },
       { name: "source", type: "string", required: false, description: "Where feedstock (and labor/rental credits) are pulled FROM. Same values as deliver_to. Defaults to deliver_to." }
     ]
@@ -4306,9 +4308,16 @@ class Account {
     });
   }
   makeSocket() {
-    this.socket = new Socket({ url: this.url, webSocketFactory: this.webSocketFactory });
-    this.socket.onFrame = (frame) => this.routeFrame(frame);
-    this.socket.onClose = (err) => this.handleClose(err);
+    const socket = new Socket({ url: this.url, webSocketFactory: this.webSocketFactory });
+    socket.onFrame = (frame) => {
+      if (this.socket === socket)
+        this.routeFrame(frame);
+    };
+    socket.onClose = (err) => {
+      if (this.socket === socket)
+        this.handleClose(err);
+    };
+    this.socket = socket;
   }
   get state() {
     return this.cache.snapshot();
@@ -4449,8 +4458,11 @@ class Account {
     }
   }
   async refresh() {
+    const revision = this.stateRevision;
     const result = await this.commands.spacemolt.get_status();
     const snapshot = requireStructuredContent(result, "spacemolt/get_status");
+    if (revision !== this.stateRevision)
+      return this.cache.snapshot();
     const changed = this.cache.seed(snapshot);
     if (changed.length)
       this.stateRevision++;
@@ -4981,10 +4993,19 @@ class Account {
   async reconnectOnce() {
     if (!this.credentialsProvider)
       throw new Error("reconnectOnce requires credentials");
+    const stopIfClosed = () => {
+      if (!this.userClosing)
+        return;
+      this.socket.close();
+      throw new ConnectionClosedError("account was closed");
+    };
+    stopIfClosed();
     this.socket.close();
     this.makeSocket();
     await this.open();
+    stopIfClosed();
     await this.authenticate(await this.credentialsProvider());
+    stopIfClosed();
     await this.resubscribe();
   }
   async resubscribe() {
@@ -5049,6 +5070,7 @@ function normalizeCatalog(value) {
   const data = requireRecord(value, "catalog response");
   return {
     version: typeof data.version === "string" ? data.version : "",
+    mining: isRecord(data.mining) ? data.mining : {},
     ships: catalogEntries(data.ships),
     items: catalogEntries(data.items),
     recipes: catalogEntries(data.recipes),
@@ -5481,7 +5503,13 @@ class SpacemoltClient {
       return;
     }
     this.reconnectingIds.add(id);
-    this.enqueueRateLimited(() => this.withConnectRetry(() => account.reconnectOnce())).then(() => this.notifyAccountReconnected(account)).catch((reconnectErr) => {
+    const wanted = () => this.connected.get(id) === account;
+    this.enqueueRateLimited(() => this.withConnectRetry(async () => wanted() ? account.reconnectOnce() : undefined)).then(() => {
+      if (wanted())
+        this.notifyAccountReconnected(account);
+    }).catch((reconnectErr) => {
+      if (!wanted())
+        return;
       console.warn(`[spacemolt] failed to reconnect "${id}": ${reconnectErr}`);
       this.connected.delete(id);
       this.notifyAccountDisconnected(id, err);
@@ -5542,6 +5570,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "action_error",
   "action_result",
   "arena_challenge",
+  "arena_objective",
   "base_destroyed",
   "base_raid_update",
   "battle_alert",
@@ -5552,12 +5581,15 @@ var TYPED_NOTIFICATION_TYPES = [
   "battle_started",
   "battle_update",
   "chat_message",
+  "cloak",
+  "complete_mission",
   "crafting_update",
   "drone_adrift",
   "drone_destroyed",
   "drone_scan",
   "drone_survey",
   "drone_update",
+  "error",
   "facility_reclaimed",
   "facility_rent_warning",
   "faction_alliance_broken",
@@ -5566,9 +5598,11 @@ var TYPED_NOTIFICATION_TYPES = [
   "faction_peace_accepted",
   "faction_peace_proposal",
   "faction_war_declared",
+  "fleet",
   "market_update",
   "mining_yield",
   "observation_update",
+  "ok",
   "personnel_update",
   "pilotless_ship",
   "pirate_destroyed",
@@ -5578,6 +5612,8 @@ var TYPED_NOTIFICATION_TYPES = [
   "prize_update",
   "ranch_poached",
   "reconnected",
+  "refueled_by",
+  "repaired_by",
   "scan_detected",
   "server_restart_warning",
   "ship_captured",

package/dist/push-frames.d.ts

@@ -3,15 +3,16 @@
  *
  * Every other push frame is typed from the server's published
  * `Notification_<msg_type>` schema, and the generated `NotificationPayloads`
- * map carries it. These two families publish no schema at all — neither
- * appears in the spec's notification union — so without this file they reach a
- * consumer as `Record<string, unknown>`.
+ * map carries it. These two families publish only a single flat object each —
+ * optional fields and a free-form `action` string, covering a few variants — so
+ * the generated type cannot narrow to a variant's fields.
  *
  * They are hand-written rather than published because splitting them into
  * distinct `msg_type`s is the fix, and that breaks any v1 client switching on
  * `type === "ok"`. Until v1 is retired the shapes live here.
- * `tests/push-frames.test.ts` fails the moment the server does publish either
- * schema, which is the signal to delete this file and let codegen take over.
+ * `tests/push-frames.test.ts` fails the moment the server publishes either
+ * schema as a union, which is the signal to delete this file and let codegen
+ * take over.
  *
  * **Two discriminators.** Most `ok` variants key on `action`; seven key on
  * `type` instead. That split is the server's, not ours, so a bare `p.action`

package/package.json

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