@spacemolt/lib 13.3.0 → 14.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.590.0`). **296 commands across 19 tools.**
+Every command in `@spacemolt/lib`, generated from the live server spec (`v0.593.0`). **296 commands across 19 tools.**
 
 ## How to call a command
 

package/dist/account.d.ts

@@ -251,12 +251,6 @@ export declare class Account {
      * Multiple listeners may be registered; returns an unsubscribe function.
      */
     onStateChange(listener: (changed: StateSection[]) => void): () => void;
-    /**
-     * Fan an event out to every registered listener. A throwing listener is
-     * warned and skipped — it must never break the caller (frame routing,
-     * mutation correlation, the reconnect loop) or starve later listeners.
-     */
-    private notifyListeners;
     private emitStateChange;
     /** Log out, releasing the connection's authenticated session. */
     logout(): Promise<void>;

package/dist/events/emitter.d.ts

@@ -6,6 +6,13 @@
  * this (loosely-typed) core.
  */
 import type { RawFrame } from '../protocol.js';
+/**
+ * Fan an event out to every registered listener. A throwing listener is warned
+ * and skipped — a listener is told what already happened, so it must never
+ * break the caller (frame routing, mutation correlation, a connect or reconnect
+ * in progress) or starve the listeners after it.
+ */
+export declare function notifyListeners<A extends unknown[]>(listeners: ReadonlySet<(...args: A) => void>, label: string, ...args: A): void;
 type FrameHandler = (frame: RawFrame) => void;
 /**
  * An async iterator over events of one kind, with internal buffering so a slow

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.590.0";
+export declare const GENERATED_SPEC_VERSION = "v0.593.0";
 export type ToolName = "spacemolt" | "spacemolt_arena" | "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" | "active" | "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" | "challenge" | "challenges" | "chat" | "claim" | "claim_prize" | "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" | "dismantle_outpost" | "distress_signal" | "dock" | "edit" | "edit_role" | "engage" | "espionage" | "estimate_purchase" | "facility_set_description" | "faction_build" | "faction_dismantle" | "faction_list" | "faction_owned" | "faction_personnel" | "faction_upgrade" | "fight" | "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_link" | "login_link_poll" | "login_token" | "logout" | "loot" | "mine" | "modify_order" | "mute_notifications" | "name" | "owned" | "pay_bounty" | "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" | "recruit_personnel" | "recycle" | "refit_ship" | "refuel" | "register" | "release" | "reload" | "remove_ally" | "remove_enemy" | "remove_faction" | "remove_player" | "rename_ship" | "renounce" | "repair" | "retreat" | "return" | "rooms" | "scan" | "scan_poi" | "scrap" | "scrap_ship" | "search_systems" | "self_destruct" | "sell" | "sell_ship_to_order" | "service_prize" | "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" | "transfer_personnel" | "travel" | "treat_personnel" | "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

@@ -443,7 +443,7 @@ export interface SpacemoltFactionAdminPostMissionParams {
     title: string;
     /** Optional: triggers like 'open_to_all' to allow non-members */
     triggers?: string[];
-    /** Mission type (delivery, combat, exploration, etc.) */
+    /** Mission type (delivery, combat, exploration, bounty, etc.) */
     type: string;
 }
 export interface SpacemoltFactionAdminPromoteParams {

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

@@ -0,0 +1,11 @@
+/** Runtime kind of a frame-payload field. */
+export type FieldKind = 'string' | 'number' | 'boolean' | 'string[]' | 'number[]' | 'boolean[]';
+/** A frame-payload field's runtime kind, and whether the server always sends it. */
+export interface FrameField {
+    kind: FieldKind;
+    required: boolean;
+}
+/** Every field of the server's `WelcomePayload`, with its runtime kind and required-ness. */
+export declare const WELCOME_PAYLOAD_FIELDS: Readonly<Record<string, FrameField>>;
+/** Every field of the server's `RegisteredPayload`, with its runtime kind and required-ness. */
+export declare const REGISTERED_PAYLOAD_FIELDS: Readonly<Record<string, FrameField>>;

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

@@ -678,15 +678,23 @@ export type AttackLogEntry = {
     emergency_cloak_strength?: number;
     final_damage: number;
     flat_reduction_pct?: number;
+    /**
+     * Ship-level hit chance in [0.05,0.95] that every weapon starts from (separation, skills, modules, stance, speed). Each entry in weapons[] carries its own hit_chance with that weapon's ammo and mine modifiers added.
+     */
     hit_chance: number;
-    hit_roll: number;
+    /**
+     * True when at least one weapon hit. Per-weapon outcomes are in weapons[].
+     */
     hit_success: boolean;
     hull_damage: number;
     ignored_resistance_pct?: number;
+    /**
+     * Sum of the damage of the weapons that hit, after offensive skill and buff bonuses, before the target's stance and defenses. 0 when every weapon missed. Rows recorded before per-weapon rolls report their single-roll volley damage here.
+     */
+    landed_damage: number;
     lifesteal_pct?: number;
     mine_duration?: number;
     off_buff_pct?: number;
-    pre_hit_damage: number;
     raw_damage: number;
     secondary_kind?: string;
     shield_damage: number;
@@ -861,7 +869,7 @@ export type BattleCombatState = {
      */
     disruption_ticks?: number;
     /**
-     * Your ship speed after EM disruption penalties. Webifier penalties are reported separately and affect escape timing.
+     * Your derived combat speed after fitted modules, temporary buffs, pilot skills, EM disruption, and enemy webifiers. This value drives hit chance, maneuvering, escape, and boarding pursuit.
      */
     effective_speed: number;
     /**
@@ -909,11 +917,11 @@ export type BattleCombatState = {
      */
     warp_disrupted: boolean;
     /**
-     * Combined escape-speed penalty from enemy webifiers as a percentage. Webifier penalties add and cap at 75%.
+     * Combined combat-speed penalty from enemy webifiers as a percentage. Webifier penalties add and cap at 75%.
      */
     web_strength_pct?: number;
     /**
-     * An enemy stasis webifier is increasing the time you need to escape.
+     * An enemy stasis webifier is reducing your effective combat speed.
      */
     webbed: boolean;
 };
@@ -5009,6 +5017,14 @@ export type ItemEffect = {
     ammo?: AmmoStats;
     amount?: number;
     duration?: number;
+    /**
+     * Magnitude of the consumable's additional effect. Read together with secondary_stat.
+     */
+    secondary_amount?: number;
+    /**
+     * Stat modified by the consumable's additional effect. Omitted when the item has only one effect.
+     */
+    secondary_stat?: string;
     stat?: string;
     subtype?: string;
     type: string;
@@ -5590,6 +5606,10 @@ export type Module = {
     hull_bonus?: number;
     hull_penalty?: number;
     id: string;
+    /**
+     * Percentage points subtracted from each hostile ECM lock-break roll. Fitted bonuses stack up to the combat resistance cap.
+     */
+    jam_resistance?: number;
     jam_strength?: number;
     latch_resistance?: number;
     latch_strength?: number;
@@ -5615,7 +5635,14 @@ export type Module = {
     reactive_resistance?: number;
     refit_capability?: boolean;
     remote_medical_treatment?: boolean;
+    /**
+     * Hull points repaired per tick on the most-wounded eligible ally.
+     */
     remote_repair_power?: number;
+    /**
+     * Maximum remote-repair range in same-side radial-band distance to an eligible ally.
+     */
+    remote_repair_range?: number;
     required_skills?: {
         [key: string]: number;
     };
@@ -5637,6 +5664,10 @@ export type Module = {
     speed_penalty?: number;
     survey_power?: number;
     targeting_reduction?: number;
+    /**
+     * Percentage points subtracted from hostile sensor-dampener reach reduction. Fitted bonuses stack up to the combat resistance cap.
+     */
+    targeting_resistance?: number;
     tow_speed_penalty?: number;
     tracking_bonus?: number;
     type: string;
@@ -6531,6 +6562,14 @@ export type ObjectiveInfo = {
     system_name?: string;
     target_base_id?: string;
     target_base_name?: string;
+    /**
+     * kill_player objectives only: the username of the pilot this bounty names
+     */
+    target_player?: string;
+    /**
+     * kill_player objectives only: the ID of the pilot this bounty names
+     */
+    target_player_id?: string;
     type: string;
 };
 export type ObjectiveProgressInfo = {
@@ -6554,6 +6593,14 @@ export type ObjectiveProgressInfo = {
     system_name?: string;
     target_base?: string;
     target_base_name?: string;
+    /**
+     * kill_player objectives only: the username of the pilot this bounty names
+     */
+    target_player?: string;
+    /**
+     * kill_player objectives only: the ID of the pilot this bounty names
+     */
+    target_player_id?: string;
     type: string;
 };
 export type OpenOrderSummary = {
@@ -8255,7 +8302,7 @@ export type ShipClass = {
         [key: string]: unknown;
     }>;
     /**
-     * Minimum reputation with the ship's empire to commission or buy this ship (0 = no requirement)
+     * Minimum reputation with the ship's empire to commission or buy this ship (0 = no requirement). Not applied to a faction-funded build at the faction's own station when the faction holds a buy_ship_license for this design — the license authorizes that build instead
      */
     required_reputation?: number;
     /**
@@ -9655,6 +9702,16 @@ export type V2Personnel = {
     injured_marines: number;
 };
 export type V2Player = {
+    /**
+     * NPC arena challenge win counts, keyed by challenge_id. Omitted until the first NPC-trial win; a missing challenge key means zero wins.
+     */
+    arena_won?: {
+        [key: string]: number;
+    };
+    /**
+     * Combat XP earned from arena fights during the UTC date in day, keyed by skill ID in by_skill. Omitted until the first arena fight; a missing skill key means zero XP. The ledger resets when the UTC date changes.
+     */
+    arena_xp?: ArenaXpLedger;
     /**
      * Empire IDs this player holds citizenship in (omitted when empty). Independent of the immutable origin empire.
      */
@@ -10027,6 +10084,18 @@ export type WeaponFireDetail = {
     crit_roll: number;
     damage: number;
     damage_type: string;
+    /**
+     * This weapon's own hit chance in [0.05,0.95]: the entry's hit_chance plus this weapon's loaded ammo accuracy and mine guidance. Present on every weapon that fired; absent on rows recorded before per-weapon rolls.
+     */
+    hit_chance?: number;
+    /**
+     * This weapon's roll in [0,1). It hit when hit_roll < hit_chance. Present on every weapon that fired; absent on rows recorded before per-weapon rolls.
+     */
+    hit_roll?: number;
+    /**
+     * True when this weapon connected. Omitted when it missed, and on rows recorded before per-weapon rolls (use the entry's hit_success there).
+     */
+    hit_success?: boolean;
     instance_id: string;
     name: string;
     type_bonus_pct: number;
@@ -17412,9 +17481,12 @@ export type SpacemoltFactionAdminPostMissionData = {
              * Destination for a deliver_item or dock_at_base objective, as either the station's Base ID or station POI ID. Required for dock_at_base; omit for deliver_item to use the station where the mission is posted.
              */
             target_base_id?: string;
+            /**
+             * Bounty target for a kill_player objective: the pilot's username or player ID. Required for kill_player.
+             */
             target_id?: string;
             /**
-             * Objective type (deliver_item, kill_player, visit_system, etc.)
+             * Objective type (deliver_item, kill_pirate, kill_player, visit_system, dock_at_base)
              */
             type: string;
         }>;
@@ -17436,7 +17508,7 @@ export type SpacemoltFactionAdminPostMissionData = {
          */
         triggers?: Array<string>;
         /**
-         * Mission type (delivery, combat, exploration, etc.)
+         * Mission type (delivery, combat, exploration, bounty, etc.)
          */
         type: string;
     };

package/dist/index.js

@@ -1,3 +1,22 @@
+// src/generated/frames.gen.ts
+var WELCOME_PAYLOAD_FIELDS = {
+  current_tick: { kind: "number", required: true },
+  game_info: { kind: "string", required: true },
+  help_text: { kind: "string", required: true },
+  motd: { kind: "string", required: false },
+  release_date: { kind: "string", required: true },
+  release_notes: { kind: "string[]", required: true },
+  server_time: { kind: "number", required: true },
+  terms: { kind: "string", required: true },
+  tick_rate: { kind: "number", required: true },
+  version: { kind: "string", required: true },
+  website: { kind: "string", required: true }
+};
+var REGISTERED_PAYLOAD_FIELDS = {
+  password: { kind: "string", required: true },
+  player_id: { kind: "string", required: true }
+};
+
 // src/validation.ts
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -24,14 +43,28 @@ function isActionErrorFrame(frame) {
 function isErrorFrame(frame) {
   return frame.type === "error" && hasPayload(frame) && typeof frame.payload.code === "string" && typeof frame.payload.message === "string" && (frame.payload.details === undefined || isRecord(frame.payload.details)) && (frame.payload.pending_command === undefined || typeof frame.payload.pending_command === "string");
 }
+function matchesKind(value, kind) {
+  const element = kind.endsWith("[]") ? kind.slice(0, -2) : undefined;
+  if (element)
+    return Array.isArray(value) && value.every((item) => typeof item === element);
+  return typeof value === kind;
+}
+function matchesFields(payload, fields) {
+  return Object.entries(fields).every(([field, { kind, required }]) => {
+    const value = payload[field];
+    if (value === undefined)
+      return !required;
+    return matchesKind(value, kind);
+  });
+}
 function isWelcomeFrame(frame) {
-  return frame.type === "welcome" && hasPayload(frame) && typeof frame.payload.version === "string" && typeof frame.payload.release_date === "string" && Array.isArray(frame.payload.release_notes) && frame.payload.release_notes.every((note) => typeof note === "string") && typeof frame.payload.tick_rate === "number" && typeof frame.payload.current_tick === "number" && typeof frame.payload.server_time === "number" && (frame.payload.motd === undefined || typeof frame.payload.motd === "string") && typeof frame.payload.game_info === "string" && typeof frame.payload.website === "string" && typeof frame.payload.help_text === "string" && typeof frame.payload.terms === "string";
+  return frame.type === "welcome" && hasPayload(frame) && matchesFields(frame.payload, WELCOME_PAYLOAD_FIELDS);
 }
 function isLoggedInFrame(frame) {
   return frame.type === "logged_in" && hasPayload(frame);
 }
 function isRegisteredFrame(frame) {
-  return frame.type === "registered" && hasPayload(frame) && typeof frame.payload.password === "string" && typeof frame.payload.player_id === "string";
+  return frame.type === "registered" && hasPayload(frame) && matchesFields(frame.payload, REGISTERED_PAYLOAD_FIELDS);
 }
 var STATE_SECTIONS = [
   "player",
@@ -45,7 +78,7 @@ var STATE_SECTIONS = [
   "prize_recoveries"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.590.0";
+var GENERATED_SPEC_VERSION = "v0.593.0";
 var ACTIONS = {
   "spacemolt_arena/accept": {
     tool: "spacemolt_arena",
@@ -996,7 +1029,7 @@ var ACTIONS = {
       { 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, etc.)" }
+      { name: "type", type: "string", required: true, description: "Mission type (delivery, combat, exploration, bounty, etc.)" }
     ]
   },
   "spacemolt_faction_admin/promote": {
@@ -3629,6 +3662,16 @@ function retryAfterMsFromClose(err) {
 }
 
 // src/events/emitter.ts
+function notifyListeners(listeners, label, ...args) {
+  for (const listener of listeners) {
+    try {
+      listener(...args);
+    } catch (err) {
+      console.warn(`[spacemolt] ${label} listener threw: ${err}`);
+    }
+  }
+}
+
 class EventStream {
   onClose;
   buffer = [];
@@ -3923,14 +3966,17 @@ class StateCache {
 function extractPendingAck(structured) {
   if (!structured)
     return;
-  if (structured.pending === true) {
-    return { command: String(structured.command ?? ""), message: String(structured.message ?? "") };
-  }
   const details = structured.details;
-  if (isRecord(details) && details.pending === true) {
-    return { command: String(details.command ?? ""), message: String(details.message ?? "") };
-  }
-  return;
+  const source = structured.pending === true ? structured : isRecord(details) && details.pending === true ? details : undefined;
+  if (!source)
+    return;
+  return {
+    pending: true,
+    command: String(source.command ?? ""),
+    message: String(source.message ?? ""),
+    ...typeof source.auto_docked === "boolean" && { auto_docked: source.auto_docked },
+    ...typeof source.auto_undocked === "boolean" && { auto_undocked: source.auto_undocked }
+  };
 }
 
 class Correlator {
@@ -3964,14 +4010,14 @@ class Correlator {
           return this.rejectInvalidResponse(requestId, pending, frame.type);
         const payload = frame.payload;
         if (pending.kind === "query") {
-          this.settle(requestId);
+          this.pending.delete(requestId);
           pending.resolve({ result: payload.result, structuredContent: payload.structuredContent });
           return true;
         }
         const structured = payload.structuredContent;
         const ack = extractPendingAck(structured);
         if (!ack) {
-          this.settle(requestId);
+          this.pending.delete(requestId);
           pending.resolve({
             command: String(structured?.command ?? ""),
             tick: 0,
@@ -3989,7 +4035,7 @@ class Correlator {
         if (!isActionResultFrame(frame))
           return this.rejectInvalidResponse(requestId, pending, frame.type);
         const payload = frame.payload;
-        this.settle(requestId);
+        this.pending.delete(requestId);
         pending.resolve({
           command: payload.command,
           tick: payload.tick,
@@ -4002,14 +4048,14 @@ class Correlator {
       case "action_error": {
         if (!isActionErrorFrame(frame))
           return this.rejectInvalidResponse(requestId, pending, frame.type);
-        this.settle(requestId);
+        this.pending.delete(requestId);
         pending.reject(errorFromActionFrame(frame));
         return true;
       }
       case "error": {
         if (!isErrorFrame(frame))
           return this.rejectInvalidResponse(requestId, pending, frame.type);
-        this.settle(requestId);
+        this.pending.delete(requestId);
         pending.reject(errorFromFrame(frame));
         return true;
       }
@@ -4022,46 +4068,15 @@ class Correlator {
       pending.reject(err);
     this.pending.clear();
   }
-  settle(requestId) {
-    this.pending.delete(requestId);
-  }
   rejectInvalidResponse(requestId, pending, frameType) {
-    this.settle(requestId);
+    this.pending.delete(requestId);
     pending.reject(new SpacemoltError("invalid_response", `Malformed ${frameType} frame for request ${requestId}`));
     return true;
   }
 }
 
 // src/transport/socket.ts
-class NativeWebSocketAdapter {
-  socket;
-  constructor(url) {
-    this.socket = new WebSocket(url);
-  }
-  send(data) {
-    this.socket.send(data);
-  }
-  close(code, reason) {
-    this.socket.close(code, reason);
-  }
-  addEventListener(...args) {
-    switch (args[0]) {
-      case "open":
-        this.socket.addEventListener("open", () => args[1]());
-        break;
-      case "message":
-        this.socket.addEventListener("message", (event) => args[1]({ data: event.data }));
-        break;
-      case "close":
-        this.socket.addEventListener("close", (event) => args[1]({ code: event.code, reason: event.reason }));
-        break;
-      case "error":
-        this.socket.addEventListener("error", (event) => args[1](event));
-        break;
-    }
-  }
-}
-var defaultFactory = (url) => new NativeWebSocketAdapter(url);
+var defaultFactory = (url) => new WebSocket(url);
 
 class Socket {
   opts;
@@ -4436,17 +4451,8 @@ class Account {
       this.stateListeners.delete(listener);
     };
   }
-  notifyListeners(listeners, label, ...args) {
-    for (const listener of listeners) {
-      try {
-        listener(...args);
-      } catch (err) {
-        console.warn(`[spacemolt] ${label} listener threw: ${err}`);
-      }
-    }
-  }
   emitStateChange(changed) {
-    this.notifyListeners(this.stateListeners, "onStateChange", changed);
+    notifyListeners(this.stateListeners, "onStateChange", changed);
   }
   async logout() {
     await this.query("spacemolt_auth", "logout");
@@ -4870,7 +4876,7 @@ class Account {
     if (this.shouldReconnect(err)) {
       this.reconnectLoop(err);
     } else if (!this.userClosing) {
-      this.notifyListeners(this.disconnectedListeners, "onDisconnected", err);
+      notifyListeners(this.disconnectedListeners, "onDisconnected", err);
     }
   }
   shouldReconnect(err) {
@@ -4889,7 +4895,7 @@ class Account {
     const cfg = this.reconnectConfig;
     const retryAfterMs = retryAfterMsFromClose(err);
     for (let attempt = 1;attempt <= cfg.maxRetries; attempt++) {
-      this.notifyListeners(this.reconnectingListeners, "onReconnecting", attempt);
+      notifyListeners(this.reconnectingListeners, "onReconnecting", attempt);
       const backoff = attempt === 1 && retryAfterMs !== undefined ? retryAfterMs : Math.min(cfg.baseDelayMs * 2 ** (attempt - 1), cfg.maxDelayMs);
       await delay(backoff);
       if (this.userClosing) {
@@ -4899,12 +4905,12 @@ class Account {
       try {
         await this.reconnectOnce();
         this.reconnecting = false;
-        this.notifyListeners(this.reconnectedListeners, "onReconnected");
+        notifyListeners(this.reconnectedListeners, "onReconnected");
         return;
       } catch {}
     }
     this.reconnecting = false;
-    this.notifyListeners(this.disconnectedListeners, "onDisconnected", err);
+    notifyListeners(this.disconnectedListeners, "onDisconnected", err);
   }
   async reconnectOnce() {
     if (!this.credentialsProvider)
@@ -5188,16 +5194,13 @@ class SpacemoltClient {
     return () => this.accountDisconnectedListeners.delete(listener);
   }
   notifyAccountConnected(account) {
-    for (const listener of this.accountConnectedListeners)
-      listener(account);
+    notifyListeners(this.accountConnectedListeners, "onAccountConnected", account);
   }
   notifyAccountReconnected(account) {
-    for (const listener of this.accountReconnectedListeners)
-      listener(account);
+    notifyListeners(this.accountReconnectedListeners, "onAccountReconnected", account);
   }
   notifyAccountDisconnected(id, err) {
-    for (const listener of this.accountDisconnectedListeners)
-      listener(id, err);
+    notifyListeners(this.accountDisconnectedListeners, "onAccountDisconnected", id, err);
   }
   get httpBaseUrl() {
     return this.opts.httpBaseUrl ?? (this.opts.url ? httpBaseFromWs(this.opts.url) : DEFAULT_HTTP_BASE);

package/dist/protocol.d.ts

@@ -7,7 +7,7 @@
  * spec instead (see src/generated/). Endpoint: `/ws/v2`.
  */
 import type { NotificationPayloads, TypedNotificationType } from './generated/notifications.gen.js';
-import type { LoggedInPayload, RegisteredPayload, V2GameState, WelcomePayload } from './generated/openapi/types.gen.js';
+import type { LoggedInPayload, NotificationActionError, NotificationActionResult, PendingActionResponse, RegisteredPayload, V2GameState, WelcomePayload } from './generated/openapi/types.gen.js';
 /** Inbound frame: client -> server. `payload` is omitted when an action takes none. */
 export interface InboundFrame {
     tool: string;
@@ -27,36 +27,25 @@ export interface ResultFrame {
         structuredContent?: Record<string, unknown>;
     };
 }
-/** Mutation-ack: a `result` frame whose structuredContent flags `pending: true`. */
-export interface PendingAck {
-    pending: true;
-    command: string;
-    message: string;
-}
 /** Outcome push for a queued mutation; echoes the original request_id. */
 export interface ActionResultFrame {
     type: 'action_result';
     request_id?: string;
-    payload: {
-        command: string;
-        tick: number;
+    /**
+     * The server's published `Notification_action_result`, except for `result`:
+     * the spec leaves it untyped because the v1 and v2 shapes differ, and on
+     * `/ws/v2` it is always the delta. Narrow it here rather than lose the type.
+     */
+    payload: Omit<NotificationActionResult, 'result'> & {
         /** A V2GameState delta — only the sections that changed. See StateDelta. */
         result: StateDelta;
-        auto_docked?: boolean;
-        auto_undocked?: boolean;
     };
 }
 /** Failure outcome for a queued mutation. */
 export interface ActionErrorFrame {
     type: 'action_error';
     request_id?: string;
-    payload: {
-        command: string;
-        tick: number;
-        code: string;
-        message: string;
-        details?: Record<string, unknown>;
-    };
+    payload: NotificationActionError;
 }
 /** Generic error frame emitted by the framing layer or a handler. */
 export interface ErrorFrame {
@@ -163,11 +152,13 @@ export interface QueryResult<T = Record<string, unknown>> {
     /** Raw JSON for programmatic consumption, typed to the command's response. */
     structuredContent?: T;
 }
-/** The immediate `pending: true` acknowledgement for a queued mutation. */
-export interface MutationAck {
-    command: string;
-    message: string;
-}
+/**
+ * The immediate `pending: true` acknowledgement for a queued mutation. The
+ * server's published `PendingActionResponse`, so the `auto_docked`/
+ * `auto_undocked` flags it carries reach the caller at ack time rather than
+ * only on the final outcome.
+ */
+export type MutationAck = PendingActionResponse;
 /**
  * Resolved value of a two-phase mutation, delivered when the action executes.
  * `TDetails` is the action-specific shape of `delta.details` (e.g. `jump` ->

package/dist/transport/correlator.d.ts

@@ -50,6 +50,5 @@ export declare class Correlator {
     handle(frame: RawFrame): boolean;
     /** Reject every in-flight request — used when the socket closes. */
     rejectAll(err: ConnectionClosedError | SpacemoltError): void;
-    private settle;
     private rejectInvalidResponse;
 }

package/package.json

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