@spacemolt/lib 4.6.0 → 7.1.0

package/dist/index.js

@@ -1,4 +1,38 @@
+// src/validation.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireRecord(value, source) {
+  if (!isRecord(value))
+    throw new TypeError(`${source} must be a JSON object`);
+  return value;
+}
+
 // src/protocol.ts
+function hasPayload(frame) {
+  return isRecord(frame.payload);
+}
+function isResultFrame(frame) {
+  return frame.type === "result" && hasPayload(frame) && "result" in frame.payload && (frame.payload.structuredContent === undefined || isRecord(frame.payload.structuredContent));
+}
+function isActionResultFrame(frame) {
+  return frame.type === "action_result" && hasPayload(frame) && typeof frame.payload.command === "string" && typeof frame.payload.tick === "number" && isRecord(frame.payload.result) && (frame.payload.auto_docked === undefined || typeof frame.payload.auto_docked === "boolean") && (frame.payload.auto_undocked === undefined || typeof frame.payload.auto_undocked === "boolean");
+}
+function isActionErrorFrame(frame) {
+  return frame.type === "action_error" && hasPayload(frame) && typeof frame.payload.command === "string" && typeof frame.payload.tick === "number" && typeof frame.payload.code === "string" && typeof frame.payload.message === "string" && (frame.payload.details === undefined || isRecord(frame.payload.details));
+}
+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 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";
+}
+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";
+}
 var STATE_SECTIONS = [
   "player",
   "ship",
@@ -10,7 +44,7 @@ var STATE_SECTIONS = [
   "skills"
 ];
 // src/generated/actions.gen.ts
-var GENERATED_SPEC_VERSION = "v0.485.0";
+var GENERATED_SPEC_VERSION = "v0.508.0";
 var ACTIONS = {
   "spacemolt_auth/claim": {
     tool: "spacemolt_auth",
@@ -81,6 +115,19 @@ var ACTIONS = {
       { name: "side_id", type: "number", required: false, description: "Side to join (optional for action=engage — auto-assigned by faction if omitted)" }
     ]
   },
+  "spacemolt_battle/log": {
+    tool: "spacemolt_battle",
+    action: "log",
+    kind: "query",
+    summary: "View the tick-by-tick combat replay of a battle by ID",
+    responseType: "GetBattleLogResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Battle ID to replay (active or completed, yours or not)", positional: 0 },
+      { name: "limit", type: "number", required: false, description: "Max ticks to return (default 50, max 200)" },
+      { name: "tick_end", type: "number", required: false, description: "Last tick to include (default unbounded)" },
+      { name: "tick_start", type: "number", required: false, description: "First tick to include (default 0)" }
+    ]
+  },
   "spacemolt_battle/reload": {
     tool: "spacemolt_battle",
     action: "reload",
@@ -118,6 +165,16 @@ var ACTIONS = {
     responseType: "GetBattleStatusResponse",
     params: []
   },
+  "spacemolt_battle/summary": {
+    tool: "spacemolt_battle",
+    action: "summary",
+    kind: "query",
+    summary: "View the aggregate result of a battle by ID",
+    responseType: "BattleSummaryResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Battle ID to summarize (active or completed, yours or not)", positional: 0 }
+    ]
+  },
   "spacemolt_battle/target": {
     tool: "spacemolt_battle",
     action: "target",
@@ -322,10 +379,10 @@ var ACTIONS = {
     tool: "spacemolt_facility",
     action: "buy_ship_license",
     kind: "mutation",
-    summary: "Buy an empire shipbuilding license so your faction can build that empire's hulls at its own stations",
+    summary: "License a specific ship design so your faction can build it at its own stations",
     detailsType: "ShipLicenseResponse",
     params: [
-      { name: "empire", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Empire to license shipbuilding from", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"] }
+      { name: "ship_class", type: "string", required: true, description: "Ship class id to license (from ship_catalog), e.g. solarian_frigate" }
     ]
   },
   "spacemolt_facility/cancel_listing": {
@@ -348,6 +405,16 @@ var ACTIONS = {
       { name: "name", type: "string", required: true, description: "Name for the new faction outpost" }
     ]
   },
+  "spacemolt_facility/disassemble": {
+    tool: "spacemolt_facility",
+    action: "disassemble",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
   "spacemolt_facility/dismantle": {
     tool: "spacemolt_facility",
     action: "dismantle",
@@ -355,7 +422,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
     ]
   },
   "spacemolt_facility/facility_set_description": {
@@ -366,7 +433,7 @@ var ACTIONS = {
     responseType: "FacilityResponse",
     params: [
       { name: "description", type: "string", required: false, description: "For 'personal_decorate': a text description of your personal quarters (what visitors see, hear, and feel). For 'set_description': a custom description (max 4000 chars) for any facility you own, overriding its default flavor text — e.g. re-flavoring your faction's bar. Send empty to clear it." },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
     ]
   },
   "spacemolt_facility/faction_build": {
@@ -380,6 +447,16 @@ var ACTIONS = {
       { name: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
     ]
   },
+  "spacemolt_facility/faction_disassemble": {
+    tool: "spacemolt_facility",
+    action: "faction_disassemble",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
   "spacemolt_facility/faction_dismantle": {
     tool: "spacemolt_facility",
     action: "faction_dismantle",
@@ -387,7 +464,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
     ]
   },
   "spacemolt_facility/faction_list": {
@@ -414,7 +491,7 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
     ]
   },
@@ -438,7 +515,7 @@ var ACTIONS = {
     params: [
       { 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', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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: "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." }
@@ -462,7 +539,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     responseType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
     ]
   },
   "spacemolt_facility/job_reorder": {
@@ -472,7 +549,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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: "job_id", type: "string", required: true, description: "Job ID (for 'job_cancel', 'job_reorder'). Use action 'job_list' to see job IDs." },
       { name: "position", type: "number", required: false, description: "New queue position for 'job_reorder' (1-based)." }
     ]
@@ -492,7 +569,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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." }
     ]
@@ -556,6 +633,16 @@ var ACTIONS = {
       { name: "player", type: "string", required: true, description: "Target player id or username (allow_player/remove_player/ban/unban)" }
     ]
   },
+  "spacemolt_facility/repair": {
+    tool: "spacemolt_facility",
+    action: "repair",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
   "spacemolt_facility/set_access": {
     tool: "spacemolt_facility",
     action: "set_access",
@@ -564,7 +651,17 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "access", type: '"private" | "public"', required: true, description: "For 'personal_decorate': who can visit your quarters. For 'set_access': 'public' opens your facility to renters, 'private' closes it.", enumValues: ["private", "public"] },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
+    ]
+  },
+  "spacemolt_facility/set_auto_buy_fuel": {
+    tool: "spacemolt_facility",
+    action: "set_auto_buy_fuel",
+    kind: "mutation",
+    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)" }
     ]
   },
   "spacemolt_facility/set_build_policy": {
@@ -605,7 +702,7 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "custom_name", type: "string", required: false, description: "For 'set_name': a custom name for the facility (3-32 chars) so multiple facilities of the same type stand out. Send empty to clear it." },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 }
+      { name: "facility_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 }
     ]
   },
   "spacemolt_facility/set_output_price": {
@@ -615,7 +712,7 @@ var ACTIONS = {
     summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
     detailsType: "FacilityResponse",
     params: [
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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." }
     ]
   },
@@ -686,7 +783,7 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "direction", type: '"to_faction" | "to_player"', required: true, description: "Transfer direction: 'to_faction' moves the facility to faction ownership; 'to_player' transfers it to a specific player.", enumValues: ["to_faction", "to_player"] },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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: "player_id", type: "string", required: false, description: "Target player ID for 'transfer' action with direction 'to_player'." }
     ]
   },
@@ -723,7 +820,7 @@ var ACTIONS = {
     detailsType: "FacilityResponse",
     params: [
       { name: "bucket", type: "string", required: false, description: "For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way." },
-      { name: "facility_id", type: "string", required: true, description: "Facility instance ID (required for 'upgrade', 'job_add', 'job_list', 'set_output_price', 'set_access', 'set_name', 'set_description' actions). Use action 'list' to see facility IDs.", positional: 1 },
+      { name: "facility_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: "facility_type", type: "string", required: true, description: "Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.", positional: 0 }
     ]
   },
@@ -1412,9 +1509,7 @@ var ACTIONS = {
     kind: "mutation",
     summary: "Purchase ship insurance",
     detailsType: "BuyInsuranceResponse",
-    params: [
-      { name: "ticks", type: "number", required: true, description: "Number of ticks to insure for" }
-    ]
+    params: []
   },
   "spacemolt_salvage/loot": {
     tool: "spacemolt_salvage",
@@ -1566,8 +1661,9 @@ var ACTIONS = {
     summary: "Commission a ship to be built at this shipyard",
     detailsType: "CommissionShipResponse",
     params: [
+      { 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: "provide_materials", type: "boolean", required: false, description: "If true, supply build materials from cargo/storage (cheaper). If false, pay credits for everything (default)." }
+      { 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)." }
     ]
   },
   "spacemolt_ship/commission_status": {
@@ -1638,16 +1734,6 @@ var ACTIONS = {
       { name: "id", type: "string", required: true, description: "ID of the ship to permanently destroy (no credits returned). Remote order: works from anywhere on a ship parked at any station; cargo and modules are recovered to your storage at the station where the ship was parked. Use list_ships to see your fleet.", positional: 0 }
     ]
   },
-  "spacemolt_ship/sell_ship": {
-    tool: "spacemolt_ship",
-    action: "sell_ship",
-    kind: "mutation",
-    summary: "Sell a stored ship at the current station",
-    detailsType: "SellShipResponse",
-    params: [
-      { name: "id", type: "string", required: true, description: "ID of the stored ship to sell (use list_ships to see your fleet)", positional: 0 }
-    ]
-  },
   "spacemolt_ship/sell_ship_to_order": {
     tool: "spacemolt_ship",
     action: "sell_ship_to_order",
@@ -2117,10 +2203,10 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "attack",
     kind: "mutation",
-    summary: "Attack another player, pirate, or empire NPC",
+    summary: "Attack another player, pirate, empire NPC, creature, or station",
     detailsType: "AttackResponse",
     params: [
-      { name: "id", type: "string", required: true, description: "Player ID to attack", positional: 0 }
+      { name: "id", type: "string", required: true, description: "ID of the target: a player, pirate, empire NPC, wildlife creature, or station. Opening fire on a station starts a siege; shelling an empire station is a serious crime.", positional: 0 }
     ]
   },
   "spacemolt/buy": {
@@ -2180,7 +2266,7 @@ var ACTIONS = {
       { 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: "preset", type: '"fast" | "cheap" | "workshop"', required: false, description: "Auto-routing preset: 'fast' (fewest ticks, default) or 'cheap' (lowest fee). Auto-routing 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", "workshop"] },
+      { 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." }
     ]
@@ -2441,6 +2527,16 @@ var ACTIONS = {
       { name: "id", type: "string", required: true, description: "Creature ID to hunt (from the 'creatures' list in get_nearby)", positional: 0 }
     ]
   },
+  "spacemolt/inspect": {
+    tool: "spacemolt",
+    action: "inspect",
+    kind: "query",
+    summary: "Inspect an item, module, ship class, system, visible 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 }
+    ]
+  },
   "spacemolt/install_mod": {
     tool: "spacemolt",
     action: "install_mod",
@@ -2530,7 +2626,8 @@ var ACTIONS = {
       { name: "id", type: "string", required: false, description: "Recipe ID to recycle (the recycler consumes the recipe's outputs and returns a lossy fraction of its inputs). Use catalog with type=recipes to browse.", positional: 0 },
       { name: "job_id", type: "string", required: false, description: "Cancel this queued job (refunding its unconsumed escrow) instead of recycling. 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: recycle many recipes in one action. Each entry: {recipe_id, quantity, facility_id?, deliver_to?, source?}. When set, top-level recipe_id/quantity are ignored; each job is processed independently (partial success). Max 50." },
+      { 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) or 'cheap' (lowest fee) — both pick the best eligible recycler globally. Use 'prefer_own' to keep the job on your own (then faction) 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." }
     ]
@@ -2659,10 +2756,11 @@ var ACTIONS = {
     tool: "spacemolt",
     action: "unload_passenger",
     kind: "mutation",
-    summary: "Put a passenger (or everyone) off the ship at the current station",
+    summary: "Put a passenger (or everyone) off the ship here — or hand them off to another ship or your faction's transit lounge for a connecting flight",
     detailsType: "UnloadPassengerResponse",
     params: [
-      { name: "id", type: "string", required: true, description: 'Name (or citizen ID) of the passenger to put off the ship at the current station, or "all" to put every passenger off at once.', positional: 0 }
+      { name: "id", type: "string", required: true, description: 'Name (or citizen ID) of the passenger to put off the ship at the current station, or "all" to put every passenger off at once.', positional: 0 },
+      { name: "target", type: "string", required: false, description: `Optional connecting-flight handoff: "lounge" checks the passenger(s) into your faction's Transit Lounge here, or a ship ID/name transfers them to that docked ship (yours or a faction mate's, needs free berths). Fares and deadlines continue unchanged. Omit for a normal delivery/strand.` }
     ]
   },
   "spacemolt/unsubscribe_observation": {
@@ -2738,6 +2836,7 @@ function buildCommands(dispatch) {
       get_tax_estimate: bind("spacemolt", "get_tax_estimate"),
       get_version: bind("spacemolt", "get_version"),
       hunt: bind("spacemolt", "hunt"),
+      inspect: bind("spacemolt", "inspect"),
       install_mod: bind("spacemolt", "install_mod"),
       jettison: bind("spacemolt", "jettison"),
       jump: bind("spacemolt", "jump"),
@@ -2774,10 +2873,12 @@ function buildCommands(dispatch) {
     spacemolt_battle: {
       advance: bind("spacemolt_battle", "advance"),
       engage: bind("spacemolt_battle", "engage"),
+      log: bind("spacemolt_battle", "log"),
       reload: bind("spacemolt_battle", "reload"),
       retreat: bind("spacemolt_battle", "retreat"),
       stance: bind("spacemolt_battle", "stance"),
       status: bind("spacemolt_battle", "status"),
+      summary: bind("spacemolt_battle", "summary"),
       target: bind("spacemolt_battle", "target")
     },
     spacemolt_citizenship: {
@@ -2807,9 +2908,11 @@ function buildCommands(dispatch) {
       buy_ship_license: bind("spacemolt_facility", "buy_ship_license"),
       cancel_listing: bind("spacemolt_facility", "cancel_listing"),
       deploy_outpost: bind("spacemolt_facility", "deploy_outpost"),
+      disassemble: bind("spacemolt_facility", "disassemble"),
       dismantle: bind("spacemolt_facility", "dismantle"),
       facility_set_description: bind("spacemolt_facility", "facility_set_description"),
       faction_build: bind("spacemolt_facility", "faction_build"),
+      faction_disassemble: bind("spacemolt_facility", "faction_disassemble"),
       faction_dismantle: bind("spacemolt_facility", "faction_dismantle"),
       faction_list: bind("spacemolt_facility", "faction_list"),
       faction_owned: bind("spacemolt_facility", "faction_owned"),
@@ -2827,7 +2930,9 @@ function buildCommands(dispatch) {
       personal_visit: bind("spacemolt_facility", "personal_visit"),
       remove_faction: bind("spacemolt_facility", "remove_faction"),
       remove_player: bind("spacemolt_facility", "remove_player"),
+      repair: bind("spacemolt_facility", "repair"),
       set_access: bind("spacemolt_facility", "set_access"),
+      set_auto_buy_fuel: bind("spacemolt_facility", "set_auto_buy_fuel"),
       set_build_policy: bind("spacemolt_facility", "set_build_policy"),
       set_description: bind("spacemolt_facility", "set_description"),
       set_market_fee: bind("spacemolt_facility", "set_market_fee"),
@@ -2948,7 +3053,6 @@ function buildCommands(dispatch) {
       refit_ship: bind("spacemolt_ship", "refit_ship"),
       rename_ship: bind("spacemolt_ship", "rename_ship"),
       scrap_ship: bind("spacemolt_ship", "scrap_ship"),
-      sell_ship: bind("spacemolt_ship", "sell_ship"),
       sell_ship_to_order: bind("spacemolt_ship", "sell_ship_to_order"),
       supply_commission: bind("spacemolt_ship", "supply_commission"),
       switch_ship: bind("spacemolt_ship", "switch_ship"),
@@ -2999,11 +3103,26 @@ function buildCommands(dispatch) {
 }
 
 // src/auth/clerk.ts
-async function clerkFetch(fetchImpl, url, apiKey, init) {
-  const res = await fetchImpl(url, {
-    ...init,
-    headers: { accept: "application/json", authorization: `Bearer ${apiKey}`, ...init?.headers ?? {} }
+async function resolveAuthHeaders(auth) {
+  if (auth.apiKey === undefined && auth.headers === undefined) {
+    throw new Error("Clerk auth requires an `apiKey` or `headers`");
+  }
+  const headers = new Headers(auth.apiKey === undefined ? undefined : { authorization: `Bearer ${auth.apiKey}` });
+  const extra = typeof auth.headers === "function" ? await auth.headers() : auth.headers;
+  new Headers(extra).forEach((value, key) => {
+    headers.set(key, value);
+  });
+  return headers;
+}
+async function clerkFetch(fetchImpl, url, auth, init) {
+  const headers = new Headers({ accept: "application/json" });
+  (await resolveAuthHeaders(auth)).forEach((value, key) => {
+    headers.set(key, value);
+  });
+  new Headers(init?.headers).forEach((value, key) => {
+    headers.set(key, value);
   });
+  const res = await fetchImpl(url, { ...init, headers });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
     throw new Error(`${init?.method ?? "GET"} ${url} -> ${res.status} ${res.statusText}${body ? `: ${body}` : ""}`);
@@ -3012,8 +3131,10 @@ async function clerkFetch(fetchImpl, url, apiKey, init) {
 }
 async function mintWsToken(opts) {
   const base = opts.httpBaseUrl.replace(/\/$/, "");
-  const data = await clerkFetch(opts.fetchImpl ?? fetch, `${base}/api/player/${encodeURIComponent(opts.playerId)}/ws-token`, opts.apiKey, { method: "POST" });
-  if (!data.token)
+  const data = requireRecord(await clerkFetch(opts.fetchImpl ?? fetch, `${base}/api/player/${encodeURIComponent(opts.playerId)}/ws-token`, opts, {
+    method: "POST"
+  }), "ws-token response");
+  if (typeof data.token !== "string" || !data.token)
     throw new Error("ws-token response had no token");
   return data.token;
 }
@@ -3024,18 +3145,34 @@ class ClerkSource {
   httpBaseUrl;
   constructor(opts) {
     this.opts = opts;
+    if (opts.apiKey === undefined && opts.headers === undefined) {
+      throw new Error("ClerkSource requires an `apiKey` or `headers`");
+    }
     this.fetchImpl = opts.fetchImpl ?? fetch;
     this.httpBaseUrl = opts.httpBaseUrl.replace(/\/$/, "");
   }
   get apiKey() {
     return this.opts.apiKey;
   }
+  async fetchRegistration() {
+    const data = requireRecord(await clerkFetch(this.fetchImpl, `${this.httpBaseUrl}/api/registration-code`, this.opts), "registration-code response");
+    const players = Array.isArray(data.players) ? data.players.filter((player) => isRecord(player) && typeof player.id === "string" && typeof player.username === "string" && typeof player.empire === "string" && typeof player.hidden === "boolean") : [];
+    return {
+      registrationCode: typeof data.registration_code === "string" ? data.registration_code : "",
+      players
+    };
+  }
   async listPlayers() {
-    const data = await clerkFetch(this.fetchImpl, `${this.httpBaseUrl}/api/registration-code`, this.opts.apiKey);
-    return data.players ?? [];
+    return (await this.fetchRegistration()).players;
   }
   mintWsToken(playerId) {
-    return mintWsToken({ httpBaseUrl: this.httpBaseUrl, apiKey: this.opts.apiKey, playerId, fetchImpl: this.fetchImpl });
+    return mintWsToken({
+      httpBaseUrl: this.httpBaseUrl,
+      apiKey: this.opts.apiKey,
+      headers: this.opts.headers,
+      playerId,
+      fetchImpl: this.fetchImpl
+    });
   }
 }
 
@@ -3112,7 +3249,7 @@ class EventStream {
     if (next)
       next({ value, done: false });
     else
-      this.buffer.push(value);
+      this.buffer.push({ value });
   }
   end() {
     if (this.ended)
@@ -3123,8 +3260,9 @@ class EventStream {
     this.waiting.length = 0;
   }
   next() {
-    if (this.buffer.length)
-      return Promise.resolve({ value: this.buffer.shift(), done: false });
+    const buffered = this.buffer.shift();
+    if (buffered)
+      return Promise.resolve({ value: buffered.value, done: false });
     if (this.ended)
       return Promise.resolve({ value: undefined, done: true });
     return new Promise((resolve) => this.waiting.push(resolve));
@@ -3150,8 +3288,9 @@ class TypedEmitter {
       set = new Set;
       this.handlers.set(type, set);
     }
-    set.add(handler);
-    return () => set.delete(handler);
+    const wrapped = (payload) => handler(payload);
+    set.add(wrapped);
+    return () => set.delete(wrapped);
   }
   onAny(handler) {
     this.anyHandlers.add(handler);
@@ -3315,8 +3454,12 @@ class ObservationCache {
 }
 
 // src/state/cache.ts
-function asRecord(value) {
-  return value;
+function copySection(target, source, section) {
+  const value = source[section];
+  if (value === undefined)
+    return false;
+  target[section] = value;
+  return true;
 }
 
 class StateCache {
@@ -3324,24 +3467,18 @@ class StateCache {
   seed(snapshot) {
     const next = {};
     const changed = [];
-    const src = asRecord(snapshot);
     for (const section of STATE_SECTIONS) {
-      if (src[section] !== undefined) {
-        asRecord(next)[section] = src[section];
+      if (copySection(next, snapshot, section))
         changed.push(section);
-      }
     }
     this.state = next;
     return changed;
   }
   applyDelta(delta) {
     const changed = [];
-    const src = asRecord(delta);
     for (const section of STATE_SECTIONS) {
-      if (src[section] !== undefined) {
-        asRecord(this.state)[section] = src[section];
+      if (copySection(this.state, delta, section))
         changed.push(section);
-      }
     }
     return changed;
   }
@@ -3349,7 +3486,7 @@ class StateCache {
     const current = this.state[section];
     if (current === undefined)
       return [];
-    asRecord(this.state)[section] = { ...asRecord(current), ...patch };
+    this.state[section] = { ...current, ...patch };
     return [section];
   }
   snapshot() {
@@ -3388,13 +3525,12 @@ class StateCache {
 function extractPendingAck(structured) {
   if (!structured)
     return;
-  if (structured["pending"] === true) {
-    return { command: String(structured["command"] ?? ""), message: String(structured["message"] ?? "") };
+  if (structured.pending === true) {
+    return { command: String(structured.command ?? ""), message: String(structured.message ?? "") };
   }
-  const details = structured["details"];
-  if (details && typeof details === "object" && details["pending"] === true) {
-    const d = details;
-    return { command: String(d["command"] ?? ""), message: String(d["message"] ?? "") };
+  const details = structured.details;
+  if (isRecord(details) && details.pending === true) {
+    return { command: String(details.command ?? ""), message: String(details.message ?? "") };
   }
   return;
 }
@@ -3426,6 +3562,8 @@ class Correlator {
       return false;
     switch (frame.type) {
       case "result": {
+        if (!isResultFrame(frame))
+          return this.rejectInvalidResponse(requestId, pending, frame.type);
         const payload = frame.payload;
         if (pending.kind === "query") {
           this.settle(requestId);
@@ -3437,7 +3575,7 @@ class Correlator {
         if (!ack) {
           this.settle(requestId);
           pending.resolve({
-            command: String(structured?.["command"] ?? ""),
+            command: String(structured?.command ?? ""),
             tick: 0,
             delta: { details: structured }
           });
@@ -3450,6 +3588,8 @@ class Correlator {
       case "action_result": {
         if (pending.kind !== "mutation")
           return true;
+        if (!isActionResultFrame(frame))
+          return this.rejectInvalidResponse(requestId, pending, frame.type);
         const payload = frame.payload;
         this.settle(requestId);
         pending.resolve({
@@ -3462,11 +3602,15 @@ class Correlator {
         return true;
       }
       case "action_error": {
+        if (!isActionErrorFrame(frame))
+          return this.rejectInvalidResponse(requestId, pending, frame.type);
         this.settle(requestId);
         pending.reject(errorFromActionFrame(frame));
         return true;
       }
       case "error": {
+        if (!isErrorFrame(frame))
+          return this.rejectInvalidResponse(requestId, pending, frame.type);
         this.settle(requestId);
         pending.reject(errorFromFrame(frame));
         return true;
@@ -3483,10 +3627,43 @@ class Correlator {
   settle(requestId) {
     this.pending.delete(requestId);
   }
+  rejectInvalidResponse(requestId, pending, frameType) {
+    this.settle(requestId);
+    pending.reject(new SpacemoltError("invalid_response", `Malformed ${frameType} frame for request ${requestId}`));
+    return true;
+  }
 }
 
 // src/transport/socket.ts
-var defaultFactory = (url) => new WebSocket(url);
+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);
 
 class Socket {
   opts;
@@ -3542,7 +3719,10 @@ class Socket {
         continue;
       let frame;
       try {
-        frame = JSON.parse(line);
+        const parsed = JSON.parse(line);
+        if (!isRecord(parsed) || typeof parsed.type !== "string" || parsed.request_id !== undefined && typeof parsed.request_id !== "string")
+          throw new TypeError("frame must be an object with a type");
+        frame = { ...parsed, type: parsed.type };
       } catch (err) {
         const head = line.slice(0, 200);
         const tail = line.length > 400 ? line.slice(-200) : "";
@@ -3590,11 +3770,18 @@ function normalizeReconnect(opt) {
   };
 }
 function retryAfterMs(err) {
-  const fromDetails = typeof err.details?.["retry_after"] === "number" ? err.details["retry_after"] : undefined;
+  const retryAfter = err.details?.retry_after;
+  const fromDetails = typeof retryAfter === "number" ? retryAfter : undefined;
   const match = err.message.match(/retry in (\d+)\s*second/i);
   const seconds = fromDetails ?? (match ? Number(match[1]) : undefined);
   return Math.max(250, (seconds ?? 1) * 1000);
 }
+function requireStructuredContent(result, command) {
+  if (result.structuredContent === undefined) {
+    throw new SpacemoltError("invalid_response", `${command} returned no structured content`);
+  }
+  return result.structuredContent;
+}
 
 class Account {
   socket;
@@ -3619,10 +3806,11 @@ class Account {
   _welcome = null;
   _authenticated = false;
   _loginPayload = null;
+  _currentTick = 0;
   _commands = null;
   welcomeWaiter = null;
   pendingAuth = null;
-  stateListener = null;
+  stateListeners = new Set;
   userClosing = false;
   reconnecting = false;
   mutationLane = Promise.resolve();
@@ -3631,9 +3819,9 @@ class Account {
   observationSubscribedState = false;
   observationActiveScanState = false;
   subscribedObservationPoiId;
-  reconnectedListener = null;
-  reconnectingListener = null;
-  disconnectedListener = null;
+  reconnectedListeners = new Set;
+  reconnectingListeners = new Set;
+  disconnectedListeners = new Set;
   constructor(opts = {}) {
     this.seedState = opts.seedState ?? true;
     this.url = opts.url ?? DEFAULT_URL;
@@ -3648,9 +3836,9 @@ class Account {
     this._id = opts.id;
     this.reconnectConfig = normalizeReconnect(opts.reconnect);
     this.makeSocket();
-    this.emitter.on("market_update", (p) => this.marketCache.applyUpdate(p));
-    this.emitter.on("observation_update", (p) => {
-      this.observationCache.applyUpdate(p);
+    this.emitter.on("market_update", (payload) => this.marketCache.applyUpdate(payload));
+    this.emitter.on("observation_update", (payload) => {
+      this.observationCache.applyUpdate(payload);
       this.bridgeObservationToLocation();
     });
   }
@@ -3698,6 +3886,13 @@ class Account {
   get welcome() {
     return this._welcome;
   }
+  get currentTick() {
+    return this._currentTick;
+  }
+  observeTick(tick) {
+    if (typeof tick === "number" && tick > this._currentTick)
+      this._currentTick = tick;
+  }
   get authenticated() {
     return this._authenticated;
   }
@@ -3788,19 +3983,32 @@ class Account {
     }
   }
   async refresh() {
-    const res = await this.query("spacemolt", "get_status");
-    const snapshot = res.structuredContent;
-    if (snapshot) {
-      const changed = this.cache.seed(snapshot);
-      if (changed.includes("location"))
-        this.checkSubscriptionsAgainstLocation();
-      if (changed.length)
-        this.stateListener?.(changed);
-    }
+    const result = await this.commands.spacemolt.get_status();
+    const snapshot = requireStructuredContent(result, "spacemolt/get_status");
+    const changed = this.cache.seed(snapshot);
+    if (changed.includes("location"))
+      this.checkSubscriptionsAgainstLocation();
+    if (changed.length)
+      this.emitStateChange(changed);
     return this.cache.snapshot();
   }
   onStateChange(listener) {
-    this.stateListener = listener;
+    this.stateListeners.add(listener);
+    return () => {
+      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);
   }
   async logout() {
     await this.query("spacemolt_auth", "logout");
@@ -3850,7 +4058,7 @@ class Account {
       }, (err) => {
         if (timer)
           clearTimeout(timer);
-        reject(err);
+        reject(err instanceof Error ? err : new Error(String(err)));
       });
     });
   }
@@ -3871,13 +4079,12 @@ class Account {
     return this.emitter.anyStream();
   }
   async subscribeMarket() {
-    const res = await this.query("spacemolt_market", "subscribe_market");
-    const snapshot = res.structuredContent;
-    if (snapshot)
-      this.marketCache.seed(snapshot);
+    const result = await this.commands.spacemolt_market.subscribe_market();
+    const snapshot = requireStructuredContent(result, "spacemolt_market/subscribe_market");
+    this.marketCache.seed(snapshot);
     this.marketSubscribedState = true;
-    this.subscribedMarketBaseId = snapshot?.base_id;
-    return snapshot ?? {};
+    this.subscribedMarketBaseId = snapshot.base_id;
+    return snapshot;
   }
   async unsubscribeMarket() {
     const baseId = this.subscribedMarketBaseId ?? this.location?.docked_at ?? this.marketCache.bases()[0];
@@ -3891,16 +4098,14 @@ class Account {
     return this.marketCache.book(baseId);
   }
   async subscribeObservation(activeScan = false) {
-    const res = await this.query("spacemolt", "subscribe_observation", activeScan ? { active_scan: true } : undefined);
-    const snapshot = res.structuredContent;
-    if (snapshot) {
-      this.observationCache.seed(snapshot);
-      this.bridgeObservationToLocation();
-    }
+    const result = await this.commands.spacemolt.subscribe_observation(activeScan ? { active_scan: true } : undefined);
+    const snapshot = requireStructuredContent(result, "spacemolt/subscribe_observation");
+    this.observationCache.seed(snapshot);
+    this.bridgeObservationToLocation();
     this.observationSubscribedState = true;
     this.observationActiveScanState = activeScan;
-    this.subscribedObservationPoiId = snapshot?.poi_id;
-    return snapshot ?? {};
+    this.subscribedObservationPoiId = snapshot.poi_id;
+    return snapshot;
   }
   async unsubscribeObservation() {
     this.observationSubscribedState = false;
@@ -3918,7 +4123,7 @@ class Account {
       nearby_player_count: view.nearby.size
     });
     if (changed.length)
-      this.stateListener?.(changed);
+      this.emitStateChange(changed);
   }
   observation() {
     return this.observationCache.current();
@@ -3940,13 +4145,22 @@ class Account {
     this.socket.close();
   }
   onReconnected(listener) {
-    this.reconnectedListener = listener;
+    this.reconnectedListeners.add(listener);
+    return () => {
+      this.reconnectedListeners.delete(listener);
+    };
   }
   onReconnecting(listener) {
-    this.reconnectingListener = listener;
+    this.reconnectingListeners.add(listener);
+    return () => {
+      this.reconnectingListeners.delete(listener);
+    };
   }
   onDisconnected(listener) {
-    this.disconnectedListener = listener;
+    this.disconnectedListeners.add(listener);
+    return () => {
+      this.disconnectedListeners.delete(listener);
+    };
   }
   async authExchange(action, payload) {
     const authPromise = new Promise((resolve, reject) => {
@@ -3989,19 +4203,28 @@ class Account {
     return `r${++this.requestSeq}`;
   }
   routeFrame(frame) {
+    if (isRecord(frame.payload))
+      this.observeTick(frame.payload.tick);
     switch (frame.type) {
       case "welcome": {
+        if (!isWelcomeFrame(frame))
+          return this.warnMalformedFrame(frame);
         const payload = frame.payload;
         this._welcome = payload;
+        this.observeTick(payload.current_tick);
         this.welcomeWaiter?.resolve(payload);
         this.welcomeWaiter = null;
         return;
       }
       case "registered":
+        if (!isRegisteredFrame(frame))
+          return this.warnMalformedFrame(frame);
         if (this.pendingAuth)
           this.pendingAuth.registered = frame.payload;
         return;
       case "logged_in": {
+        if (!isLoggedInFrame(frame))
+          return this.warnMalformedFrame(frame);
         const payload = frame.payload;
         const auth = this.pendingAuth;
         if (auth) {
@@ -4014,18 +4237,18 @@ class Account {
         return;
       }
       case "action_result": {
+        if (!isActionResultFrame(frame)) {
+          if (!this.correlator.handle(frame))
+            this.warnMalformedFrame(frame);
+          return;
+        }
         const delta = frame.payload.result;
         if (delta) {
           const changed = this.cache.applyDelta(delta);
           if (changed.includes("location"))
             this.checkSubscriptionsAgainstLocation();
-          if (changed.length) {
-            try {
-              this.stateListener?.(changed);
-            } catch (err) {
-              console.warn(`[spacemolt] onStateChange listener threw: ${err}`);
-            }
-          }
+          if (changed.length)
+            this.emitStateChange(changed);
         }
         if (!this.correlator.handle(frame)) {
           console.warn(`[spacemolt] action_result for ${frame.request_id ?? "?"} arrived with no matching pending mutation (already timed out?)`);
@@ -4039,6 +4262,11 @@ class Account {
           this.emitter.emit(frame);
         return;
       case "error": {
+        if (!isErrorFrame(frame)) {
+          if (!this.correlator.handle(frame))
+            this.warnMalformedFrame(frame);
+          return;
+        }
         if (this.correlator.handle(frame))
           return;
         const auth = this.pendingAuth;
@@ -4054,6 +4282,9 @@ class Account {
         this.emitter.emit(frame);
     }
   }
+  warnMalformedFrame(frame) {
+    console.warn(`[spacemolt] dropped malformed ${frame.type} frame`);
+  }
   handleClose(err) {
     this._authenticated = false;
     this.correlator.rejectAll(err);
@@ -4071,7 +4302,7 @@ class Account {
     if (this.shouldReconnect(err)) {
       this.reconnectLoop(err);
     } else if (!this.userClosing) {
-      this.disconnectedListener?.(err);
+      this.notifyListeners(this.disconnectedListeners, "onDisconnected", err);
     }
   }
   shouldReconnect(err) {
@@ -4090,7 +4321,7 @@ class Account {
     const cfg = this.reconnectConfig;
     const retryAfterMs2 = retryAfterMsFromClose(err);
     for (let attempt = 1;attempt <= cfg.maxRetries; attempt++) {
-      this.reconnectingListener?.(attempt);
+      this.notifyListeners(this.reconnectingListeners, "onReconnecting", attempt);
       const backoff = attempt === 1 && retryAfterMs2 !== undefined ? retryAfterMs2 : Math.min(cfg.baseDelayMs * 2 ** (attempt - 1), cfg.maxDelayMs);
       await delay(backoff);
       if (this.userClosing) {
@@ -4100,12 +4331,12 @@ class Account {
       try {
         await this.reconnectOnce();
         this.reconnecting = false;
-        this.reconnectedListener?.();
+        this.notifyListeners(this.reconnectedListeners, "onReconnected");
         return;
       } catch {}
     }
     this.reconnecting = false;
-    this.disconnectedListener?.(err);
+    this.notifyListeners(this.disconnectedListeners, "onDisconnected", err);
   }
   async reconnectOnce() {
     if (!this.credentialsProvider)
@@ -4171,27 +4402,51 @@ class MemoryCredentialStore {
 }
 
 // src/data/catalog.ts
-async function fetchCatalog(httpBaseUrl) {
+function catalogEntries(value) {
+  return Array.isArray(value) ? value.filter((entry) => isRecord(entry)) : [];
+}
+function normalizeCatalog(value) {
+  const data = requireRecord(value, "catalog response");
+  return {
+    version: typeof data.version === "string" ? data.version : undefined,
+    ships: catalogEntries(data.ships),
+    items: catalogEntries(data.items),
+    recipes: catalogEntries(data.recipes),
+    skills: catalogEntries(data.skills),
+    facilities: catalogEntries(data.facilities)
+  };
+}
+async function fetchCatalogConditional(httpBaseUrl, etag) {
   const url = `${httpBaseUrl.replace(/\/$/, "")}/api/catalog.json`;
-  const res = await fetch(url, { headers: { accept: "application/json" } });
+  const headers = { accept: "application/json" };
+  if (etag)
+    headers["if-none-match"] = etag;
+  const res = await fetch(url, { headers });
+  if (res.status === 304)
+    return { notModified: true, etag };
   if (!res.ok)
     throw new Error(`GET ${url} -> ${res.status} ${res.statusText}`);
   const data = await res.json();
   return {
-    version: data.version,
-    ships: data.ships ?? [],
-    items: data.items ?? [],
-    recipes: data.recipes ?? [],
-    skills: data.skills ?? [],
-    facilities: data.facilities ?? []
+    notModified: false,
+    catalog: normalizeCatalog(data),
+    etag: res.headers?.get?.("etag") ?? undefined
   };
 }
+async function fetchCatalog(httpBaseUrl) {
+  const { catalog } = await fetchCatalogConditional(httpBaseUrl);
+  if (!catalog)
+    throw new Error("unconditional catalog fetch returned no catalog");
+  return catalog;
+}
 
 class CatalogCache {
   catalog;
+  etag;
   indexes;
-  constructor(catalog) {
+  constructor(catalog, etag) {
     this.catalog = catalog;
+    this.etag = etag;
     this.indexes = {
       ships: index(catalog.ships),
       items: index(catalog.items),
@@ -4201,7 +4456,18 @@ class CatalogCache {
     };
   }
   static async load(httpBaseUrl) {
-    return new CatalogCache(await fetchCatalog(httpBaseUrl));
+    const { catalog, etag } = await fetchCatalogConditional(httpBaseUrl);
+    if (!catalog)
+      throw new Error("unconditional catalog fetch returned no catalog");
+    return new CatalogCache(catalog, etag);
+  }
+  async revalidate(httpBaseUrl) {
+    const result = await fetchCatalogConditional(httpBaseUrl, this.etag);
+    if (result.notModified)
+      return this;
+    if (!result.catalog)
+      throw new Error("modified catalog response returned no catalog");
+    return new CatalogCache(result.catalog, result.etag);
   }
   get version() {
     return this.catalog.version;
@@ -4253,8 +4519,10 @@ async function fetchMap(httpBaseUrl) {
   const res = await fetch(url, { headers: { accept: "application/json" } });
   if (!res.ok)
     throw new Error(`GET ${url} -> ${res.status} ${res.statusText}`);
-  const data = await res.json();
-  return { systems: data.systems ?? [], empires: data.empires ?? {} };
+  const data = requireRecord(await res.json(), "map response");
+  const systems = Array.isArray(data.systems) ? data.systems.filter((system) => isRecord(system)) : [];
+  const empires = isRecord(data.empires) ? Object.fromEntries(Object.entries(data.empires).filter((entry) => typeof entry[1] === "string")) : {};
+  return { systems, empires };
 }
 
 class MapCache {
@@ -4303,6 +4571,7 @@ class SpacemoltClient {
   store;
   connected = new Map;
   catalogCache;
+  catalogFetchedAt = 0;
   mapCache;
   clerkSource;
   accountConnectedListeners = new Set;
@@ -4343,8 +4612,13 @@ class SpacemoltClient {
     return this.opts.httpBaseUrl ?? (this.opts.url ? httpBaseFromWs(this.opts.url) : DEFAULT_HTTP_BASE);
   }
   async catalog(force = false) {
-    if (force || !this.catalogCache)
-      this.catalogCache = await CatalogCache.load(this.httpBaseUrl);
+    const maxAgeMs = this.opts.catalogMaxAgeMs ?? 3600000;
+    const cached = this.catalogCache;
+    const fresh = cached && !force && Date.now() - this.catalogFetchedAt < maxAgeMs;
+    if (fresh)
+      return cached;
+    this.catalogCache = !this.catalogCache || force ? await CatalogCache.load(this.httpBaseUrl) : await this.catalogCache.revalidate(this.httpBaseUrl);
+    this.catalogFetchedAt = Date.now();
     return this.catalogCache;
   }
   async map(force = false) {
@@ -4366,16 +4640,22 @@ class SpacemoltClient {
   async register(params) {
     const account = this.createAccount(params.username);
     this.connected.set(params.username, account);
-    await account.connect();
-    const result = await account.register(params);
-    await this.store.put({
-      id: params.username,
-      credentials: { kind: "login", username: params.username, password: result.password },
-      playerId: result.player_id
-    });
-    account.onDisconnected((err) => this.handleAccountDisconnected(params.username, account, err));
-    this.notifyAccountConnected(account);
-    return { account, result };
+    try {
+      await account.connect();
+      const result = await account.register(params);
+      await this.store.put({
+        id: params.username,
+        credentials: { kind: "login", username: params.username, password: result.password },
+        playerId: result.player_id
+      });
+      account.onDisconnected((err) => this.handleAccountDisconnected(params.username, account, err));
+      this.notifyAccountConnected(account);
+      return { account, result };
+    } catch (error) {
+      account.close();
+      this.connected.delete(params.username);
+      throw error;
+    }
   }
   connectRetryConfig() {
     const retryOpt = this.opts.connectRetry ?? true;
@@ -4428,10 +4708,10 @@ class SpacemoltClient {
     return this.connectIds(stored.map((s) => s.id), opts.onConnect);
   }
   async listOwnedPlayers() {
-    return this.requireClerkSource().listPlayers();
+    return this.requireClerkAuth().source.listPlayers();
   }
   async connectOwned(opts = {}) {
-    const source = this.requireClerkSource();
+    const { source, apiKey } = this.requireClerkAuth();
     const players = await source.listPlayers();
     const selected = opts.filter ? players.filter(opts.filter) : players;
     const ids = [];
@@ -4440,7 +4720,7 @@ class SpacemoltClient {
         id: player.username,
         credentials: {
           kind: "clerk",
-          apiKey: source.apiKey,
+          apiKey,
           playerId: player.id,
           httpBaseUrl: source.httpBaseUrl
         },
@@ -4450,18 +4730,17 @@ class SpacemoltClient {
     }
     return this.connectIds(ids, opts.onConnect);
   }
-  requireClerkSource() {
-    if (!this.clerkSource) {
-      if (!this.opts.clerkApiKey) {
-        throw new Error("connectOwned/listOwnedPlayers require `clerkApiKey` in SpacemoltClientOptions");
-      }
-      this.clerkSource = new ClerkSource({
-        apiKey: this.opts.clerkApiKey,
-        httpBaseUrl: this.httpBaseUrl,
-        fetchImpl: this.opts.fetchImpl
-      });
+  requireClerkAuth() {
+    const apiKey = this.opts.clerkApiKey;
+    if (!apiKey) {
+      throw new Error("connectOwned/listOwnedPlayers require `clerkApiKey` in SpacemoltClientOptions");
     }
-    return this.clerkSource;
+    this.clerkSource ??= new ClerkSource({
+      apiKey,
+      httpBaseUrl: this.httpBaseUrl,
+      fetchImpl: this.opts.fetchImpl
+    });
+    return { source: this.clerkSource, apiKey };
   }
   async connectIds(ids, onConnect) {
     const accounts = [];
@@ -4505,6 +4784,8 @@ class SpacemoltClient {
       }
       isFirst = false;
       const task = this.rateLimitedQueue.shift();
+      if (!task)
+        break;
       ranInCurrentBatch++;
       await task();
     }
@@ -4604,6 +4885,7 @@ var TYPED_NOTIFICATION_TYPES = [
   "reconnected",
   "scan_detected",
   "skill_level_up",
+  "station_repaired",
   "trade_cancelled",
   "trade_complete",
   "trade_declined",
@@ -4612,8 +4894,16 @@ var TYPED_NOTIFICATION_TYPES = [
 export {
   retryAfterMsFromClose,
   mintWsToken,
+  isWelcomeFrame,
+  isResultFrame,
+  isRegisteredFrame,
+  isLoggedInFrame,
+  isErrorFrame,
+  isActionResultFrame,
+  isActionErrorFrame,
   httpBaseFromWs,
   fetchMap,
+  fetchCatalogConditional,
   fetchCatalog,
   buildCommands,
   TypedEmitter,