@spacemolt/lib 4.6.0

package/dist/index.js

@@ -0,0 +1,4638 @@
+// src/protocol.ts
+var STATE_SECTIONS = [
+  "player",
+  "ship",
+  "modules",
+  "cargo",
+  "location",
+  "missions",
+  "queue",
+  "skills"
+];
+// src/generated/actions.gen.ts
+var GENERATED_SPEC_VERSION = "v0.485.0";
+var ACTIONS = {
+  "spacemolt_auth/claim": {
+    tool: "spacemolt_auth",
+    action: "claim",
+    kind: "query",
+    summary: "Link your player to your website account using a registration code",
+    responseType: "MessageResponse",
+    params: [
+      { name: "registration_code", type: "string", required: true, description: "Your registration code from https://spacemolt.com/dashboard", positional: 3 }
+    ]
+  },
+  "spacemolt_auth/login": {
+    tool: "spacemolt_auth",
+    action: "login",
+    kind: "query",
+    summary: "Log in to an existing account",
+    responseType: "LoginResponse",
+    params: [
+      { name: "password", type: "string", required: true, description: "Your random authentication password from registration", positional: 2 },
+      { name: "username", type: "string", required: true, description: "Your username", positional: 0 }
+    ]
+  },
+  "spacemolt_auth/login_token": {
+    tool: "spacemolt_auth",
+    action: "login_token",
+    kind: "query",
+    summary: "Log in using a short-lived token from the web play client",
+    responseType: "LoginResponse",
+    params: [
+      { name: "token", type: "string", required: true, description: "Short-lived login token from /api/player/{id}/ws-token (Clerk-authenticated). Single-use, expires in 5 minutes.", positional: 4 }
+    ]
+  },
+  "spacemolt_auth/logout": {
+    tool: "spacemolt_auth",
+    action: "logout",
+    kind: "query",
+    summary: "Safely disconnect from the game",
+    responseType: "MessageResponse",
+    params: []
+  },
+  "spacemolt_auth/register": {
+    tool: "spacemolt_auth",
+    action: "register",
+    kind: "query",
+    summary: "Create a new player account and join the galaxy",
+    responseType: "RegisterResponse",
+    params: [
+      { name: "empire", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Your starting empire (solarian, voidborn, crimson, nebula, outerrim)", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 1 },
+      { name: "registration_code", type: "string", required: true, description: "Your registration code from https://spacemolt.com/dashboard", positional: 3 },
+      { name: "username", type: "string", required: true, description: "Your unique username (3-24 chars: letters, digits, spaces, underscores, hyphens, apostrophes, periods, exclamation marks, emoji)", positional: 0 }
+    ]
+  },
+  "spacemolt_battle/advance": {
+    tool: "spacemolt_battle",
+    action: "advance",
+    kind: "query",
+    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    responseType: "BattleResponse",
+    params: []
+  },
+  "spacemolt_battle/engage": {
+    tool: "spacemolt_battle",
+    action: "engage",
+    kind: "query",
+    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    responseType: "BattleResponse",
+    params: [
+      { name: "side_id", type: "number", required: false, description: "Side to join (optional for action=engage — auto-assigned by faction if omitted)" }
+    ]
+  },
+  "spacemolt_battle/reload": {
+    tool: "spacemolt_battle",
+    action: "reload",
+    kind: "mutation",
+    summary: "Reload a weapon's magazine from ammo in cargo",
+    detailsType: "ReloadResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Instance ID of the fitted weapon to reload (use get_ship to see weapon instance IDs)", positional: 0 },
+      { name: "target", type: "string", required: false, description: "Item ID of ammo to load from cargo (must match the weapon's ammo type). For weapons with the ammo_from_cargo special: omit to auto-select random low-value junk, or specify any cargo item to load that exact item.", positional: 1 }
+    ]
+  },
+  "spacemolt_battle/retreat": {
+    tool: "spacemolt_battle",
+    action: "retreat",
+    kind: "query",
+    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    responseType: "BattleResponse",
+    params: []
+  },
+  "spacemolt_battle/stance": {
+    tool: "spacemolt_battle",
+    action: "stance",
+    kind: "query",
+    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    responseType: "BattleResponse",
+    params: [
+      { name: "id", type: '"fire" | "evade" | "brace" | "flee"', required: true, description: "Battle stance (required for action=stance): fire (100% dmg dealt/taken), evade (0% dealt, 50% taken, costs fuel), brace (0% dealt, 25% taken, shields regen 2x), flee (0% dealt, 100% taken, auto-retreats, 3 ticks from outer to escape)", enumValues: ["fire", "evade", "brace", "flee"], positional: 0 }
+    ]
+  },
+  "spacemolt_battle/status": {
+    tool: "spacemolt_battle",
+    action: "status",
+    kind: "query",
+    summary: "View current battle status",
+    responseType: "GetBattleStatusResponse",
+    params: []
+  },
+  "spacemolt_battle/target": {
+    tool: "spacemolt_battle",
+    action: "target",
+    kind: "query",
+    summary: "Manage your battle — move, change stance, target enemies, or join a fight",
+    responseType: "BattleResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player ID or username of enemy to target (required for action=target)", positional: 0 }
+    ]
+  },
+  "spacemolt_citizenship/apply": {
+    tool: "spacemolt_citizenship",
+    action: "apply",
+    kind: "mutation",
+    summary: "View and manage your empire citizenships (list, apply, renounce, withdraw)",
+    detailsType: "CitizenshipResponse",
+    params: [
+      { name: "target", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Empire to act on. Required for apply, renounce, withdraw; ignored for list.", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 0 }
+    ]
+  },
+  "spacemolt_citizenship/list": {
+    tool: "spacemolt_citizenship",
+    action: "list",
+    kind: "query",
+    summary: "View and manage your empire citizenships (list, apply, renounce, withdraw)",
+    responseType: "CitizenshipResponse",
+    params: []
+  },
+  "spacemolt_citizenship/renounce": {
+    tool: "spacemolt_citizenship",
+    action: "renounce",
+    kind: "mutation",
+    summary: "View and manage your empire citizenships (list, apply, renounce, withdraw)",
+    detailsType: "CitizenshipResponse",
+    params: [
+      { name: "target", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Empire to act on. Required for apply, renounce, withdraw; ignored for list.", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 0 }
+    ]
+  },
+  "spacemolt_citizenship/withdraw": {
+    tool: "spacemolt_citizenship",
+    action: "withdraw",
+    kind: "mutation",
+    summary: "View and manage your empire citizenships (list, apply, renounce, withdraw)",
+    detailsType: "CitizenshipResponse",
+    params: [
+      { name: "target", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Empire to act on. Required for apply, renounce, withdraw; ignored for list.", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 0 }
+    ]
+  },
+  "spacemolt_drone/deploy": {
+    tool: "spacemolt_drone",
+    action: "deploy",
+    kind: "mutation",
+    summary: "Deploy a drone from your bay into space",
+    detailsType: "DeployDroneResponse",
+    params: [
+      { name: "all", type: "boolean", required: false, description: "Set to true to deploy every in-bay drone in a single tick. Drones that would exceed remaining bandwidth are skipped." },
+      { name: "id", type: "string", required: false, description: "ID of a specific drone to deploy from your bay (see get_drones)", positional: 0 }
+    ]
+  },
+  "spacemolt_drone/get": {
+    tool: "spacemolt_drone",
+    action: "get",
+    kind: "query",
+    summary: "Get full details for a specific drone including script and memory",
+    responseType: "GetDroneResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the drone to inspect", positional: 0 }
+    ]
+  },
+  "spacemolt_drone/list": {
+    tool: "spacemolt_drone",
+    action: "list",
+    kind: "query",
+    summary: "List all your drones (bay and deployed)",
+    responseType: "GetDronesResponse",
+    params: []
+  },
+  "spacemolt_drone/load": {
+    tool: "spacemolt_drone",
+    action: "load",
+    kind: "mutation",
+    summary: "Load a drone from cargo into your drone bay",
+    detailsType: "LoadDroneResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Drone item ID from cargo (combat_drone, mining_drone, repair_drone, salvage_drone, scout_drone)", positional: 0 }
+    ]
+  },
+  "spacemolt_drone/name": {
+    tool: "spacemolt_drone",
+    action: "name",
+    kind: "query",
+    summary: "Set or clear an optional display name on a drone you own",
+    responseType: "SetDroneNameResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the drone to rename (you must own it)", positional: 0 },
+      { name: "text", type: "string", required: true, description: "Display name (max 32 chars; same rules as ship names). Pass empty string to clear.", positional: 1 }
+    ]
+  },
+  "spacemolt_drone/recall": {
+    tool: "spacemolt_drone",
+    action: "recall",
+    kind: "mutation",
+    summary: "Recall a deployed drone back to your bay",
+    detailsType: "RecallDroneResponse",
+    params: [
+      { name: "all", type: "boolean", required: false, description: "Set to true to recall all drones at your current location" },
+      { name: "id", type: "string", required: false, description: "ID of a specific drone to recall", positional: 0 }
+    ]
+  },
+  "spacemolt_drone/unload": {
+    tool: "spacemolt_drone",
+    action: "unload",
+    kind: "mutation",
+    summary: "Return a drone from your bay back to cargo",
+    detailsType: "UnloadDroneResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the drone to return to cargo (must be in bay, not deployed)", positional: 0 }
+    ]
+  },
+  "spacemolt_drone/upload": {
+    tool: "spacemolt_drone",
+    action: "upload",
+    kind: "mutation",
+    summary: "Upload a DroneLang script to an autonomous drone",
+    detailsType: "UploadDroneScriptResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the drone to program", positional: 0 },
+      { name: "text", type: "string", required: true, description: "DroneLang script source (max 2000 chars). Pass empty string to clear.", positional: 1 }
+    ]
+  },
+  "spacemolt_facility/allow_faction": {
+    tool: "spacemolt_facility",
+    action: "allow_faction",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "faction", type: "string", required: true, description: "Target faction id (allow_faction/remove_faction)" }
+    ]
+  },
+  "spacemolt_facility/allow_player": {
+    tool: "spacemolt_facility",
+    action: "allow_player",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "player", type: "string", required: true, description: "Target player id or username (allow_player/remove_player/ban/unban)" }
+    ]
+  },
+  "spacemolt_facility/ban": {
+    tool: "spacemolt_facility",
+    action: "ban",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "player", type: "string", required: true, description: "Target player id or username (allow_player/remove_player/ban/unban)" }
+    ]
+  },
+  "spacemolt_facility/base_cost": {
+    tool: "spacemolt_facility",
+    action: "base_cost",
+    kind: "query",
+    summary: "Preview the cost and requirements to found a faction station",
+    responseType: "BaseCostResponse",
+    params: []
+  },
+  "spacemolt_facility/browse_for_sale": {
+    tool: "spacemolt_facility",
+    action: "browse_for_sale",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: [
+      { name: "facility_type", type: "string", required: false, 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 },
+      { name: "max_price", type: "number", required: false, description: "For 'browse_for_sale': optional maximum price filter." }
+    ]
+  },
+  "spacemolt_facility/build": {
+    tool: "spacemolt_facility",
+    action: "build",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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_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/buy_listing": {
+    tool: "spacemolt_facility",
+    action: "buy_listing",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    params: [
+      { name: "listing_id", type: "string", required: true, description: "For 'buy_listing' and 'cancel_listing': the facility listing ID. Use action 'browse_for_sale' to see listings." }
+    ]
+  },
+  "spacemolt_facility/buy_ship_license": {
+    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",
+    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"] }
+    ]
+  },
+  "spacemolt_facility/cancel_listing": {
+    tool: "spacemolt_facility",
+    action: "cancel_listing",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    params: [
+      { name: "listing_id", type: "string", required: true, description: "For 'buy_listing' and 'cancel_listing': the facility listing ID. Use action 'browse_for_sale' to see listings." }
+    ]
+  },
+  "spacemolt_facility/deploy_outpost": {
+    tool: "spacemolt_facility",
+    action: "deploy_outpost",
+    kind: "mutation",
+    summary: "Deploy a lightweight, members-only faction outpost at your current point of interest in lawless space",
+    detailsType: "BuildBaseResponse",
+    params: [
+      { name: "name", type: "string", required: true, description: "Name for the new faction outpost" }
+    ]
+  },
+  "spacemolt_facility/dismantle": {
+    tool: "spacemolt_facility",
+    action: "dismantle",
+    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', '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": {
+    tool: "spacemolt_facility",
+    action: "facility_set_description",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
+  "spacemolt_facility/faction_build": {
+    tool: "spacemolt_facility",
+    action: "faction_build",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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_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_dismantle": {
+    tool: "spacemolt_facility",
+    action: "faction_dismantle",
+    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', '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": {
+    tool: "spacemolt_facility",
+    action: "faction_list",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: []
+  },
+  "spacemolt_facility/faction_owned": {
+    tool: "spacemolt_facility",
+    action: "faction_owned",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: []
+  },
+  "spacemolt_facility/faction_upgrade": {
+    tool: "spacemolt_facility",
+    action: "faction_upgrade",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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_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/found_station": {
+    tool: "spacemolt_facility",
+    action: "found_station",
+    kind: "mutation",
+    summary: "Found a faction-owned station at your current point of interest in lawless space",
+    detailsType: "BuildBaseResponse",
+    params: [
+      { name: "name", type: "string", required: true, description: "Name for the new faction station" },
+      { name: "public_access", type: "boolean", required: false, description: "Whether any pilot may dock (default false — faction/allowed only)" }
+    ]
+  },
+  "spacemolt_facility/job_add": {
+    tool: "spacemolt_facility",
+    action: "job_add",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    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: "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." }
+    ]
+  },
+  "spacemolt_facility/job_cancel": {
+    tool: "spacemolt_facility",
+    action: "job_cancel",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    params: [
+      { name: "job_id", type: "string", required: false, description: "Job ID (for 'job_cancel', 'job_reorder'). Use action 'job_list' to see job IDs." },
+      { name: "job_ids", type: "string[]", required: false, description: "For 'job_cancel': cancel multiple jobs in a single action. When provided, 'job_id' is ignored. Use action 'job_list' to see job IDs." }
+    ]
+  },
+  "spacemolt_facility/job_list": {
+    tool: "spacemolt_facility",
+    action: "job_list",
+    kind: "query",
+    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 }
+    ]
+  },
+  "spacemolt_facility/job_reorder": {
+    tool: "spacemolt_facility",
+    action: "job_reorder",
+    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', '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)." }
+    ]
+  },
+  "spacemolt_facility/list": {
+    tool: "spacemolt_facility",
+    action: "list",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: []
+  },
+  "spacemolt_facility/list_for_sale": {
+    tool: "spacemolt_facility",
+    action: "list_for_sale",
+    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', '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." }
+    ]
+  },
+  "spacemolt_facility/owned": {
+    tool: "spacemolt_facility",
+    action: "owned",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: []
+  },
+  "spacemolt_facility/personal_build": {
+    tool: "spacemolt_facility",
+    action: "personal_build",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    params: [
+      { 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/personal_decorate": {
+    tool: "spacemolt_facility",
+    action: "personal_decorate",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    detailsType: "FacilityResponse",
+    params: [
+      { name: "access", type: '"private" | "public"', required: false, 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: "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." }
+    ]
+  },
+  "spacemolt_facility/personal_visit": {
+    tool: "spacemolt_facility",
+    action: "personal_visit",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: [
+      { name: "username", type: "string", required: false, description: "For 'personal_visit': username of the player whose quarters to visit. Omit to visit your own." }
+    ]
+  },
+  "spacemolt_facility/remove_faction": {
+    tool: "spacemolt_facility",
+    action: "remove_faction",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "faction", type: "string", required: true, description: "Target faction id (allow_faction/remove_faction)" }
+    ]
+  },
+  "spacemolt_facility/remove_player": {
+    tool: "spacemolt_facility",
+    action: "remove_player",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "player", type: "string", required: true, description: "Target player id or username (allow_player/remove_player/ban/unban)" }
+    ]
+  },
+  "spacemolt_facility/set_access": {
+    tool: "spacemolt_facility",
+    action: "set_access",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
+  "spacemolt_facility/set_build_policy": {
+    tool: "spacemolt_facility",
+    action: "set_build_policy",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "allow_outsiders", type: "boolean", required: false, description: "Whether non-members may build facilities here (set_build_policy)" }
+    ]
+  },
+  "spacemolt_facility/set_description": {
+    tool: "spacemolt_facility",
+    action: "set_description",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "description", type: "string", required: false, description: "New station description (set_description)" }
+    ]
+  },
+  "spacemolt_facility/set_market_fee": {
+    tool: "spacemolt_facility",
+    action: "set_market_fee",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "fee_percent", type: "number", required: false, description: "Market listing fee percent 0-10 (set_market_fee)" }
+    ]
+  },
+  "spacemolt_facility/set_name": {
+    tool: "spacemolt_facility",
+    action: "set_name",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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 }
+    ]
+  },
+  "spacemolt_facility/set_output_price": {
+    tool: "spacemolt_facility",
+    action: "set_output_price",
+    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', '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." }
+    ]
+  },
+  "spacemolt_facility/set_public": {
+    tool: "spacemolt_facility",
+    action: "set_public",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "public", type: "boolean", required: false, description: "Whether anyone may dock (set_public)" }
+    ]
+  },
+  "spacemolt_facility/set_refuel_price": {
+    tool: "spacemolt_facility",
+    action: "set_refuel_price",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "price", type: "number", required: false, description: "Price for set_refuel_price (per unit) or set_repair_price (per hull point)" }
+    ]
+  },
+  "spacemolt_facility/set_repair_price": {
+    tool: "spacemolt_facility",
+    action: "set_repair_price",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "price", type: "number", required: false, description: "Price for set_refuel_price (per unit) or set_repair_price (per hull point)" }
+    ]
+  },
+  "spacemolt_facility/set_service_access": {
+    tool: "spacemolt_facility",
+    action: "set_service_access",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "access", type: '"public" | "allies" | "faction"', required: true, description: "Access level for set_service_access", enumValues: ["public", "allies", "faction"] },
+      { name: "service", type: "string", required: true, description: "Service type for set_service_access (market, refuel, repair, shipyard, crafting, salvage_yard)" }
+    ]
+  },
+  "spacemolt_facility/station_info": {
+    tool: "spacemolt_facility",
+    action: "station_info",
+    kind: "query",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    responseType: "StationConfigResponse",
+    params: []
+  },
+  "spacemolt_facility/station_set_name": {
+    tool: "spacemolt_facility",
+    action: "station_set_name",
+    kind: "query",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    responseType: "StationConfigResponse",
+    params: [
+      { name: "name", type: "string", required: true, description: "New station name (set_name)" }
+    ]
+  },
+  "spacemolt_facility/transfer": {
+    tool: "spacemolt_facility",
+    action: "transfer",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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: "player_id", type: "string", required: false, description: "Target player ID for 'transfer' action with direction 'to_player'." }
+    ]
+  },
+  "spacemolt_facility/types": {
+    tool: "spacemolt_facility",
+    action: "types",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: [
+      { name: "category", type: '"infrastructure" | "service" | "production" | "faction" | "personal"', required: false, description: "Filter for 'types' action: show only this category.", enumValues: ["infrastructure", "service", "production", "faction", "personal"] },
+      { name: "facility_type", type: "string", required: false, 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 },
+      { name: "level", type: "number", required: false, description: "Filter for 'types' action: show only this tier level (1, 2, 3, etc.)." },
+      { name: "name", type: "string", required: false, description: "Filter for 'types' action: case-insensitive name search (e.g. 'refinery')." },
+      { name: "page", type: "number", required: false, description: "Page number for 'types' action results (default: 1)." },
+      { name: "per_page", type: "number", required: false, description: "Results per page for 'types' action (default: 20, max: 50)." }
+    ]
+  },
+  "spacemolt_facility/unban": {
+    tool: "spacemolt_facility",
+    action: "unban",
+    kind: "mutation",
+    summary: "Administer one of your faction's stations or outposts: rename, access control, and build policy",
+    detailsType: "StationConfigResponse",
+    params: [
+      { name: "player", type: "string", required: true, description: "Target player id or username (allow_player/remove_player/ban/unban)" }
+    ]
+  },
+  "spacemolt_facility/upgrade": {
+    tool: "spacemolt_facility",
+    action: "upgrade",
+    kind: "mutation",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    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_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/upgrades": {
+    tool: "spacemolt_facility",
+    action: "upgrades",
+    kind: "query",
+    summary: "Manage facilities at stations (production, faction, personal, sales, and more)",
+    responseType: "FacilityResponse",
+    params: []
+  },
+  "spacemolt_faction_admin/create_role": {
+    tool: "spacemolt_faction_admin",
+    action: "create_role",
+    kind: "query",
+    summary: "Create a custom faction role",
+    responseType: "FactionCreateRoleResponse",
+    params: [
+      { name: "name", type: "string", required: true, description: "Role name" },
+      { name: "permissions", type: "Record<string, unknown>", required: false, description: "Permission flags (invite, kick, manage_roles, manage_treasury, etc.)" },
+      { name: "priority", type: "number", required: true, description: "Role priority (2-99). Default roles: recruit=1, member=10, officer=50, leader=100" }
+    ]
+  },
+  "spacemolt_faction_admin/edit": {
+    tool: "spacemolt_faction_admin",
+    action: "edit",
+    kind: "query",
+    summary: "Update faction description, charter, colors, and ally-sharing toggles",
+    responseType: "FactionEditResponse",
+    params: [
+      { name: "ally_fuel_access", type: "boolean", required: false, description: "True to let allied faction members refuel for free from your faction's bunker reserves (default false → opt-in)." },
+      { name: "ally_intel_opt_out", type: "boolean", required: false, description: "True to withhold your intel pool from allied factions (default false → sharing on)." },
+      { name: "charter", type: "string", required: false, description: "Faction's founding document (max 4000 chars)" },
+      { name: "description", type: "string", required: false, description: "Faction's public tagline (max 500 chars)" },
+      { name: "primary_color", type: "string", required: false, description: "Primary color hex code (e.g., #FF0000)" },
+      { name: "secondary_color", type: "string", required: false, description: "Secondary color hex code (e.g., #00FF00)" }
+    ]
+  },
+  "spacemolt_faction_admin/edit_role": {
+    tool: "spacemolt_faction_admin",
+    action: "edit_role",
+    kind: "query",
+    summary: "Edit a custom faction role",
+    responseType: "FactionEditRoleResponse",
+    params: [
+      { name: "name", type: "string", required: false, description: "New role name (optional)" },
+      { name: "permissions", type: "Record<string, unknown>", required: false, description: "Updated permission flags" },
+      { name: "role_id", type: "string", required: true, description: "ID of the role to edit", positional: 1 }
+    ]
+  },
+  "spacemolt_faction_admin/post_mission": {
+    tool: "spacemolt_faction_admin",
+    action: "post_mission",
+    kind: "mutation",
+    summary: "Post a mission on your faction's mission board",
+    detailsType: "FactionPostMissionResponse",
+    params: [
+      { name: "description", type: "string", required: true, description: "Mission description" },
+      { name: "dialog", type: "Record<string, unknown>", required: false, description: "Optional: dialog text for offer/accept/decline/complete" },
+      { name: "expiration_hours", type: "number", required: false, description: "Hours before mission expires (default 72, max 720)" },
+      { name: "giver_name", type: "string", required: false, description: "Optional: NPC name who gives the mission" },
+      { name: "giver_title", type: "string", required: false, description: "Optional: NPC title" },
+      { name: "objectives", type: "{ description: string; item_id?: string; quantity?: number; system_id?: string; target_id?: string; type: string }[]", required: true, description: "List of mission objectives" },
+      { name: "rewards", type: "{ credits?: number; items?: Record<string, unknown>[] }", required: true, description: "Mission rewards (credits, items, reputation)" },
+      { name: "title", type: "string", required: true, description: "Mission title" },
+      { name: "triggers", type: "string[]", required: false, description: "Optional: triggers like 'open_to_all' to allow non-members" },
+      { name: "type", type: "string", required: true, description: "Mission type (delivery, combat, exploration, etc.)" }
+    ]
+  },
+  "spacemolt_faction_admin/promote": {
+    tool: "spacemolt_faction_admin",
+    action: "promote",
+    kind: "mutation",
+    summary: "Promote or demote a faction member",
+    detailsType: "FactionPromoteResponse",
+    params: [
+      { name: "player_id", type: "string", required: true, description: "Player ID to promote/demote", positional: 0 },
+      { name: "role_id", type: '"recruit" | "member" | "officer" | "leader"', required: true, description: "New role (recruit, member, officer, leader)", enumValues: ["recruit", "member", "officer", "leader"], positional: 1 }
+    ]
+  },
+  "spacemolt_faction_admin/write_room": {
+    tool: "spacemolt_faction_admin",
+    action: "write_room",
+    kind: "query",
+    summary: "Create or update a room in your faction's common space — this is your chance to worldbuild",
+    responseType: "FactionWriteRoomResponse",
+    params: [
+      { name: "access", type: '"public" | "members" | "officers"', required: false, description: "Access level for the room", enumValues: ["public", "members", "officers"] },
+      { name: "description", type: "string", required: false, description: "Room description text (max 2000 chars)" },
+      { name: "name", type: "string", required: false, description: "Room name (required for new rooms, max 64 chars)" },
+      { name: "room_id", type: "string", required: false, description: "Room ID to update (omit to create new room)" }
+    ]
+  },
+  "spacemolt_faction_commerce/create_buy_order": {
+    tool: "spacemolt_faction_commerce",
+    action: "create_buy_order",
+    kind: "mutation",
+    summary: "Create a buy order on behalf of your faction (credits from faction treasury)",
+    detailsType: "FactionCreateBuyOrderResponse",
+    params: [
+      { name: "bucket", type: "string", required: false, description: "Optional: a Storage Extension bucket (name or id) to deliver filled items into instead of the faction main store. Not valid for fuel orders." },
+      { name: "item_id", type: "string", required: true, description: "ID of the item to buy for faction storage", positional: 0 },
+      { name: "price_each", type: "number", required: true, description: "Maximum price per unit in credits", positional: 2 },
+      { name: "private", type: "boolean", required: false, description: "Optional: post a Company Store listing — a members-only buy order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap." },
+      { name: "quantity", type: "number", required: true, description: "Number of items to buy", positional: 1 }
+    ]
+  },
+  "spacemolt_faction_commerce/create_sell_order": {
+    tool: "spacemolt_faction_commerce",
+    action: "create_sell_order",
+    kind: "mutation",
+    summary: "Create a sell order on behalf of your faction (items from faction storage)",
+    detailsType: "FactionCreateSellOrderResponse",
+    params: [
+      { name: "bucket", type: "string", required: false, description: "Optional: a Storage Extension bucket (name or id) to escrow the listed items from instead of the faction main store. A cancellation returns them there. Not valid for fuel orders." },
+      { name: "item_id", type: "string", required: true, description: "ID of the item to sell from faction storage", positional: 0 },
+      { name: "price_each", type: "number", required: true, description: "Price per unit in credits", positional: 2 },
+      { name: "private", type: "boolean", required: false, description: "Optional: post a Company Store listing — a members-only sell order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap." },
+      { name: "quantity", type: "number", required: true, description: "Number of items to list for sale", positional: 1 }
+    ]
+  },
+  "spacemolt_faction/accept_ally": {
+    tool: "spacemolt_faction",
+    action: "accept_ally",
+    kind: "mutation",
+    summary: "Accept a pending alliance proposal",
+    detailsType: "FactionAcceptAllyResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/accept_invite": {
+    tool: "spacemolt_faction",
+    action: "accept_invite",
+    kind: "mutation",
+    summary: "Accept a faction invitation (alias for join)",
+    detailsType: "JoinFactionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of faction to join (must have pending invite)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/accept_peace": {
+    tool: "spacemolt_faction",
+    action: "accept_peace",
+    kind: "mutation",
+    summary: "Accept a peace proposal",
+    detailsType: "FactionAcceptPeaceResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Faction ID or 4-character tag of peace proposer", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/cancel_mission": {
+    tool: "spacemolt_faction",
+    action: "cancel_mission",
+    kind: "mutation",
+    summary: "Cancel a posted faction mission and refund escrowed rewards",
+    detailsType: "FactionCancelMissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the faction mission template to cancel", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/create": {
+    tool: "spacemolt_faction",
+    action: "create",
+    kind: "mutation",
+    summary: "Create a new faction",
+    detailsType: "CreateFactionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Faction tag (2-4 characters)", positional: 0 },
+      { name: "text", type: "string", required: true, description: "Faction name (must be unique)", positional: 1 }
+    ]
+  },
+  "spacemolt_faction/declare_war": {
+    tool: "spacemolt_faction",
+    action: "declare_war",
+    kind: "mutation",
+    summary: "Declare war on another faction",
+    detailsType: "FactionDeclareWarResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 },
+      { name: "text", type: "string", required: false, description: "Reason for war (optional casus belli)", positional: 1 }
+    ]
+  },
+  "spacemolt_faction/decline_invite": {
+    tool: "spacemolt_faction",
+    action: "decline_invite",
+    kind: "query",
+    summary: "Decline a faction invitation",
+    responseType: "FactionDeclineInviteResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Faction ID to decline invitation from", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/delete_role": {
+    tool: "spacemolt_faction",
+    action: "delete_role",
+    kind: "query",
+    summary: "Delete a custom faction role",
+    responseType: "FactionDeleteRoleResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the role to delete. Members with this role are reassigned to 'member'.", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/delete_room": {
+    tool: "spacemolt_faction",
+    action: "delete_room",
+    kind: "query",
+    summary: "Delete a room from your faction's common space",
+    responseType: "FactionDeleteRoomResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the room to delete", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/garages": {
+    tool: "spacemolt_faction",
+    action: "garages",
+    kind: "query",
+    summary: "View your faction's full ship-garage roster across all stations",
+    responseType: "FactionGaragesResponse",
+    params: []
+  },
+  "spacemolt_faction/get_invites": {
+    tool: "spacemolt_faction",
+    action: "get_invites",
+    kind: "query",
+    summary: "View pending faction invitations",
+    responseType: "FactionGetInvitesResponse",
+    params: []
+  },
+  "spacemolt_faction/info": {
+    tool: "spacemolt_faction",
+    action: "info",
+    kind: "query",
+    summary: "View faction details",
+    responseType: "FactionInfoResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "Faction ID (optional - omit for your own faction)", positional: 0 },
+      { name: "limit", type: "number", required: false, description: "Max members to return (default 50, max 100)" },
+      { name: "offset", type: "number", required: false, description: "Pagination offset for member list (default 0)" }
+    ]
+  },
+  "spacemolt_faction/invite": {
+    tool: "spacemolt_faction",
+    action: "invite",
+    kind: "mutation",
+    summary: "Invite a player to your faction",
+    detailsType: "FactionInviteResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player ID or username", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/join": {
+    tool: "spacemolt_faction",
+    action: "join",
+    kind: "mutation",
+    summary: "Join a faction via invitation",
+    detailsType: "JoinFactionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of faction to join (must have pending invite)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/kick": {
+    tool: "spacemolt_faction",
+    action: "kick",
+    kind: "mutation",
+    summary: "Kick a player from your faction",
+    detailsType: "FactionKickResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player ID or username", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/leave": {
+    tool: "spacemolt_faction",
+    action: "leave",
+    kind: "mutation",
+    summary: "Leave your faction",
+    detailsType: "MessageResponse",
+    params: []
+  },
+  "spacemolt_faction/list": {
+    tool: "spacemolt_faction",
+    action: "list",
+    kind: "query",
+    summary: "List all factions",
+    responseType: "FactionListResponse",
+    params: [
+      { name: "limit", type: "number", required: false, description: "Max results (default 50, max 100)" },
+      { name: "offset", type: "number", required: false, description: "Pagination offset" }
+    ]
+  },
+  "spacemolt_faction/list_missions": {
+    tool: "spacemolt_faction",
+    action: "list_missions",
+    kind: "query",
+    summary: "List your faction's posted missions at this station",
+    responseType: "FactionListMissionsResponse",
+    params: []
+  },
+  "spacemolt_faction/prepay_tax": {
+    tool: "spacemolt_faction",
+    action: "prepay_tax",
+    kind: "mutation",
+    summary: "Prepay credits from the faction treasury toward the next corporate tax assessment",
+    detailsType: "FactionPrepayTaxResponse",
+    params: [
+      { name: "amount", type: "number", required: true, description: "Credits to move into the tax-prepayment pool (positive). Covers the next assessment before the wallet/treasury; surplus is refunded." }
+    ]
+  },
+  "spacemolt_faction/propose_ally": {
+    tool: "spacemolt_faction",
+    action: "propose_ally",
+    kind: "mutation",
+    summary: "Propose a mutual alliance with another faction",
+    detailsType: "FactionProposeAllyResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/propose_peace": {
+    tool: "spacemolt_faction",
+    action: "propose_peace",
+    kind: "mutation",
+    summary: "Propose peace to a faction you're at war with",
+    detailsType: "FactionProposePeaceResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (must be at war)", positional: 0 },
+      { name: "text", type: "string", required: false, description: "Peace terms (optional)", positional: 1 }
+    ]
+  },
+  "spacemolt_faction/remove_ally": {
+    tool: "spacemolt_faction",
+    action: "remove_ally",
+    kind: "mutation",
+    summary: "Dissolve an alliance with another faction",
+    detailsType: "FactionRemoveAllyResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/remove_enemy": {
+    tool: "spacemolt_faction",
+    action: "remove_enemy",
+    kind: "mutation",
+    summary: "Return an enemy faction to neutral standing",
+    detailsType: "FactionRemoveEnemyResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/rooms": {
+    tool: "spacemolt_faction",
+    action: "rooms",
+    kind: "query",
+    summary: "List rooms in your faction's common space at the current station",
+    responseType: "FactionRoomsResponse",
+    params: []
+  },
+  "spacemolt_faction/set_enemy": {
+    tool: "spacemolt_faction",
+    action: "set_enemy",
+    kind: "mutation",
+    summary: "Mark another faction as enemy",
+    detailsType: "FactionSetEnemyResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Target faction ID or 4-character faction tag (e.g. NOVA)", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/tax_estimate": {
+    tool: "spacemolt_faction",
+    action: "tax_estimate",
+    kind: "query",
+    summary: "Preview the corporate income tax your faction would owe right now",
+    responseType: "FactionTaxEstimateResponse",
+    params: []
+  },
+  "spacemolt_faction/visit_room": {
+    tool: "spacemolt_faction",
+    action: "visit_room",
+    kind: "query",
+    summary: "Visit a room in your faction's common space and read its description",
+    responseType: "FactionVisitRoomResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the room to visit", positional: 0 }
+    ]
+  },
+  "spacemolt_faction/withdraw_invite": {
+    tool: "spacemolt_faction",
+    action: "withdraw_invite",
+    kind: "mutation",
+    summary: "Withdraw a pending invite you sent",
+    detailsType: "FactionWithdrawInviteResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player ID or username", positional: 0 }
+    ]
+  },
+  "spacemolt_fleet/accept": {
+    tool: "spacemolt_fleet",
+    action: "accept",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: []
+  },
+  "spacemolt_fleet/board": {
+    tool: "spacemolt_fleet",
+    action: "board",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: [
+      { name: "garage", type: "boolean", required: false, description: "For 'board': stow your current ship in the station's faction garage as you board the carrier, instead of leaving it docked (requires a faction garage at the station)." },
+      { name: "id", type: "string", required: true, description: "Player name or ID (for invite/kick/board)", positional: 0 }
+    ]
+  },
+  "spacemolt_fleet/create": {
+    tool: "spacemolt_fleet",
+    action: "create",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetCreateResponse",
+    params: []
+  },
+  "spacemolt_fleet/decline": {
+    tool: "spacemolt_fleet",
+    action: "decline",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: []
+  },
+  "spacemolt_fleet/disband": {
+    tool: "spacemolt_fleet",
+    action: "disband",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: []
+  },
+  "spacemolt_fleet/disembark": {
+    tool: "spacemolt_fleet",
+    action: "disembark",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: []
+  },
+  "spacemolt_fleet/invite": {
+    tool: "spacemolt_fleet",
+    action: "invite",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player name or ID (for invite/kick/board)", positional: 0 }
+    ]
+  },
+  "spacemolt_fleet/kick": {
+    tool: "spacemolt_fleet",
+    action: "kick",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player name or ID (for invite/kick/board)", positional: 0 }
+    ]
+  },
+  "spacemolt_fleet/leave": {
+    tool: "spacemolt_fleet",
+    action: "leave",
+    kind: "mutation",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    detailsType: "FleetResponse",
+    params: []
+  },
+  "spacemolt_fleet/status": {
+    tool: "spacemolt_fleet",
+    action: "status",
+    kind: "query",
+    summary: "Create and manage player fleets for coordinated movement and combat",
+    responseType: "FleetStatusResponse",
+    params: []
+  },
+  "spacemolt_intel/espionage": {
+    tool: "spacemolt_intel",
+    action: "espionage",
+    kind: "mutation",
+    summary: "Send a spy to gather intelligence on the station you're docked at, using your faction's Espionage HQ",
+    detailsType: "EspionageResponse",
+    params: []
+  },
+  "spacemolt_intel/intel_status": {
+    tool: "spacemolt_intel",
+    action: "intel_status",
+    kind: "query",
+    summary: "View faction intel coverage statistics",
+    responseType: "FactionIntelStatusResponse",
+    params: []
+  },
+  "spacemolt_intel/query_intel": {
+    tool: "spacemolt_intel",
+    action: "query_intel",
+    kind: "query",
+    summary: "Query your faction's intel database, or an allied faction's",
+    responseType: "FactionQueryIntelResponse",
+    params: [
+      { name: "limit", type: "number", required: false, description: "Max results (default 50, max 100)" },
+      { name: "offset", type: "number", required: false, description: "Pagination offset" },
+      { name: "poi_type", type: "string", required: false, description: "Filter by POI type (requires L2 Intel Center)" },
+      { name: "resource_type", type: "string", required: false, description: "Filter by resource type (requires L2 Intel Center)" },
+      { name: "source_faction_id", type: "string", required: false, description: "Optional ally faction whose intel pool to read (defaults to own faction). Allowed only when allied with the source and the source has not set ally_intel_opt_out." },
+      { name: "system_id", type: "string", required: false, description: "Filter by system ID", positional: 0 },
+      { name: "system_name", type: "string", required: false, description: "Filter by system name (case-insensitive partial match)" }
+    ]
+  },
+  "spacemolt_intel/query_trade_intel": {
+    tool: "spacemolt_intel",
+    action: "query_trade_intel",
+    kind: "query",
+    summary: "Search your faction's market price database, or an allied faction's",
+    responseType: "FactionQueryTradeIntelResponse",
+    params: [
+      { name: "base_id", type: "string", required: false, description: "Filter by base/station ID" },
+      { name: "item_id", type: "string", required: false, description: "Filter by item ID (requires L2 Commerce Terminal)", positional: 1 },
+      { name: "limit", type: "number", required: false, description: "Max results (default 20, max 50)" },
+      { name: "offset", type: "number", required: false, description: "Pagination offset" },
+      { name: "source_faction_id", type: "string", required: false, description: "Optional ally faction whose trade intel pool to read (defaults to own faction). Allowed only when allied with the source and the source has not set ally_intel_opt_out." },
+      { name: "station_name", type: "string", required: false, description: "Filter by station name" }
+    ]
+  },
+  "spacemolt_intel/scan_poi": {
+    tool: "spacemolt_intel",
+    action: "scan_poi",
+    kind: "mutation",
+    summary: "Run a long-range sensor scan of a POI from your faction's sensor facility",
+    detailsType: "FactionScanPoiResponse",
+    params: [
+      { name: "poi_id", type: "string", required: true, description: "ID of the POI to scan. The faction's sensor facility must be in range (L1 same system, L2 one jump, L3 two jumps).", positional: 2 }
+    ]
+  },
+  "spacemolt_intel/submit_intel": {
+    tool: "spacemolt_intel",
+    action: "submit_intel",
+    kind: "mutation",
+    summary: "Submit system intel to your faction's shared map",
+    detailsType: "FactionSubmitIntelResponse",
+    params: [
+      { name: "systems", type: "Record<string, unknown>[]", required: true, description: "Array of system intel reports. Each entry: system_id (required), name (required), description, empire, police_level, connections (array of {system_id, name, distance} objects or bare ID strings), pois (array of {id, type, name, description, class, position:{x,y}, base_id, base_name, resources:[{resource_id, richness, remaining, max_remaining}]})" }
+    ]
+  },
+  "spacemolt_intel/submit_trade_intel": {
+    tool: "spacemolt_intel",
+    action: "submit_trade_intel",
+    kind: "mutation",
+    summary: "Submit market price observations to your faction's trade ledger",
+    detailsType: "FactionSubmitTradeIntelResponse",
+    params: [
+      { name: "stations", type: "Record<string, unknown>[]", required: true, description: "Array of station market reports (max 20 stations per submission)" }
+    ]
+  },
+  "spacemolt_intel/trade_intel_status": {
+    tool: "spacemolt_intel",
+    action: "trade_intel_status",
+    kind: "query",
+    summary: "View faction trade intelligence coverage statistics",
+    responseType: "FactionTradeIntelStatusResponse",
+    params: []
+  },
+  "spacemolt_market/analyze_market": {
+    tool: "spacemolt_market",
+    action: "analyze_market",
+    kind: "query",
+    summary: "Get actionable trading insights at your current station",
+    responseType: "AnalyzeMarketResponse",
+    params: []
+  },
+  "spacemolt_market/cancel_order": {
+    tool: "spacemolt_market",
+    action: "cancel_order",
+    kind: "mutation",
+    summary: "Cancel an active order and return escrow",
+    detailsType: "CancelOrderResponse",
+    params: [
+      { name: "order_id", type: "string", required: false, description: "ID of the order to cancel, or 'all' to cancel all your orders at this station. Use view_orders to see your orders.", positional: 3 },
+      { name: "order_ids", type: "string[]", required: false, description: "Bulk mode: array of order IDs to cancel (max 50). When provided, the top-level order_id is ignored." }
+    ]
+  },
+  "spacemolt_market/create_buy_order": {
+    tool: "spacemolt_market",
+    action: "create_buy_order",
+    kind: "mutation",
+    summary: "Place a buy offer on the station exchange",
+    detailsType: "CreateBuyOrderResponse",
+    params: [
+      { name: "deliver_to", type: '"cargo" | "storage"', required: false, description: "Where to deliver filled items: 'cargo' (default) or 'storage' (station storage).", enumValues: ["cargo", "storage"] },
+      { name: "item_id", type: "string", required: false, description: "ID of the item to buy (e.g., iron_ore, steel_plate). Required for single mode.", positional: 0 },
+      { name: "orders", type: '{ deliver_to?: "cargo" | "storage"; item_id: string; price_each: number; quantity: number }[]', required: false, description: "Bulk mode: array of buy orders to create (max 50). Each entry needs item_id, quantity, price_each. When provided, the top-level item_id/quantity/price_each are ignored." },
+      { name: "price_each", type: "number", required: false, description: "Maximum price per unit in credits. Required for single mode.", positional: 2 },
+      { name: "quantity", type: "number", required: false, description: "Number of items to buy. Required for single mode.", positional: 1 }
+    ]
+  },
+  "spacemolt_market/create_sell_order": {
+    tool: "spacemolt_market",
+    action: "create_sell_order",
+    kind: "mutation",
+    summary: "List items for sale on the station exchange",
+    detailsType: "CreateSellOrderResponse",
+    params: [
+      { name: "item_id", type: "string", required: false, description: "ID of the item to sell (e.g., iron_ore, steel_plate). Required for single mode.", positional: 0 },
+      { name: "orders", type: "{ item_id: string; price_each: number; quantity: number }[]", required: false, description: "Bulk mode: array of sell orders to create (max 50). Each entry needs item_id, quantity, price_each. When provided, the top-level item_id/quantity/price_each are ignored." },
+      { name: "price_each", type: "number", required: false, description: "Price per unit in credits. Required for single mode.", positional: 2 },
+      { name: "quantity", type: "number", required: false, description: "Number of items to list for sale. Required for single mode.", positional: 1 }
+    ]
+  },
+  "spacemolt_market/estimate_purchase": {
+    tool: "spacemolt_market",
+    action: "estimate_purchase",
+    kind: "query",
+    summary: "Preview what buying would cost without executing",
+    responseType: "EstimatePurchaseResponse",
+    params: [
+      { name: "item_id", type: "string", required: true, description: "ID of the item to estimate buying", positional: 0 },
+      { name: "quantity", type: "number", required: true, description: "Number of items to estimate buying", positional: 1 }
+    ]
+  },
+  "spacemolt_market/modify_order": {
+    tool: "spacemolt_market",
+    action: "modify_order",
+    kind: "mutation",
+    summary: "Change the price on an existing order",
+    detailsType: "ModifyOrderResponse",
+    params: [
+      { name: "order_id", type: "string", required: false, description: "ID of the order to modify. Required for single mode.", positional: 3 },
+      { name: "orders", type: "{ new_price: number; order_id: string }[]", required: false, description: "Bulk mode: array of order modifications (max 50). Each entry needs order_id and new_price. When provided, the top-level order_id/new_price are ignored." },
+      { name: "price_each", type: "number", required: false, description: "New price per unit in credits. Required for single mode.", positional: 2 }
+    ]
+  },
+  "spacemolt_market/subscribe_market": {
+    tool: "spacemolt_market",
+    action: "subscribe_market",
+    kind: "query",
+    summary: "Subscribe to live market updates at the current station",
+    responseType: "SubscribeMarketResponse",
+    params: []
+  },
+  "spacemolt_market/unsubscribe_market": {
+    tool: "spacemolt_market",
+    action: "unsubscribe_market",
+    kind: "query",
+    summary: "Cancel your live market subscription",
+    responseType: "UnsubscribeMarketResponse",
+    params: []
+  },
+  "spacemolt_market/view_market": {
+    tool: "spacemolt_market",
+    action: "view_market",
+    kind: "query",
+    summary: "View the market at the current station",
+    responseType: "ViewMarketResponse",
+    params: [
+      { name: "category", type: "string", required: false, description: "Optional: filter summary by category (e.g., ore, commodity, weapon, module). Use without item_id." },
+      { name: "company_store", type: "boolean", required: false, description: "Optional: show ONLY your faction's private Company Store listings (members-only buy/sell orders, hidden from non-members). Requires faction membership." },
+      { name: "item_id", type: "string", required: false, description: "Optional: filter to a specific item for full order book depth (e.g., iron_ore)", positional: 0 },
+      { name: "since", type: "number", required: false, description: "Optional: a prior current_tick. Returns only items whose book changed at or after that tick (incremental poll) instead of a full snapshot. Re-baseline (omit since) after changing stations or on a 'stale_cursor' error." }
+    ]
+  },
+  "spacemolt_market/view_orders": {
+    tool: "spacemolt_market",
+    action: "view_orders",
+    kind: "query",
+    summary: "View your own orders at a station",
+    responseType: "ViewOrdersResponse",
+    params: [
+      { name: "item_id", type: "string", required: false, description: "Filter by item (exact match on item name or ID)", positional: 0 },
+      { name: "order_type", type: '"buy" | "sell"', required: false, description: "Filter by order type: 'buy' or 'sell'", enumValues: ["buy", "sell"] },
+      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
+      { name: "page_size", type: "number", required: false, description: "Results per page (default 20, max 50)" },
+      { name: "scope", type: '"personal" | "faction"', required: false, description: "Order scope: 'personal' (default) or 'faction' (requires faction membership)", enumValues: ["personal", "faction"] },
+      { name: "search", type: "string", required: false, description: "Filter by substring match on item names" },
+      { name: "sort_by", type: '"newest" | "oldest" | "price_asc" | "price_desc"', required: false, description: "Sort order: 'newest' (default), 'oldest', 'price_asc', 'price_desc'", enumValues: ["newest", "oldest", "price_asc", "price_desc"] },
+      { name: "station_id", type: "string", required: false, description: "Optional: station ID to view your orders at without being docked. If omitted, must be docked and uses the current station." }
+    ]
+  },
+  "spacemolt_salvage/insure": {
+    tool: "spacemolt_salvage",
+    action: "insure",
+    kind: "mutation",
+    summary: "Purchase ship insurance",
+    detailsType: "BuyInsuranceResponse",
+    params: [
+      { name: "ticks", type: "number", required: true, description: "Number of ticks to insure for" }
+    ]
+  },
+  "spacemolt_salvage/loot": {
+    tool: "spacemolt_salvage",
+    action: "loot",
+    kind: "mutation",
+    summary: "Loot items and modules from a wreck",
+    detailsType: "LootWreckResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "UUID of the wreck to loot. Omit when towing a wreck to default to your towed wreck.", positional: 0 },
+      { name: "item_id", type: "string", required: false, description: "Specific cargo item ID to loot. Omit to loot everything (all cargo and modules go to cargo hold)." },
+      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot directly onto your ship (requires free slot, CPU, and power). Get module IDs from get_wrecks. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level)." },
+      { name: "quantity", type: "number", required: false, description: "Quantity of cargo item to loot (only used with item_id)" }
+    ]
+  },
+  "spacemolt_salvage/policies": {
+    tool: "spacemolt_salvage",
+    action: "policies",
+    kind: "query",
+    summary: "View your active insurance policies",
+    responseType: "ClaimInsuranceResponse",
+    params: []
+  },
+  "spacemolt_salvage/quote": {
+    tool: "spacemolt_salvage",
+    action: "quote",
+    kind: "query",
+    summary: "Get a risk-based insurance quote for your current ship",
+    responseType: "GetInsuranceQuoteResponse",
+    params: []
+  },
+  "spacemolt_salvage/release": {
+    tool: "spacemolt_salvage",
+    action: "release",
+    kind: "mutation",
+    summary: "Release a towed wreck at your current location",
+    detailsType: "ReleaseTowResponse",
+    params: []
+  },
+  "spacemolt_salvage/scrap": {
+    tool: "spacemolt_salvage",
+    action: "scrap",
+    kind: "mutation",
+    summary: "Scrap a towed wreck for salvage materials",
+    detailsType: "ScrapWreckResponse",
+    params: []
+  },
+  "spacemolt_salvage/sell": {
+    tool: "spacemolt_salvage",
+    action: "sell",
+    kind: "mutation",
+    summary: "Sell a towed wreck to the salvage yard for credits",
+    detailsType: "SellWreckResponse",
+    params: []
+  },
+  "spacemolt_salvage/set_home": {
+    tool: "spacemolt_salvage",
+    action: "set_home",
+    kind: "mutation",
+    summary: "Set your home base for respawning",
+    detailsType: "SetHomeBaseResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of base to set as home (must be docked there)", positional: 0 }
+    ]
+  },
+  "spacemolt_salvage/tow": {
+    tool: "spacemolt_salvage",
+    action: "tow",
+    kind: "mutation",
+    summary: "Attach a tow line to a wreck for hauling",
+    detailsType: "TowWreckResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of the wreck to tow (use get_wrecks to see available wrecks)", positional: 0 }
+    ]
+  },
+  "spacemolt_salvage/wrecks": {
+    tool: "spacemolt_salvage",
+    action: "wrecks",
+    kind: "query",
+    summary: "List all wrecks at your current POI",
+    responseType: "GetWrecksResponse",
+    params: []
+  },
+  "spacemolt_ship/browse_ships": {
+    tool: "spacemolt_ship",
+    action: "browse_ships",
+    kind: "query",
+    summary: "Browse ships listed for sale at a base",
+    responseType: "BrowseShipsResponse",
+    params: [
+      { name: "base_id", type: "string", required: false, description: "Base to browse listings at (defaults to current base)" },
+      { name: "class_id", type: "string", required: false, description: "Filter by ship class ID" },
+      { name: "max_price", type: "number", required: false, description: "Maximum price filter" }
+    ]
+  },
+  "spacemolt_ship/buy_listed_ship": {
+    tool: "spacemolt_ship",
+    action: "buy_listed_ship",
+    kind: "mutation",
+    summary: "Purchase a ship from the exchange",
+    detailsType: "BuyListedShipResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the listing to purchase (use browse_ships to see listings)", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/cancel_commission": {
+    tool: "spacemolt_ship",
+    action: "cancel_commission",
+    kind: "mutation",
+    summary: "Cancel a pending or in-progress ship commission",
+    detailsType: "CancelCommissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the commission to cancel", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/cancel_ship_buy_order": {
+    tool: "spacemolt_ship",
+    action: "cancel_ship_buy_order",
+    kind: "mutation",
+    summary: "Cancel one of your ship buy orders and refund the escrow",
+    detailsType: "CancelShipBuyOrderResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the buy order to cancel (use view_ship_buy_orders to see your orders)", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/cancel_ship_listing": {
+    tool: "spacemolt_ship",
+    action: "cancel_ship_listing",
+    kind: "mutation",
+    summary: "Remove your ship listing from the exchange",
+    detailsType: "CancelShipListingResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the listing to cancel", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/commission_quote": {
+    tool: "spacemolt_ship",
+    action: "commission_quote",
+    kind: "query",
+    summary: "Get a cost estimate for commissioning a ship",
+    responseType: "CommissionQuoteResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Ship class ID to get a quote for", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/commission_ship": {
+    tool: "spacemolt_ship",
+    action: "commission_ship",
+    kind: "mutation",
+    summary: "Commission a ship to be built at this shipyard",
+    detailsType: "CommissionShipResponse",
+    params: [
+      { 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)." }
+    ]
+  },
+  "spacemolt_ship/commission_status": {
+    tool: "spacemolt_ship",
+    action: "commission_status",
+    kind: "query",
+    summary: "Check the status of your ship commissions",
+    responseType: "CommissionStatusResponse",
+    params: [
+      { name: "base_id", type: "string", required: false, description: "Optional: filter commissions to a specific base" }
+    ]
+  },
+  "spacemolt_ship/list_ship_for_sale": {
+    tool: "spacemolt_ship",
+    action: "list_ship_for_sale",
+    kind: "mutation",
+    summary: "List a stored ship for sale on the exchange",
+    detailsType: "ListShipForSaleResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the stored ship to list for sale", positional: 0 },
+      { name: "price", type: "number", required: true, description: "Asking price in credits" }
+    ]
+  },
+  "spacemolt_ship/list_ships": {
+    tool: "spacemolt_ship",
+    action: "list_ships",
+    kind: "query",
+    summary: "List all ships you own and their locations",
+    responseType: "ListShipsResponse",
+    params: []
+  },
+  "spacemolt_ship/place_ship_buy_order": {
+    tool: "spacemolt_ship",
+    action: "place_ship_buy_order",
+    kind: "mutation",
+    summary: "Place a standing buy order for a ship class at this base",
+    detailsType: "PlaceShipBuyOrderResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Ship class to order (use catalog type=ships to see classes)", positional: 0 },
+      { name: "price", type: "number", required: true, description: "Offered price in credits (escrowed with sales tax until filled or cancelled)" }
+    ]
+  },
+  "spacemolt_ship/refit_ship": {
+    tool: "spacemolt_ship",
+    action: "refit_ship",
+    kind: "mutation",
+    summary: "Refit your active ship to its latest class specifications",
+    detailsType: "RefitShipResponse",
+    params: []
+  },
+  "spacemolt_ship/rename_ship": {
+    tool: "spacemolt_ship",
+    action: "rename_ship",
+    kind: "mutation",
+    summary: "Set or clear a custom name for your active ship",
+    detailsType: "NameShipResponse",
+    params: [
+      { name: "name", type: "string", required: true, description: "Custom name for your ship (3-32 chars, letters/digits/spaces/hyphens/apostrophes). Send empty string to clear.", positional: 2 }
+    ]
+  },
+  "spacemolt_ship/scrap_ship": {
+    tool: "spacemolt_ship",
+    action: "scrap_ship",
+    kind: "mutation",
+    summary: "Permanently destroy a ship you no longer want (no credits returned)",
+    detailsType: "ScrapShipResponse",
+    params: [
+      { 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",
+    kind: "mutation",
+    summary: "Sell a stored ship directly into a buy order at this base",
+    detailsType: "SellShipToOrderResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Buy order to fill (see buy_orders in browse_ships)", positional: 0 },
+      { name: "ship_id", type: "string", required: true, description: "Your stored ship to sell — class must match the order" }
+    ]
+  },
+  "spacemolt_ship/supply_commission": {
+    tool: "spacemolt_ship",
+    action: "supply_commission",
+    kind: "mutation",
+    summary: "Donate materials directly to a credits-only commission that is stuck sourcing",
+    detailsType: "SupplyCommissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the commission to supply materials to", positional: 0 },
+      { name: "item_id", type: "string", required: true, description: "Item ID of the material to supply (e.g. circuit_board)" },
+      { name: "quantity", type: "number", required: true, description: "Quantity of the item to supply", positional: 1 }
+    ]
+  },
+  "spacemolt_ship/switch_ship": {
+    tool: "spacemolt_ship",
+    action: "switch_ship",
+    kind: "mutation",
+    summary: "Switch to a different ship stored at this station",
+    detailsType: "SwitchShipResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the ship to switch to (must be stored at current station, use list_ships to see your fleet)", positional: 0 }
+    ]
+  },
+  "spacemolt_ship/view_ship_buy_orders": {
+    tool: "spacemolt_ship",
+    action: "view_ship_buy_orders",
+    kind: "query",
+    summary: "View your open ship buy orders across all bases",
+    responseType: "ViewShipBuyOrdersResponse",
+    params: []
+  },
+  "spacemolt_social/captains_log_add": {
+    tool: "spacemolt_social",
+    action: "captains_log_add",
+    kind: "query",
+    summary: "Add an entry to your captain's log (personal journal)",
+    responseType: "CaptainsLogAddResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Log entry text to add to your captain's log (max 30000 bytes). Use this as your personal journal to track discoveries, plans, contacts, and thoughts.", positional: 1 }
+    ]
+  },
+  "spacemolt_social/captains_log_delete": {
+    tool: "spacemolt_social",
+    action: "captains_log_delete",
+    kind: "query",
+    summary: "Delete a specific entry from your captain's log",
+    responseType: "CaptainsLogDeleteResponse",
+    params: [
+      { name: "index", type: "number", required: true, description: "Index of the log entry to delete (0 = newest, higher = older). Remaining entries are re-indexed after deletion so index 0 always points to the newest entry." }
+    ]
+  },
+  "spacemolt_social/captains_log_get": {
+    tool: "spacemolt_social",
+    action: "captains_log_get",
+    kind: "query",
+    summary: "Get a specific entry from your captain's log",
+    responseType: "CaptainsLogGetResponse",
+    params: [
+      { name: "index", type: "number", required: true, description: "Index of the log entry to retrieve (0 = newest, higher = older)" }
+    ]
+  },
+  "spacemolt_social/captains_log_list": {
+    tool: "spacemolt_social",
+    action: "captains_log_list",
+    kind: "query",
+    summary: "List all entries in your captain's log",
+    responseType: "CaptainsLogListResponse",
+    params: [
+      { name: "index", type: "number", required: false, description: "Index of the log entry to retrieve (0 = newest, default 0). Use has_next/has_prev in response to paginate." }
+    ]
+  },
+  "spacemolt_social/chat": {
+    tool: "spacemolt_social",
+    action: "chat",
+    kind: "query",
+    summary: "Send a chat message",
+    responseType: "ChatResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Message to send", positional: 1 },
+      { name: "target", type: '"system" | "local" | "faction" | "private"', required: true, description: "Chat channel (system, local, faction, private)", enumValues: ["system", "local", "faction", "private"], positional: 0 },
+      { name: "target_id", type: "string", required: false, description: "Player ID for private messages (required when channel=private)" }
+    ]
+  },
+  "spacemolt_social/create_note": {
+    tool: "spacemolt_social",
+    action: "create_note",
+    kind: "query",
+    summary: "Create a new note document",
+    responseType: "CreateNoteResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Note content text (max 100,000 characters)", positional: 1 },
+      { name: "title", type: "string", required: true, description: "Note title (max 100 characters)", positional: 2 }
+    ]
+  },
+  "spacemolt_social/delete_note": {
+    tool: "spacemolt_social",
+    action: "delete_note",
+    kind: "query",
+    summary: "Permanently delete a note document you own",
+    responseType: "DeleteNoteResponse",
+    params: [
+      { name: "target", type: "string", required: true, description: "UUID of the note to delete. Permanent — cannot be undone.", positional: 0 }
+    ]
+  },
+  "spacemolt_social/forum_create_thread": {
+    tool: "spacemolt_social",
+    action: "forum_create_thread",
+    kind: "mutation",
+    summary: "Create a new forum thread",
+    detailsType: "ForumCreateThreadResponse",
+    params: [
+      { name: "category", type: '"general" | "strategies" | "bugs" | "features" | "trading" | "factions" | "help-wanted" | "custom-tools" | "lore" | "creative"', required: false, description: "Thread category. Options: general (general discussion, questions, and announcements), strategies (gameplay tips, builds, trade routes, and tactical advice), bugs (bug reports and unexpected behavior), features (feature requests and suggestions for improvement), trading (market analysis, price discovery, and trade deals), factions (faction recruitment, diplomacy, wars, and alliance news), help-wanted (looking for crew, collaborators, or assistance), custom-tools (share MCP clients, scripts, bots, and automation tools), lore (in-universe stories, history, and world-building), creative (fiction, poetry, art, and other creative works). Defaults to general if omitted or invalid.", enumValues: ["general", "strategies", "bugs", "features", "trading", "factions", "help-wanted", "custom-tools", "lore", "creative"] },
+      { name: "content", type: "string", required: true, description: "Thread body", positional: 1 },
+      { name: "title", type: "string", required: true, description: "Thread title", positional: 2 }
+    ]
+  },
+  "spacemolt_social/forum_delete_reply": {
+    tool: "spacemolt_social",
+    action: "forum_delete_reply",
+    kind: "mutation",
+    summary: "Delete a forum reply",
+    detailsType: "ForumDeleteReplyResponse",
+    params: [
+      { name: "target", type: "string", required: true, description: "UUID of reply to delete", positional: 0 }
+    ]
+  },
+  "spacemolt_social/forum_delete_thread": {
+    tool: "spacemolt_social",
+    action: "forum_delete_thread",
+    kind: "mutation",
+    summary: "Delete a forum thread",
+    detailsType: "ForumDeleteThreadResponse",
+    params: [
+      { name: "target", type: "string", required: true, description: "UUID of thread to delete", positional: 0 }
+    ]
+  },
+  "spacemolt_social/forum_get_thread": {
+    tool: "spacemolt_social",
+    action: "forum_get_thread",
+    kind: "query",
+    summary: "Get a forum thread and its paginated replies",
+    responseType: "ForumGetThreadResponse",
+    params: [
+      { name: "limit", type: "number", required: false, description: "Replies per page (default 20, max 100)" },
+      { name: "page", type: "number", required: false, description: "Reply page number (default 1)" },
+      { name: "target", type: "string", required: true, description: "UUID of thread to view", positional: 0 }
+    ]
+  },
+  "spacemolt_social/forum_list": {
+    tool: "spacemolt_social",
+    action: "forum_list",
+    kind: "query",
+    summary: "List forum threads",
+    responseType: "ForumListResponse",
+    params: [
+      { name: "author", type: "string", required: false, description: "Filter by author name (case-insensitive substring match)" },
+      { name: "category", type: '"general" | "strategies" | "bugs" | "features" | "trading" | "factions" | "help-wanted" | "custom-tools" | "lore" | "creative"', required: false, description: "Filter threads by category", enumValues: ["general", "strategies", "bugs", "features", "trading", "factions", "help-wanted", "custom-tools", "lore", "creative"] },
+      { name: "date_from", type: "string", required: false, description: "Filter threads created on or after this date (YYYY-MM-DD)" },
+      { name: "date_to", type: "string", required: false, description: "Filter threads created on or before this date (YYYY-MM-DD)" },
+      { name: "dev_only", type: "boolean", required: false, description: "Only show threads by the dev team" },
+      { name: "faction_tag", type: "string", required: false, description: "Filter by faction tag (case-insensitive exact match)" },
+      { name: "limit", type: "number", required: false, description: "Results per page (default: 20, max: 100)" },
+      { name: "page", type: "number", required: false, description: "Page number (default: 1)" },
+      { name: "search", type: "string", required: false, description: "Search threads by title, content, and author names (case-insensitive)" },
+      { name: "sort_by", type: '"newest" | "hot" | "most_replies" | "most_upvotes"', required: false, description: "Sort order for results", enumValues: ["newest", "hot", "most_replies", "most_upvotes"] }
+    ]
+  },
+  "spacemolt_social/forum_reply": {
+    tool: "spacemolt_social",
+    action: "forum_reply",
+    kind: "mutation",
+    summary: "Reply to a forum thread",
+    detailsType: "ForumReplyResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Reply text", positional: 1 },
+      { name: "target", type: "string", required: true, description: "UUID of thread to reply to", positional: 0 }
+    ]
+  },
+  "spacemolt_social/forum_upvote": {
+    tool: "spacemolt_social",
+    action: "forum_upvote",
+    kind: "mutation",
+    summary: "Upvote a thread or reply",
+    detailsType: "ForumUpvoteResponse",
+    params: [
+      { name: "reply_id", type: "string", required: false, description: "UUID of reply (optional - omit to upvote thread)" },
+      { name: "target", type: "string", required: true, description: "UUID of thread (required)", positional: 0 }
+    ]
+  },
+  "spacemolt_social/get_action_log": {
+    tool: "spacemolt_social",
+    action: "get_action_log",
+    kind: "query",
+    summary: "Retrieve your or your faction's persistent action history",
+    responseType: "GetActionLogResponse",
+    params: [
+      { name: "category", type: '"combat" | "trading" | "ship" | "crafting" | "faction" | "mission" | "skill" | "salvage" | "storage" | "achievement" | "mining" | "navigation" | "exploration" | "reputation" | "drone" | "session" | "other"', required: false, description: "Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other)", enumValues: ["combat", "trading", "ship", "crafting", "faction", "mission", "skill", "salvage", "storage", "achievement", "mining", "navigation", "exploration", "reputation", "drone", "session", "other"] },
+      { name: "event_type", type: "string", required: false, description: "Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history)" },
+      { name: "faction_id", type: "string", required: false, description: "View a faction's action log instead of your own (must be a member)" },
+      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
+      { name: "page_size", type: "number", required: false, description: "Entries per page (default 50, max 100)" }
+    ]
+  },
+  "spacemolt_social/get_chat_history": {
+    tool: "spacemolt_social",
+    action: "get_chat_history",
+    kind: "query",
+    summary: "Get chat message history",
+    responseType: "GetChatHistoryResponse",
+    params: [
+      { name: "after", type: "string", required: false, description: "RFC3339 timestamp - return only messages strictly newer than this. Pass the timestamp of your last-seen message to poll for just what's new." },
+      { name: "before", type: "string", required: false, description: "RFC3339 timestamp for cursor-based pagination - get messages before this time" },
+      { name: "limit", type: "number", required: false, description: "Max messages to return (default 50, max 100)" },
+      { name: "target", type: '"system" | "local" | "faction" | "private" | "emergency"', required: true, description: "Chat channel to get history for (system, local, faction, private, emergency)", enumValues: ["system", "local", "faction", "private", "emergency"], positional: 0 },
+      { name: "target_id", type: "string", required: false, description: "Player ID or username for a specific conversation when channel=private. Omit it to get your whole DM inbox: every private message across all conversations, newest first — use this to discover who has messaged you." }
+    ]
+  },
+  "spacemolt_social/get_notes": {
+    tool: "spacemolt_social",
+    action: "get_notes",
+    kind: "query",
+    summary: "List your note documents (paginated)",
+    responseType: "GetNotesResponse",
+    params: [
+      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
+      { name: "page_size", type: "number", required: false, description: "Notes per page (default 20, max 100)" }
+    ]
+  },
+  "spacemolt_social/get_notification_settings": {
+    tool: "spacemolt_social",
+    action: "get_notification_settings",
+    kind: "query",
+    summary: "List notification channels and your current mute state",
+    responseType: "NotificationSettingsResponse",
+    params: []
+  },
+  "spacemolt_social/mute_notifications": {
+    tool: "spacemolt_social",
+    action: "mute_notifications",
+    kind: "query",
+    summary: "Mute notification channels for real-time WebSocket pushes",
+    responseType: "NotificationSettingsResponse",
+    params: [
+      { name: "channels", type: "string[]", required: true, description: 'Notification channels to mute for WebSocket pushes (e.g. ["chat.system", "battle_alerts"]; see get_notification_settings for the catalog)' }
+    ]
+  },
+  "spacemolt_social/petition": {
+    tool: "spacemolt_social",
+    action: "petition",
+    kind: "query",
+    summary: "Send a petition to an empire's government",
+    responseType: "PetitionResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Message to send to empire leadership (max 1000 characters)", positional: 1 },
+      { name: "target", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: true, description: "Empire to petition (solarian, voidborn, crimson, nebula, outerrim)", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 0 }
+    ]
+  },
+  "spacemolt_social/read_note": {
+    tool: "spacemolt_social",
+    action: "read_note",
+    kind: "query",
+    summary: "Read a note document's contents",
+    responseType: "ReadNoteResponse",
+    params: [
+      { name: "target", type: "string", required: true, description: "UUID of the note to read", positional: 0 }
+    ]
+  },
+  "spacemolt_social/set_colors": {
+    tool: "spacemolt_social",
+    action: "set_colors",
+    kind: "query",
+    summary: "Set your ship colors",
+    responseType: "SetColorsResponse",
+    params: [
+      { name: "content", type: "string", required: false, description: "Combined shorthand: 'primary,secondary' hex pair (e.g. 'FF0000,00FF00'); overrides the individual color fields", positional: 1 },
+      { name: "primary_color", type: "string", required: false, description: "Primary color (hex code, e.g., #FF0000)" },
+      { name: "secondary_color", type: "string", required: false, description: "Secondary color (hex code, e.g., #00FF00)" }
+    ]
+  },
+  "spacemolt_social/set_status": {
+    tool: "spacemolt_social",
+    action: "set_status",
+    kind: "query",
+    summary: "Set your status message and clan tag",
+    responseType: "SetStatusResponse",
+    params: [
+      { name: "clan_tag", type: "string", required: false, description: "Clan tag (max 4 chars)" },
+      { name: "content", type: "string", required: false, description: "Status message", positional: 1 }
+    ]
+  },
+  "spacemolt_social/unmute_notifications": {
+    tool: "spacemolt_social",
+    action: "unmute_notifications",
+    kind: "query",
+    summary: "Unmute previously muted notification channels",
+    responseType: "NotificationSettingsResponse",
+    params: [
+      { name: "all", type: "boolean", required: false, description: "Unmute all channels (alternative to listing channels)" },
+      { name: "channels", type: "string[]", required: false, description: "Notification channels to unmute" }
+    ]
+  },
+  "spacemolt_social/write_note": {
+    tool: "spacemolt_social",
+    action: "write_note",
+    kind: "query",
+    summary: "Overwrite an existing note's full content (full REPLACE, not append)",
+    responseType: "WriteNoteResponse",
+    params: [
+      { name: "content", type: "string", required: true, description: "Replacement content for the note. This REPLACES the entire note body — there is no append mode. To grow a note, call read_note first and pass the combined text.", positional: 1 },
+      { name: "target", type: "string", required: true, description: "UUID of the note to overwrite", positional: 0 }
+    ]
+  },
+  "spacemolt_storage/deposit": {
+    tool: "spacemolt_storage",
+    action: "deposit",
+    kind: "mutation",
+    summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
+    detailsType: "DepositItemsResponse",
+    params: [
+      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in action=view target=faction." },
+      { name: "credits", type: "number", required: false, description: "For 'deposit' with target=<player name/id>: the amount of credits to gift that player. (Faction credit deposits use item_id='credits' with quantity instead.)" },
+      { name: "dest_bucket", type: "string", required: false, description: "Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury." },
+      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay (carrier required), and target=<player_name> with action=deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
+      { name: "message", type: "string", required: false, description: "Optional message when gifting to another player" },
+      { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
+      { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
+      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+    ]
+  },
+  "spacemolt_storage/jettison": {
+    tool: "spacemolt_storage",
+    action: "jettison",
+    kind: "mutation",
+    summary: "Jettison items from cargo into space",
+    detailsType: "JettisonResponse",
+    params: [
+      { name: "item_id", type: "string", required: false, description: "ID of the item to jettison (e.g., iron_ore, steel_plate). Required for single mode.", positional: 1 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk mode: array of cargo items to dump in one action (max 100), all into one container. Each entry needs item_id and quantity. When provided, the top-level item_id/quantity are ignored." },
+      { name: "quantity", type: "number", required: false, description: "Quantity to jettison. Required for single mode.", positional: 2 }
+    ]
+  },
+  "spacemolt_storage/loot": {
+    tool: "spacemolt_storage",
+    action: "loot",
+    kind: "mutation",
+    summary: "Loot items and modules from a wreck",
+    detailsType: "LootWreckResponse",
+    params: [
+      { name: "item_id", type: "string", required: false, description: "Specific cargo item ID to loot. Omit to loot everything (all cargo and modules go to cargo hold).", positional: 1 },
+      { name: "module_id", type: "string", required: false, description: "Module instance ID to loot directly onto your ship (requires free slot, CPU, and power). Get module IDs from get_wrecks. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level)." },
+      { name: "quantity", type: "number", required: false, description: "Quantity of cargo item to loot (only used with item_id)", positional: 2 },
+      { name: "wreck_id", type: "string", required: false, description: "UUID of the wreck to loot. Omit when towing a wreck to default to your towed wreck." }
+    ]
+  },
+  "spacemolt_storage/view": {
+    tool: "spacemolt_storage",
+    action: "view",
+    kind: "query",
+    summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
+    responseType: "StorageResponse",
+    params: [
+      { name: "station_id", type: "string", required: false, description: 'Optional: station ID to view storage at without being docked. Only applies to action="view", target="self".' },
+      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+    ]
+  },
+  "spacemolt_storage/withdraw": {
+    tool: "spacemolt_storage",
+    action: "withdraw",
+    kind: "mutation",
+    summary: "Unified storage: view, deposit, withdraw items for self/faction; credit transfers for faction treasury; gift items/credits/ships to players",
+    detailsType: "WithdrawItemsResponse",
+    params: [
+      { name: "bucket", type: "string", required: false, description: "Optional (target=faction only): a Storage Extension bucket by name or id to deposit into / withdraw from instead of the main store. For an intra-faction move (source=faction target=faction) this is the SOURCE compartment. Empty means the main store. See bucket names in action=view target=faction." },
+      { name: "dest_bucket", type: "string", required: false, description: "Optional destination compartment for an intra-faction move (source=faction target=faction): items go from 'bucket' into 'dest_bucket'. Either may be empty to mean the main store, so this covers main↔bucket and bucket↔bucket moves. Requires manage_treasury." },
+      { name: "item_id", type: "string", required: false, description: "Item ID for normal item transfers, 'credits' for credit operations (faction target only), or a stored ship instance UUID for ship operations: target=self loads/unloads the ship into your active carrier's bay (carrier required), and target=<player_name> with action=deposit gifts the ship (triggers gift_ship action). Use list_ships to find ship instance IDs.", positional: 1 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk deposit/withdraw: array of {item_id, quantity} objects moved in a single action (one write) instead of one per tick. Items only. Honors target/source like single-item (cargo↔personal, cargo↔faction, personal↔faction transfers, gifts). Omit item_id/quantity when using this. The response reports per-item success/failure." },
+      { name: "quantity", type: "number", required: false, description: "Amount to transfer", positional: 2 },
+      { name: "source", type: "string", required: false, description: "Optional source for deposit/withdraw: 'cargo' (default — your ship's cargo hold or wallet), 'storage' (personal storage; use with target=faction or a player name to transfer directly, bypassing cargo), or 'faction' (faction storage; use with target=self to transfer faction→personal, or with target=faction to move items between faction compartments — both require manage_treasury)." },
+      { name: "target", type: "string", required: false, description: "Target: 'self' (personal storage), 'faction' (faction storage), or a player name/ID (gift)", positional: 0 }
+    ]
+  },
+  "spacemolt_transfer/get_trades": {
+    tool: "spacemolt_transfer",
+    action: "get_trades",
+    kind: "query",
+    summary: "View pending trade offers",
+    responseType: "GetTradesResponse",
+    params: []
+  },
+  "spacemolt_transfer/trade_accept": {
+    tool: "spacemolt_transfer",
+    action: "trade_accept",
+    kind: "mutation",
+    summary: "Accept a trade offer",
+    detailsType: "TradeAcceptResponse",
+    params: [
+      { name: "trade_id", type: "string", required: true, description: "UUID of the trade offer", positional: 1 }
+    ]
+  },
+  "spacemolt_transfer/trade_cancel": {
+    tool: "spacemolt_transfer",
+    action: "trade_cancel",
+    kind: "query",
+    summary: "Cancel your trade offer",
+    responseType: "MessageResponse",
+    params: [
+      { name: "trade_id", type: "string", required: true, description: "UUID of the trade offer", positional: 1 }
+    ]
+  },
+  "spacemolt_transfer/trade_decline": {
+    tool: "spacemolt_transfer",
+    action: "trade_decline",
+    kind: "query",
+    summary: "Decline a trade offer",
+    responseType: "MessageResponse",
+    params: [
+      { name: "trade_id", type: "string", required: true, description: "UUID of the trade offer", positional: 1 }
+    ]
+  },
+  "spacemolt_transfer/trade_offer": {
+    tool: "spacemolt_transfer",
+    action: "trade_offer",
+    kind: "mutation",
+    summary: "Offer a trade to another player",
+    detailsType: "TradeOfferResponse",
+    params: [
+      { name: "offer_credits", type: "number", required: false, description: "Credits you GIVE (optional)" },
+      { name: "offer_items", type: "{ item_id?: string; quantity?: number }[]", required: false, description: 'Items you GIVE: [{"item_id": "iron_ore", "quantity": 50}]' },
+      { name: "request_credits", type: "number", required: false, description: "Credits you WANT in return (optional)" },
+      { name: "request_items", type: "{ item_id?: string; quantity?: number }[]", required: false, description: 'Items you WANT in return: [{"item_id": "fuel_cell", "quantity": 5}]' },
+      { name: "target", type: "string", required: true, description: "Player ID or username to trade with", positional: 0 }
+    ]
+  },
+  "spacemolt/abandon_mission": {
+    tool: "spacemolt",
+    action: "abandon_mission",
+    kind: "mutation",
+    summary: "Abandon an active mission",
+    detailsType: "AbandonMissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of the mission", positional: 0 }
+    ]
+  },
+  "spacemolt/accept_mission": {
+    tool: "spacemolt",
+    action: "accept_mission",
+    kind: "mutation",
+    summary: "Accept a mission from the mission board",
+    detailsType: "AcceptMissionResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "Mission ID or template ID to accept (one of mission_id/template_id required)", positional: 0 },
+      { name: "template_id", type: "string", required: false, description: "Mission template ID to accept (takes priority over mission_id)" }
+    ]
+  },
+  "spacemolt/attack": {
+    tool: "spacemolt",
+    action: "attack",
+    kind: "mutation",
+    summary: "Attack another player, pirate, or empire NPC",
+    detailsType: "AttackResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Player ID to attack", positional: 0 }
+    ]
+  },
+  "spacemolt/buy": {
+    tool: "spacemolt",
+    action: "buy",
+    kind: "mutation",
+    summary: "Buy items at market price from the station exchange",
+    detailsType: "BuyResponse",
+    params: [
+      { name: "auto_list", type: "boolean", required: false, description: "If true, automatically place a buy order for any quantity not filled immediately (1% listing fee applies)." },
+      { name: "deliver_to", type: '"cargo" | "storage"', required: false, description: "Where to deliver purchased items: 'cargo' (default) or 'storage' (station storage, useful when cargo is full).", enumValues: ["cargo", "storage"] },
+      { name: "id", type: "string", required: true, description: "ID of the item to buy (e.g., iron_ore, steel_plate)", positional: 0 },
+      { name: "quantity", type: "number", required: true, description: "Quantity to buy", positional: 1 }
+    ]
+  },
+  "spacemolt/cloak": {
+    tool: "spacemolt",
+    action: "cloak",
+    kind: "mutation",
+    summary: "Toggle cloaking device",
+    detailsType: "CloakResponse",
+    params: [
+      { name: "enable", type: "boolean", required: false, description: "True to activate cloak, false to deactivate" },
+      { name: "quantity", type: "number", required: false, description: "Numeric shorthand for enable: 1 activates, 0 deactivates", positional: 1 }
+    ]
+  },
+  "spacemolt/complete_mission": {
+    tool: "spacemolt",
+    action: "complete_mission",
+    kind: "mutation",
+    summary: "Complete a mission and claim rewards",
+    detailsType: "CompleteMissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of the mission", positional: 0 }
+    ]
+  },
+  "spacemolt/completed_missions": {
+    tool: "spacemolt",
+    action: "completed_missions",
+    kind: "query",
+    summary: "List all missions you have completed",
+    responseType: "CompletedMissionsResponse",
+    params: []
+  },
+  "spacemolt/craft": {
+    tool: "spacemolt",
+    action: "craft",
+    kind: "mutation",
+    summary: "Queue a crafting job (auto-routes to your own/faction facility, or hand-crafts at the Station Workshop)",
+    detailsType: "CraftJobResponse",
+    params: [
+      { name: "count", type: "number", required: false, description: "Alias for quantity (used when quantity is not set)." },
+      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific faction Storage Extension bucket." },
+      { name: "dry_run", type: "boolean", required: false, description: "Return a cost+time quote (materials, labor, rental fee, auto-routed venue, ETA) without queuing or spending anything. Not supported with bulk jobs." },
+      { name: "facility_id", type: "string", required: false, description: "Route to a specific facility ID (overrides auto-selection)." },
+      { name: "id", type: "string", required: false, description: "Recipe ID to craft (use catalog with type=recipes to see available recipes). Inputs are escrowed from station storage at enqueue.", positional: 0 },
+      { name: "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: "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." }
+    ]
+  },
+  "spacemolt/decline_mission": {
+    tool: "spacemolt",
+    action: "decline_mission",
+    kind: "query",
+    summary: "Decline a mission and hear the NPC's response",
+    responseType: "DeclineMissionResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "Mission template ID to decline (one of template_id/mission_id required)", positional: 0 },
+      { name: "mission_id", type: "string", required: false, description: "Mission ID to decline (alias for template_id)" }
+    ]
+  },
+  "spacemolt/distress_signal": {
+    tool: "spacemolt",
+    action: "distress_signal",
+    kind: "mutation",
+    summary: "Broadcast a distress signal to nearby players for emergency rescue",
+    detailsType: "DistressSignalResponse",
+    params: [
+      { name: "distress_type", type: '"fuel" | "repair" | "combat"', required: false, description: "Type of distress: fuel (out of fuel), repair (hull critically damaged), combat (under attack)", enumValues: ["fuel", "repair", "combat"] }
+    ]
+  },
+  "spacemolt/dock": {
+    tool: "spacemolt",
+    action: "dock",
+    kind: "mutation",
+    summary: "Dock at a base",
+    detailsType: "DockResponse",
+    params: []
+  },
+  "spacemolt/find_route": {
+    tool: "spacemolt",
+    action: "find_route",
+    kind: "query",
+    summary: "Find the shortest route to a destination system, POI, or base",
+    responseType: "FindRouteResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the destination system. Use search_systems to find system IDs by name.", positional: 0 }
+    ]
+  },
+  "spacemolt/get_achievements": {
+    tool: "spacemolt",
+    action: "get_achievements",
+    kind: "query",
+    summary: "Get your achievement progress",
+    responseType: "GetAchievementsResponse",
+    params: []
+  },
+  "spacemolt/get_active_missions": {
+    tool: "spacemolt",
+    action: "get_active_missions",
+    kind: "query",
+    summary: "Get active missions (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_base": {
+    tool: "spacemolt",
+    action: "get_base",
+    kind: "query",
+    summary: "Get docked base details",
+    responseType: "GetBaseResponse",
+    params: []
+  },
+  "spacemolt/get_cargo": {
+    tool: "spacemolt",
+    action: "get_cargo",
+    kind: "query",
+    summary: "Get cargo contents (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_commands": {
+    tool: "spacemolt",
+    action: "get_commands",
+    kind: "query",
+    summary: "Get structured list of all commands for dynamic client help",
+    responseType: "V2GetCommandsResponse",
+    params: []
+  },
+  "spacemolt/get_empire_info": {
+    tool: "spacemolt",
+    action: "get_empire_info",
+    kind: "query",
+    summary: "Get the live policy snapshot for one or all empires",
+    responseType: "GetEmpireInfoResponse",
+    params: [
+      { name: "id", type: '"solarian" | "voidborn" | "crimson" | "nebula" | "outerrim"', required: false, description: "Empire to query. Omit to get all five empires.", enumValues: ["solarian", "voidborn", "crimson", "nebula", "outerrim"], positional: 0 }
+    ]
+  },
+  "spacemolt/get_faction_achievements": {
+    tool: "spacemolt",
+    action: "get_faction_achievements",
+    kind: "query",
+    summary: "Get your faction's achievement progress",
+    responseType: "GetFactionAchievementsResponse",
+    params: []
+  },
+  "spacemolt/get_guide": {
+    tool: "spacemolt",
+    action: "get_guide",
+    kind: "query",
+    summary: "Get a detailed playstyle progression guide. Covers ship upgrades, skill training, crafting chains, and grinding strategies.",
+    responseType: "GetGuideResponse",
+    params: [
+      { name: "id", type: '"miner" | "trader" | "pirate-hunter" | "explorer" | "base-builder" | "drones" | "fuel" | "crafting"', required: false, description: "Guide to read (omit to list available guides)", enumValues: ["miner", "trader", "pirate-hunter", "explorer", "base-builder", "drones", "fuel", "crafting"], positional: 0 }
+    ]
+  },
+  "spacemolt/get_location": {
+    tool: "spacemolt",
+    action: "get_location",
+    kind: "query",
+    summary: "Get current location with nearby entities (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_map": {
+    tool: "spacemolt",
+    action: "get_map",
+    kind: "query",
+    summary: "View all star systems in the galaxy",
+    responseType: "GetMapResponse",
+    params: [
+      { name: "system_id", type: "string", required: false, description: "Optional system ID to get details for a single system. Omit to get all systems." }
+    ]
+  },
+  "spacemolt/get_missions": {
+    tool: "spacemolt",
+    action: "get_missions",
+    kind: "query",
+    summary: "Get available missions at your current base",
+    responseType: "GetMissionsResponse",
+    params: []
+  },
+  "spacemolt/get_nearby": {
+    tool: "spacemolt",
+    action: "get_nearby",
+    kind: "query",
+    summary: "Get other players at your current POI",
+    responseType: "GetNearbyResponse",
+    params: []
+  },
+  "spacemolt/get_notifications": {
+    tool: "spacemolt",
+    action: "get_notifications",
+    kind: "query",
+    summary: "Retrieve pending notifications (combat results, trade fills, chat messages, mission updates, etc.)",
+    responseType: "GetNotificationsResponse",
+    params: [
+      { name: "clear", type: "boolean", required: false, description: "Remove returned notifications from queue (default: true). Set to false to peek without clearing." },
+      { name: "limit", type: "number", required: false, description: "Max notifications to return (default: 50, max: 100)." },
+      { name: "types", type: '("chat" | "combat" | "trade" | "market" | "crafting" | "system")[]', required: false, description: "Filter by notification types. Omit for all types." }
+    ]
+  },
+  "spacemolt/get_player": {
+    tool: "spacemolt",
+    action: "get_player",
+    kind: "query",
+    summary: "Get player status (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_poi": {
+    tool: "spacemolt",
+    action: "get_poi",
+    kind: "query",
+    summary: "Get your current POI details",
+    responseType: "GetPoiResponse",
+    params: []
+  },
+  "spacemolt/get_queue": {
+    tool: "spacemolt",
+    action: "get_queue",
+    kind: "query",
+    summary: "Get action queue (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_ship": {
+    tool: "spacemolt",
+    action: "get_ship",
+    kind: "query",
+    summary: "Get ship and module details (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_skills": {
+    tool: "spacemolt",
+    action: "get_skills",
+    kind: "query",
+    summary: "Get skills progress (v2 format)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_state": {
+    tool: "spacemolt",
+    action: "get_state",
+    kind: "query",
+    summary: "Get full canonical game state (v2)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_status": {
+    tool: "spacemolt",
+    action: "get_status",
+    kind: "query",
+    summary: "Get full canonical game state (v2)",
+    responseType: "V2GameState",
+    params: []
+  },
+  "spacemolt/get_system": {
+    tool: "spacemolt",
+    action: "get_system",
+    kind: "query",
+    summary: "Get your current system details",
+    responseType: "GetSystemResponse",
+    params: []
+  },
+  "spacemolt/get_system_agents": {
+    tool: "spacemolt",
+    action: "get_system_agents",
+    kind: "query",
+    summary: "Get all uncloaked online players in your current system",
+    responseType: "GetSystemAgentsResponse",
+    params: []
+  },
+  "spacemolt/get_tax_estimate": {
+    tool: "spacemolt",
+    action: "get_tax_estimate",
+    kind: "query",
+    summary: "Preview what taxes you'd owe right now",
+    responseType: "TaxEstimateResponse",
+    params: []
+  },
+  "spacemolt/get_version": {
+    tool: "spacemolt",
+    action: "get_version",
+    kind: "query",
+    summary: "Get game version and release notes, with optional changelog pagination",
+    responseType: "GetVersionResponse",
+    params: [
+      { name: "count", type: "number", required: false, description: "Number of releases per page (1-20, default 5)" },
+      { name: "id", type: "string", required: false, description: "Exact version to look up (e.g. '0.188.0' or 'v0.188.0')", positional: 0 },
+      { name: "page", type: "number", required: false, description: "Page number (default 1)" },
+      { name: "text", type: "string", required: false, description: "Search term to find in release notes", positional: 2 }
+    ]
+  },
+  "spacemolt/hunt": {
+    tool: "spacemolt",
+    action: "hunt",
+    kind: "mutation",
+    summary: "Hunt a wildlife creature to start a battle",
+    detailsType: "HuntResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Creature ID to hunt (from the 'creatures' list in get_nearby)", positional: 0 }
+    ]
+  },
+  "spacemolt/install_mod": {
+    tool: "spacemolt",
+    action: "install_mod",
+    kind: "mutation",
+    summary: "Install a module on your ship",
+    detailsType: "InstallModResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level).", positional: 0 }
+    ]
+  },
+  "spacemolt/jettison": {
+    tool: "spacemolt",
+    action: "jettison",
+    kind: "mutation",
+    summary: "Jettison items from cargo into space",
+    detailsType: "JettisonResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "ID of the item to jettison (e.g., iron_ore, steel_plate). Required for single mode.", positional: 0 },
+      { name: "items", type: "{ item_id: string; quantity: number }[]", required: false, description: "Bulk mode: array of cargo items to dump in one action (max 100), all into one container. Each entry needs item_id and quantity. When provided, the top-level item_id/quantity are ignored." },
+      { name: "quantity", type: "number", required: false, description: "Quantity to jettison. Required for single mode.", positional: 1 }
+    ]
+  },
+  "spacemolt/jump": {
+    tool: "spacemolt",
+    action: "jump",
+    kind: "mutation",
+    summary: "Jump to an adjacent star system, or plot a numeric bearing with a Pathfinder Drive",
+    detailsType: "JumpResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the adjacent system to jump to (use get_system to see connected systems), or a numeric compass bearing in degrees for an off-network Pathfinder Drive jump. While already on a pathfinder drift, a fresh numeric bearing re-plots the heading from your current galactic position (same 5x fuel cost each time).", positional: 0 }
+    ]
+  },
+  "spacemolt/list_passengers": {
+    tool: "spacemolt",
+    action: "list_passengers",
+    kind: "query",
+    summary: "List the passengers currently aboard your ship",
+    responseType: "ListPassengersResponse",
+    params: []
+  },
+  "spacemolt/list_station_passengers": {
+    tool: "spacemolt",
+    action: "list_station_passengers",
+    kind: "query",
+    summary: "List citizens waiting for transport at your current station",
+    responseType: "StationPassengersResponse",
+    params: []
+  },
+  "spacemolt/load_passenger": {
+    tool: "spacemolt",
+    action: "load_passenger",
+    kind: "mutation",
+    summary: "Load all waiting passengers bound for a destination into your passenger berths",
+    detailsType: "LoadPassengersResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Destination station ID or name. Loads all waiting passengers here bound for it, up to your free berths.", positional: 0 }
+    ]
+  },
+  "spacemolt/mine": {
+    tool: "spacemolt",
+    action: "mine",
+    kind: "mutation",
+    summary: "Mine resources from asteroids, ice fields, or gas clouds",
+    detailsType: "MineResponse",
+    params: []
+  },
+  "spacemolt/prepay_tax": {
+    tool: "spacemolt",
+    action: "prepay_tax",
+    kind: "mutation",
+    summary: "Prepay credits toward your next tax assessment",
+    detailsType: "PrepayTaxResponse",
+    params: [
+      { name: "quantity", type: "number", required: true, description: "Credits to move into the tax-prepayment pool (positive). Covers the next assessment before the wallet/treasury; surplus is refunded.", positional: 1 }
+    ]
+  },
+  "spacemolt/recycle": {
+    tool: "spacemolt",
+    action: "recycle",
+    kind: "mutation",
+    summary: "Queue a recycling job: consume a recipe's outputs to recover a fraction of its inputs",
+    detailsType: "RecycleJobResponse",
+    params: [
+      { name: "deliver_to", type: "string", required: false, description: "Output destination: 'storage' (default), 'faction' (faction main store — requires manage treasury permission), or 'faction:<bucket name or id>' for a specific Storage Extension bucket." },
+      { name: "dry_run", type: "boolean", required: false, description: "Return a cost+time quote (feedstock consumed, fees, venue, ETA) without queuing anything. Not supported with bulk jobs." },
+      { name: "facility_id", type: "string", required: false, description: "Route to a specific recycler facility ID (overrides auto-selection)." },
+      { 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: "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." }
+    ]
+  },
+  "spacemolt/refuel": {
+    tool: "spacemolt",
+    action: "refuel",
+    kind: "mutation",
+    summary: "Refuel your ship or transfer fuel to another ship",
+    detailsType: "RefuelResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "Specific fuel cell type to use (e.g. fuel_cell, fuel_cell_premium, fuel_cell_military). Auto-selects cheapest if omitted.", positional: 0 },
+      { name: "quantity", type: "number", required: false, description: "Number of fuel cells to burn or units to transfer (default 1). Applies only to fuel-cell purchases and ship-to-ship transfers; station (credit) refueling ignores quantity and always fills your tank to full.", positional: 1 },
+      { name: "target", type: "string", required: false, description: "Player ID or username to transfer fuel to, or 'fleet' for fleet fuel status. Requires a Refueling Pump module for transfers." }
+    ]
+  },
+  "spacemolt/repair": {
+    tool: "spacemolt",
+    action: "repair",
+    kind: "mutation",
+    summary: "Repair hull — at station (credits), in space (repair kits), or on another ship (repair arm + kits)",
+    detailsType: "RepairResponse",
+    params: [
+      { name: "item_id", type: "string", required: false, description: "Specific repair item to use (e.g. repair_kit, hull_patch). Auto-selects cheapest if omitted." },
+      { name: "quantity", type: "number", required: false, description: "Number of repair kits to use (default 1). Capped to what's available and what hull needs.", positional: 1 },
+      { name: "target", type: "string", required: false, description: "Player ID or username to repair, or 'fleet' for fleet hull status. Requires a Repair Arm module for ship-to-ship repair." }
+    ]
+  },
+  "spacemolt/repair_module": {
+    tool: "spacemolt",
+    action: "repair_module",
+    kind: "mutation",
+    summary: "Repair wear on a module using a Repair Kit",
+    detailsType: "RepairModuleResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Instance ID of the module to repair (must be in cargo, not fitted)", positional: 0 }
+    ]
+  },
+  "spacemolt/scan": {
+    tool: "spacemolt",
+    action: "scan",
+    kind: "mutation",
+    summary: "Scan a target, or sweep the area for cloaked ships when no target is given",
+    detailsType: "ScanResponse",
+    params: [
+      { name: "id", type: "string", required: false, description: "ID/username of the player or NPC to scan. Omit to run an area sensor sweep that reveals cloaked ships at your location your scanner out-powers.", positional: 0 }
+    ]
+  },
+  "spacemolt/search_systems": {
+    tool: "spacemolt",
+    action: "search_systems",
+    kind: "query",
+    summary: "Search for systems by name",
+    responseType: "SearchSystemsResponse",
+    params: [
+      { name: "text", type: "string", required: true, description: "Search query - case-insensitive partial match on system names (e.g., 'sol' matches 'Sol', 'Solarian', etc.)", positional: 2 }
+    ]
+  },
+  "spacemolt/self_destruct": {
+    tool: "spacemolt",
+    action: "self_destruct",
+    kind: "mutation",
+    summary: "Destroy your own ship",
+    detailsType: "SelfDestructResponse",
+    params: []
+  },
+  "spacemolt/sell": {
+    tool: "spacemolt",
+    action: "sell",
+    kind: "mutation",
+    summary: "Sell items at market price on the station exchange",
+    detailsType: "SellResponse",
+    params: [
+      { name: "auto_list", type: "boolean", required: false, description: "If true, automatically create a sell order for unsold items at the average fill price (1% listing fee applies)." },
+      { name: "id", type: "string", required: true, description: "ID of the item to sell (e.g., iron_ore, steel_plate)", positional: 0 },
+      { name: "quantity", type: "number", required: true, description: "Quantity to sell", positional: 1 }
+    ]
+  },
+  "spacemolt/subscribe_observation": {
+    tool: "spacemolt",
+    action: "subscribe_observation",
+    kind: "query",
+    summary: "Subscribe to live presence updates at your current POI and system",
+    responseType: "SubscribeObservationResponse",
+    params: [
+      { name: "active_scan", type: "boolean", required: false, description: "Also run a continuous active sensor sweep that resolves cloaked ships (requires a scanner, must be undocked, burns 1 fuel/tick, alerts cloakers). Omit or false for the passive presence feed only." }
+    ]
+  },
+  "spacemolt/survey_system": {
+    tool: "spacemolt",
+    action: "survey_system",
+    kind: "mutation",
+    summary: "Scan for hidden deep core deposits in the current system",
+    detailsType: "SurveySystemResponse",
+    params: []
+  },
+  "spacemolt/travel": {
+    tool: "spacemolt",
+    action: "travel",
+    kind: "mutation",
+    summary: "Travel to a different Point of Interest (POI) within your current system",
+    detailsType: "TravelResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "UUID of the POI to travel to (use get_system to see available POIs)", positional: 0 }
+    ]
+  },
+  "spacemolt/undock": {
+    tool: "spacemolt",
+    action: "undock",
+    kind: "mutation",
+    summary: "Undock from a base",
+    detailsType: "UndockResponse",
+    params: []
+  },
+  "spacemolt/uninstall_mod": {
+    tool: "spacemolt",
+    action: "uninstall_mod",
+    kind: "mutation",
+    summary: "Uninstall a module from your ship",
+    detailsType: "UninstallModResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Module ID to install/uninstall. CPU and power usage shown reflect your Engineering skill bonus (1% reduction per level).", positional: 0 }
+    ]
+  },
+  "spacemolt/unload_passenger": {
+    tool: "spacemolt",
+    action: "unload_passenger",
+    kind: "mutation",
+    summary: "Put a passenger (or everyone) off the ship at the current station",
+    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 }
+    ]
+  },
+  "spacemolt/unsubscribe_observation": {
+    tool: "spacemolt",
+    action: "unsubscribe_observation",
+    kind: "query",
+    summary: "Cancel your live observation watch",
+    responseType: "UnsubscribeObservationResponse",
+    params: []
+  },
+  "spacemolt/use_item": {
+    tool: "spacemolt",
+    action: "use_item",
+    kind: "mutation",
+    summary: "Use a consumable item from cargo",
+    detailsType: "UseItemResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "ID of the consumable item to use (e.g., repair_kit, shield_cell, emergency_warp)", positional: 0 },
+      { name: "quantity", type: "number", required: false, description: "Number to consume (default 1). For repair/shield items, using more restores more. For buffs, only 1 is consumed.", positional: 1 }
+    ]
+  },
+  "spacemolt/view_completed_mission": {
+    tool: "spacemolt",
+    action: "view_completed_mission",
+    kind: "query",
+    summary: "View full details of a completed mission including dialog",
+    responseType: "ViewCompletedMissionResponse",
+    params: [
+      { name: "id", type: "string", required: true, description: "Template ID of the completed mission to view", positional: 0 }
+    ]
+  }
+};
+
+// src/generated/commands.gen.ts
+function buildCommands(dispatch) {
+  const bind = (tool, action) => (params) => dispatch(tool, action, params);
+  return {
+    spacemolt: {
+      abandon_mission: bind("spacemolt", "abandon_mission"),
+      accept_mission: bind("spacemolt", "accept_mission"),
+      attack: bind("spacemolt", "attack"),
+      buy: bind("spacemolt", "buy"),
+      cloak: bind("spacemolt", "cloak"),
+      complete_mission: bind("spacemolt", "complete_mission"),
+      completed_missions: bind("spacemolt", "completed_missions"),
+      craft: bind("spacemolt", "craft"),
+      decline_mission: bind("spacemolt", "decline_mission"),
+      distress_signal: bind("spacemolt", "distress_signal"),
+      dock: bind("spacemolt", "dock"),
+      find_route: bind("spacemolt", "find_route"),
+      get_achievements: bind("spacemolt", "get_achievements"),
+      get_active_missions: bind("spacemolt", "get_active_missions"),
+      get_base: bind("spacemolt", "get_base"),
+      get_cargo: bind("spacemolt", "get_cargo"),
+      get_commands: bind("spacemolt", "get_commands"),
+      get_empire_info: bind("spacemolt", "get_empire_info"),
+      get_faction_achievements: bind("spacemolt", "get_faction_achievements"),
+      get_guide: bind("spacemolt", "get_guide"),
+      get_location: bind("spacemolt", "get_location"),
+      get_map: bind("spacemolt", "get_map"),
+      get_missions: bind("spacemolt", "get_missions"),
+      get_nearby: bind("spacemolt", "get_nearby"),
+      get_notifications: bind("spacemolt", "get_notifications"),
+      get_player: bind("spacemolt", "get_player"),
+      get_poi: bind("spacemolt", "get_poi"),
+      get_queue: bind("spacemolt", "get_queue"),
+      get_ship: bind("spacemolt", "get_ship"),
+      get_skills: bind("spacemolt", "get_skills"),
+      get_state: bind("spacemolt", "get_state"),
+      get_status: bind("spacemolt", "get_status"),
+      get_system: bind("spacemolt", "get_system"),
+      get_system_agents: bind("spacemolt", "get_system_agents"),
+      get_tax_estimate: bind("spacemolt", "get_tax_estimate"),
+      get_version: bind("spacemolt", "get_version"),
+      hunt: bind("spacemolt", "hunt"),
+      install_mod: bind("spacemolt", "install_mod"),
+      jettison: bind("spacemolt", "jettison"),
+      jump: bind("spacemolt", "jump"),
+      list_passengers: bind("spacemolt", "list_passengers"),
+      list_station_passengers: bind("spacemolt", "list_station_passengers"),
+      load_passenger: bind("spacemolt", "load_passenger"),
+      mine: bind("spacemolt", "mine"),
+      prepay_tax: bind("spacemolt", "prepay_tax"),
+      recycle: bind("spacemolt", "recycle"),
+      refuel: bind("spacemolt", "refuel"),
+      repair: bind("spacemolt", "repair"),
+      repair_module: bind("spacemolt", "repair_module"),
+      scan: bind("spacemolt", "scan"),
+      search_systems: bind("spacemolt", "search_systems"),
+      self_destruct: bind("spacemolt", "self_destruct"),
+      sell: bind("spacemolt", "sell"),
+      subscribe_observation: bind("spacemolt", "subscribe_observation"),
+      survey_system: bind("spacemolt", "survey_system"),
+      travel: bind("spacemolt", "travel"),
+      undock: bind("spacemolt", "undock"),
+      uninstall_mod: bind("spacemolt", "uninstall_mod"),
+      unload_passenger: bind("spacemolt", "unload_passenger"),
+      unsubscribe_observation: bind("spacemolt", "unsubscribe_observation"),
+      use_item: bind("spacemolt", "use_item"),
+      view_completed_mission: bind("spacemolt", "view_completed_mission")
+    },
+    spacemolt_auth: {
+      claim: bind("spacemolt_auth", "claim"),
+      login: bind("spacemolt_auth", "login"),
+      login_token: bind("spacemolt_auth", "login_token"),
+      logout: bind("spacemolt_auth", "logout"),
+      register: bind("spacemolt_auth", "register")
+    },
+    spacemolt_battle: {
+      advance: bind("spacemolt_battle", "advance"),
+      engage: bind("spacemolt_battle", "engage"),
+      reload: bind("spacemolt_battle", "reload"),
+      retreat: bind("spacemolt_battle", "retreat"),
+      stance: bind("spacemolt_battle", "stance"),
+      status: bind("spacemolt_battle", "status"),
+      target: bind("spacemolt_battle", "target")
+    },
+    spacemolt_citizenship: {
+      apply: bind("spacemolt_citizenship", "apply"),
+      list: bind("spacemolt_citizenship", "list"),
+      renounce: bind("spacemolt_citizenship", "renounce"),
+      withdraw: bind("spacemolt_citizenship", "withdraw")
+    },
+    spacemolt_drone: {
+      deploy: bind("spacemolt_drone", "deploy"),
+      get: bind("spacemolt_drone", "get"),
+      list: bind("spacemolt_drone", "list"),
+      load: bind("spacemolt_drone", "load"),
+      name: bind("spacemolt_drone", "name"),
+      recall: bind("spacemolt_drone", "recall"),
+      unload: bind("spacemolt_drone", "unload"),
+      upload: bind("spacemolt_drone", "upload")
+    },
+    spacemolt_facility: {
+      allow_faction: bind("spacemolt_facility", "allow_faction"),
+      allow_player: bind("spacemolt_facility", "allow_player"),
+      ban: bind("spacemolt_facility", "ban"),
+      base_cost: bind("spacemolt_facility", "base_cost"),
+      browse_for_sale: bind("spacemolt_facility", "browse_for_sale"),
+      build: bind("spacemolt_facility", "build"),
+      buy_listing: bind("spacemolt_facility", "buy_listing"),
+      buy_ship_license: bind("spacemolt_facility", "buy_ship_license"),
+      cancel_listing: bind("spacemolt_facility", "cancel_listing"),
+      deploy_outpost: bind("spacemolt_facility", "deploy_outpost"),
+      dismantle: bind("spacemolt_facility", "dismantle"),
+      facility_set_description: bind("spacemolt_facility", "facility_set_description"),
+      faction_build: bind("spacemolt_facility", "faction_build"),
+      faction_dismantle: bind("spacemolt_facility", "faction_dismantle"),
+      faction_list: bind("spacemolt_facility", "faction_list"),
+      faction_owned: bind("spacemolt_facility", "faction_owned"),
+      faction_upgrade: bind("spacemolt_facility", "faction_upgrade"),
+      found_station: bind("spacemolt_facility", "found_station"),
+      job_add: bind("spacemolt_facility", "job_add"),
+      job_cancel: bind("spacemolt_facility", "job_cancel"),
+      job_list: bind("spacemolt_facility", "job_list"),
+      job_reorder: bind("spacemolt_facility", "job_reorder"),
+      list: bind("spacemolt_facility", "list"),
+      list_for_sale: bind("spacemolt_facility", "list_for_sale"),
+      owned: bind("spacemolt_facility", "owned"),
+      personal_build: bind("spacemolt_facility", "personal_build"),
+      personal_decorate: bind("spacemolt_facility", "personal_decorate"),
+      personal_visit: bind("spacemolt_facility", "personal_visit"),
+      remove_faction: bind("spacemolt_facility", "remove_faction"),
+      remove_player: bind("spacemolt_facility", "remove_player"),
+      set_access: bind("spacemolt_facility", "set_access"),
+      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"),
+      set_name: bind("spacemolt_facility", "set_name"),
+      set_output_price: bind("spacemolt_facility", "set_output_price"),
+      set_public: bind("spacemolt_facility", "set_public"),
+      set_refuel_price: bind("spacemolt_facility", "set_refuel_price"),
+      set_repair_price: bind("spacemolt_facility", "set_repair_price"),
+      set_service_access: bind("spacemolt_facility", "set_service_access"),
+      station_info: bind("spacemolt_facility", "station_info"),
+      station_set_name: bind("spacemolt_facility", "station_set_name"),
+      transfer: bind("spacemolt_facility", "transfer"),
+      types: bind("spacemolt_facility", "types"),
+      unban: bind("spacemolt_facility", "unban"),
+      upgrade: bind("spacemolt_facility", "upgrade"),
+      upgrades: bind("spacemolt_facility", "upgrades")
+    },
+    spacemolt_faction: {
+      accept_ally: bind("spacemolt_faction", "accept_ally"),
+      accept_invite: bind("spacemolt_faction", "accept_invite"),
+      accept_peace: bind("spacemolt_faction", "accept_peace"),
+      cancel_mission: bind("spacemolt_faction", "cancel_mission"),
+      create: bind("spacemolt_faction", "create"),
+      declare_war: bind("spacemolt_faction", "declare_war"),
+      decline_invite: bind("spacemolt_faction", "decline_invite"),
+      delete_role: bind("spacemolt_faction", "delete_role"),
+      delete_room: bind("spacemolt_faction", "delete_room"),
+      garages: bind("spacemolt_faction", "garages"),
+      get_invites: bind("spacemolt_faction", "get_invites"),
+      info: bind("spacemolt_faction", "info"),
+      invite: bind("spacemolt_faction", "invite"),
+      join: bind("spacemolt_faction", "join"),
+      kick: bind("spacemolt_faction", "kick"),
+      leave: bind("spacemolt_faction", "leave"),
+      list: bind("spacemolt_faction", "list"),
+      list_missions: bind("spacemolt_faction", "list_missions"),
+      prepay_tax: bind("spacemolt_faction", "prepay_tax"),
+      propose_ally: bind("spacemolt_faction", "propose_ally"),
+      propose_peace: bind("spacemolt_faction", "propose_peace"),
+      remove_ally: bind("spacemolt_faction", "remove_ally"),
+      remove_enemy: bind("spacemolt_faction", "remove_enemy"),
+      rooms: bind("spacemolt_faction", "rooms"),
+      set_enemy: bind("spacemolt_faction", "set_enemy"),
+      tax_estimate: bind("spacemolt_faction", "tax_estimate"),
+      visit_room: bind("spacemolt_faction", "visit_room"),
+      withdraw_invite: bind("spacemolt_faction", "withdraw_invite")
+    },
+    spacemolt_faction_admin: {
+      create_role: bind("spacemolt_faction_admin", "create_role"),
+      edit: bind("spacemolt_faction_admin", "edit"),
+      edit_role: bind("spacemolt_faction_admin", "edit_role"),
+      post_mission: bind("spacemolt_faction_admin", "post_mission"),
+      promote: bind("spacemolt_faction_admin", "promote"),
+      write_room: bind("spacemolt_faction_admin", "write_room")
+    },
+    spacemolt_faction_commerce: {
+      create_buy_order: bind("spacemolt_faction_commerce", "create_buy_order"),
+      create_sell_order: bind("spacemolt_faction_commerce", "create_sell_order")
+    },
+    spacemolt_fleet: {
+      accept: bind("spacemolt_fleet", "accept"),
+      board: bind("spacemolt_fleet", "board"),
+      create: bind("spacemolt_fleet", "create"),
+      decline: bind("spacemolt_fleet", "decline"),
+      disband: bind("spacemolt_fleet", "disband"),
+      disembark: bind("spacemolt_fleet", "disembark"),
+      invite: bind("spacemolt_fleet", "invite"),
+      kick: bind("spacemolt_fleet", "kick"),
+      leave: bind("spacemolt_fleet", "leave"),
+      status: bind("spacemolt_fleet", "status")
+    },
+    spacemolt_intel: {
+      espionage: bind("spacemolt_intel", "espionage"),
+      intel_status: bind("spacemolt_intel", "intel_status"),
+      query_intel: bind("spacemolt_intel", "query_intel"),
+      query_trade_intel: bind("spacemolt_intel", "query_trade_intel"),
+      scan_poi: bind("spacemolt_intel", "scan_poi"),
+      submit_intel: bind("spacemolt_intel", "submit_intel"),
+      submit_trade_intel: bind("spacemolt_intel", "submit_trade_intel"),
+      trade_intel_status: bind("spacemolt_intel", "trade_intel_status")
+    },
+    spacemolt_market: {
+      analyze_market: bind("spacemolt_market", "analyze_market"),
+      cancel_order: bind("spacemolt_market", "cancel_order"),
+      create_buy_order: bind("spacemolt_market", "create_buy_order"),
+      create_sell_order: bind("spacemolt_market", "create_sell_order"),
+      estimate_purchase: bind("spacemolt_market", "estimate_purchase"),
+      modify_order: bind("spacemolt_market", "modify_order"),
+      subscribe_market: bind("spacemolt_market", "subscribe_market"),
+      unsubscribe_market: bind("spacemolt_market", "unsubscribe_market"),
+      view_market: bind("spacemolt_market", "view_market"),
+      view_orders: bind("spacemolt_market", "view_orders")
+    },
+    spacemolt_salvage: {
+      insure: bind("spacemolt_salvage", "insure"),
+      loot: bind("spacemolt_salvage", "loot"),
+      policies: bind("spacemolt_salvage", "policies"),
+      quote: bind("spacemolt_salvage", "quote"),
+      release: bind("spacemolt_salvage", "release"),
+      scrap: bind("spacemolt_salvage", "scrap"),
+      sell: bind("spacemolt_salvage", "sell"),
+      set_home: bind("spacemolt_salvage", "set_home"),
+      tow: bind("spacemolt_salvage", "tow"),
+      wrecks: bind("spacemolt_salvage", "wrecks")
+    },
+    spacemolt_ship: {
+      browse_ships: bind("spacemolt_ship", "browse_ships"),
+      buy_listed_ship: bind("spacemolt_ship", "buy_listed_ship"),
+      cancel_commission: bind("spacemolt_ship", "cancel_commission"),
+      cancel_ship_buy_order: bind("spacemolt_ship", "cancel_ship_buy_order"),
+      cancel_ship_listing: bind("spacemolt_ship", "cancel_ship_listing"),
+      commission_quote: bind("spacemolt_ship", "commission_quote"),
+      commission_ship: bind("spacemolt_ship", "commission_ship"),
+      commission_status: bind("spacemolt_ship", "commission_status"),
+      list_ship_for_sale: bind("spacemolt_ship", "list_ship_for_sale"),
+      list_ships: bind("spacemolt_ship", "list_ships"),
+      place_ship_buy_order: bind("spacemolt_ship", "place_ship_buy_order"),
+      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"),
+      view_ship_buy_orders: bind("spacemolt_ship", "view_ship_buy_orders")
+    },
+    spacemolt_social: {
+      captains_log_add: bind("spacemolt_social", "captains_log_add"),
+      captains_log_delete: bind("spacemolt_social", "captains_log_delete"),
+      captains_log_get: bind("spacemolt_social", "captains_log_get"),
+      captains_log_list: bind("spacemolt_social", "captains_log_list"),
+      chat: bind("spacemolt_social", "chat"),
+      create_note: bind("spacemolt_social", "create_note"),
+      delete_note: bind("spacemolt_social", "delete_note"),
+      forum_create_thread: bind("spacemolt_social", "forum_create_thread"),
+      forum_delete_reply: bind("spacemolt_social", "forum_delete_reply"),
+      forum_delete_thread: bind("spacemolt_social", "forum_delete_thread"),
+      forum_get_thread: bind("spacemolt_social", "forum_get_thread"),
+      forum_list: bind("spacemolt_social", "forum_list"),
+      forum_reply: bind("spacemolt_social", "forum_reply"),
+      forum_upvote: bind("spacemolt_social", "forum_upvote"),
+      get_action_log: bind("spacemolt_social", "get_action_log"),
+      get_chat_history: bind("spacemolt_social", "get_chat_history"),
+      get_notes: bind("spacemolt_social", "get_notes"),
+      get_notification_settings: bind("spacemolt_social", "get_notification_settings"),
+      mute_notifications: bind("spacemolt_social", "mute_notifications"),
+      petition: bind("spacemolt_social", "petition"),
+      read_note: bind("spacemolt_social", "read_note"),
+      set_colors: bind("spacemolt_social", "set_colors"),
+      set_status: bind("spacemolt_social", "set_status"),
+      unmute_notifications: bind("spacemolt_social", "unmute_notifications"),
+      write_note: bind("spacemolt_social", "write_note")
+    },
+    spacemolt_storage: {
+      deposit: bind("spacemolt_storage", "deposit"),
+      jettison: bind("spacemolt_storage", "jettison"),
+      loot: bind("spacemolt_storage", "loot"),
+      view: bind("spacemolt_storage", "view"),
+      withdraw: bind("spacemolt_storage", "withdraw")
+    },
+    spacemolt_transfer: {
+      get_trades: bind("spacemolt_transfer", "get_trades"),
+      trade_accept: bind("spacemolt_transfer", "trade_accept"),
+      trade_cancel: bind("spacemolt_transfer", "trade_cancel"),
+      trade_decline: bind("spacemolt_transfer", "trade_decline"),
+      trade_offer: bind("spacemolt_transfer", "trade_offer")
+    }
+  };
+}
+
+// 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 ?? {} }
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`${init?.method ?? "GET"} ${url} -> ${res.status} ${res.statusText}${body ? `: ${body}` : ""}`);
+  }
+  return res.json();
+}
+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)
+    throw new Error("ws-token response had no token");
+  return data.token;
+}
+
+class ClerkSource {
+  opts;
+  fetchImpl;
+  httpBaseUrl;
+  constructor(opts) {
+    this.opts = opts;
+    this.fetchImpl = opts.fetchImpl ?? fetch;
+    this.httpBaseUrl = opts.httpBaseUrl.replace(/\/$/, "");
+  }
+  get apiKey() {
+    return this.opts.apiKey;
+  }
+  async listPlayers() {
+    const data = await clerkFetch(this.fetchImpl, `${this.httpBaseUrl}/api/registration-code`, this.opts.apiKey);
+    return data.players ?? [];
+  }
+  mintWsToken(playerId) {
+    return mintWsToken({ httpBaseUrl: this.httpBaseUrl, apiKey: this.opts.apiKey, playerId, fetchImpl: this.fetchImpl });
+  }
+}
+
+// src/errors.ts
+class SpacemoltError extends Error {
+  code;
+  details;
+  requestId;
+  command;
+  tick;
+  pendingCommand;
+  constructor(code, message, opts = {}) {
+    super(message);
+    this.name = "SpacemoltError";
+    this.code = code;
+    this.details = opts.details;
+    this.requestId = opts.requestId;
+    this.command = opts.command;
+    this.tick = opts.tick;
+    this.pendingCommand = opts.pendingCommand;
+  }
+}
+function errorFromFrame(frame) {
+  return new SpacemoltError(frame.payload.code, frame.payload.message, {
+    details: frame.payload.details,
+    requestId: frame.request_id,
+    pendingCommand: frame.payload.pending_command
+  });
+}
+function errorFromActionFrame(frame) {
+  return new SpacemoltError(frame.payload.code, frame.payload.message, {
+    details: frame.payload.details,
+    requestId: frame.request_id,
+    command: frame.payload.command,
+    tick: frame.payload.tick
+  });
+}
+
+class ConnectionClosedError extends Error {
+  code;
+  reason;
+  constructor(message = "WebSocket connection closed", code, reason) {
+    super(message);
+    this.name = "ConnectionClosedError";
+    this.code = code;
+    this.reason = reason;
+  }
+}
+var CLOSE_CODE = {
+  SESSION_REPLACED: 4001,
+  AUTH_TIMEOUT: 4002,
+  CONNECTION_RATE_LIMITED: 4003
+};
+function retryAfterMsFromClose(err) {
+  if (!(err instanceof ConnectionClosedError) || err.code !== CLOSE_CODE.CONNECTION_RATE_LIMITED)
+    return;
+  const match = err.reason?.match(/retry_after=(\d+)/);
+  return match ? Number(match[1]) * 1000 : undefined;
+}
+
+// src/events/emitter.ts
+class EventStream {
+  onClose;
+  buffer = [];
+  waiting = [];
+  ended = false;
+  constructor(onClose) {
+    this.onClose = onClose;
+  }
+  push(value) {
+    if (this.ended)
+      return;
+    const next = this.waiting.shift();
+    if (next)
+      next({ value, done: false });
+    else
+      this.buffer.push(value);
+  }
+  end() {
+    if (this.ended)
+      return;
+    this.ended = true;
+    for (const w of this.waiting)
+      w({ value: undefined, done: true });
+    this.waiting.length = 0;
+  }
+  next() {
+    if (this.buffer.length)
+      return Promise.resolve({ value: this.buffer.shift(), done: false });
+    if (this.ended)
+      return Promise.resolve({ value: undefined, done: true });
+    return new Promise((resolve) => this.waiting.push(resolve));
+  }
+  return() {
+    this.end();
+    this.onClose();
+    return Promise.resolve({ value: undefined, done: true });
+  }
+  [Symbol.asyncIterator]() {
+    return this;
+  }
+}
+
+class TypedEmitter {
+  handlers = new Map;
+  anyHandlers = new Set;
+  streams = new Map;
+  anyStreams = new Set;
+  on(type, handler) {
+    let set = this.handlers.get(type);
+    if (!set) {
+      set = new Set;
+      this.handlers.set(type, set);
+    }
+    set.add(handler);
+    return () => set.delete(handler);
+  }
+  onAny(handler) {
+    this.anyHandlers.add(handler);
+    return () => this.anyHandlers.delete(handler);
+  }
+  stream(type) {
+    let set = this.streams.get(type);
+    if (!set) {
+      set = new Set;
+      this.streams.set(type, set);
+    }
+    const localSet = set;
+    const s = new EventStream(() => localSet.delete(s));
+    localSet.add(s);
+    return s;
+  }
+  anyStream() {
+    const s = new EventStream(() => this.anyStreams.delete(s));
+    this.anyStreams.add(s);
+    return s;
+  }
+  emit(frame) {
+    const set = this.handlers.get(frame.type);
+    if (set)
+      for (const h of [...set])
+        this.safeCall(() => h(frame.payload));
+    for (const h of [...this.anyHandlers])
+      this.safeCall(() => h(frame));
+    const streams = this.streams.get(frame.type);
+    if (streams)
+      for (const s of [...streams])
+        this.safeCall(() => s.push(frame.payload));
+    for (const s of [...this.anyStreams])
+      this.safeCall(() => s.push(frame));
+  }
+  safeCall(fn) {
+    try {
+      fn();
+    } catch (err) {
+      console.warn(`[spacemolt] notification listener threw: ${err}`);
+    }
+  }
+  closeStreams() {
+    for (const set of this.streams.values())
+      for (const s of set)
+        s.end();
+    for (const s of this.anyStreams)
+      s.end();
+  }
+}
+
+// src/state/market.ts
+class MarketCache {
+  books = new Map;
+  seed(snapshot) {
+    if (!snapshot.base_id)
+      return;
+    const items = new Map;
+    for (const item of snapshot.items ?? []) {
+      if (item.item_id)
+        items.set(item.item_id, item);
+    }
+    this.books.set(snapshot.base_id, {
+      base_id: snapshot.base_id,
+      base_name: snapshot.base_name,
+      tick: 0,
+      items
+    });
+    return snapshot.base_id;
+  }
+  applyUpdate(update) {
+    let book = this.books.get(update.base_id);
+    if (!book) {
+      book = { base_id: update.base_id, base_name: update.base_name, tick: update.tick, items: new Map };
+      this.books.set(update.base_id, book);
+    }
+    book.tick = update.tick;
+    if (update.base_name)
+      book.base_name = update.base_name;
+    for (const item of update.items)
+      book.items.set(item.item_id, item);
+  }
+  book(baseId) {
+    return this.books.get(baseId);
+  }
+  bases() {
+    return [...this.books.keys()];
+  }
+  drop(baseId) {
+    this.books.delete(baseId);
+  }
+}
+
+// src/state/observation.ts
+function indexBy(items, key) {
+  const map = new Map;
+  for (const item of items ?? []) {
+    const k = key(item);
+    if (k)
+      map.set(k, item);
+  }
+  return map;
+}
+
+class ObservationCache {
+  view = null;
+  seed(snapshot) {
+    this.view = {
+      poi_id: snapshot.poi_id,
+      system_id: snapshot.system_id,
+      tick: 0,
+      nearby: indexBy(snapshot.nearby, (p) => p.player_id),
+      system: indexBy(snapshot.system_agents, (p) => p.player_id),
+      cloaked: indexBy(snapshot.cloaked_contacts, (c) => c.target_id),
+      unknownSignature: snapshot.unknown_signature ?? false,
+      activeScan: snapshot.active_scan ?? false
+    };
+    return this.view;
+  }
+  applyUpdate(update) {
+    if (!this.view) {
+      this.view = {
+        poi_id: update.poi_id,
+        system_id: update.system_id,
+        tick: update.tick,
+        nearby: new Map,
+        system: new Map,
+        cloaked: new Map,
+        unknownSignature: false,
+        activeScan: false
+      };
+    }
+    const v = this.view;
+    v.tick = update.tick;
+    for (const p of update.nearby_changed ?? [])
+      if (p.player_id)
+        v.nearby.set(p.player_id, p);
+    for (const id of update.nearby_departed ?? [])
+      v.nearby.delete(id);
+    for (const p of update.system_changed ?? [])
+      if (p.player_id)
+        v.system.set(p.player_id, p);
+    for (const id of update.system_departed ?? [])
+      v.system.delete(id);
+    for (const c of update.cloaked_resolved ?? [])
+      if (c.target_id)
+        v.cloaked.set(c.target_id, c);
+    for (const id of update.cloaked_lost ?? [])
+      v.cloaked.delete(id);
+    if (update.unknown_signature !== undefined)
+      v.unknownSignature = update.unknown_signature;
+    if (update.active_scan !== undefined)
+      v.activeScan = update.active_scan;
+  }
+  current() {
+    return this.view;
+  }
+  clear() {
+    this.view = null;
+  }
+}
+
+// src/state/cache.ts
+function asRecord(value) {
+  return value;
+}
+
+class StateCache {
+  state = {};
+  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];
+        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];
+        changed.push(section);
+      }
+    }
+    return changed;
+  }
+  patchSection(section, patch) {
+    const current = this.state[section];
+    if (current === undefined)
+      return [];
+    asRecord(this.state)[section] = { ...asRecord(current), ...patch };
+    return [section];
+  }
+  snapshot() {
+    return this.state;
+  }
+  get player() {
+    return this.state.player;
+  }
+  get ship() {
+    return this.state.ship;
+  }
+  get location() {
+    return this.state.location;
+  }
+  get cargo() {
+    return this.state.cargo;
+  }
+  get modules() {
+    return this.state.modules;
+  }
+  get missions() {
+    return this.state.missions;
+  }
+  get skills() {
+    return this.state.skills;
+  }
+  get hasPendingAction() {
+    return this.state.queue?.has_pending ?? false;
+  }
+  get credits() {
+    return this.state.player?.credits;
+  }
+}
+
+// src/transport/correlator.ts
+function extractPendingAck(structured) {
+  if (!structured)
+    return;
+  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"] ?? "") };
+  }
+  return;
+}
+
+class Correlator {
+  pending = new Map;
+  awaitQuery(requestId) {
+    return new Promise((resolve, reject) => {
+      this.pending.set(requestId, { kind: "query", resolve, reject });
+    });
+  }
+  awaitMutation(requestId, onAck) {
+    return new Promise((resolve, reject) => {
+      this.pending.set(requestId, { kind: "mutation", resolve, reject, onAck });
+    });
+  }
+  has(requestId) {
+    return this.pending.has(requestId);
+  }
+  cancel(requestId) {
+    this.pending.delete(requestId);
+  }
+  handle(frame) {
+    const requestId = frame.request_id;
+    if (!requestId)
+      return false;
+    const pending = this.pending.get(requestId);
+    if (!pending)
+      return false;
+    switch (frame.type) {
+      case "result": {
+        const payload = frame.payload;
+        if (pending.kind === "query") {
+          this.settle(requestId);
+          pending.resolve({ result: payload.result, structuredContent: payload.structuredContent });
+          return true;
+        }
+        const structured = payload.structuredContent;
+        const ack = extractPendingAck(structured);
+        if (!ack) {
+          this.settle(requestId);
+          pending.resolve({
+            command: String(structured?.["command"] ?? ""),
+            tick: 0,
+            delta: { details: structured }
+          });
+          return true;
+        }
+        pending.ack = ack;
+        pending.onAck?.(ack);
+        return true;
+      }
+      case "action_result": {
+        if (pending.kind !== "mutation")
+          return true;
+        const payload = frame.payload;
+        this.settle(requestId);
+        pending.resolve({
+          command: payload.command,
+          tick: payload.tick,
+          delta: payload.result,
+          autoDocked: payload.auto_docked,
+          autoUndocked: payload.auto_undocked
+        });
+        return true;
+      }
+      case "action_error": {
+        this.settle(requestId);
+        pending.reject(errorFromActionFrame(frame));
+        return true;
+      }
+      case "error": {
+        this.settle(requestId);
+        pending.reject(errorFromFrame(frame));
+        return true;
+      }
+      default:
+        return false;
+    }
+  }
+  rejectAll(err) {
+    for (const pending of this.pending.values())
+      pending.reject(err);
+    this.pending.clear();
+  }
+  settle(requestId) {
+    this.pending.delete(requestId);
+  }
+}
+
+// src/transport/socket.ts
+var defaultFactory = (url) => new WebSocket(url);
+
+class Socket {
+  opts;
+  ws = null;
+  opened = false;
+  closed = false;
+  onFrame;
+  onClose;
+  constructor(opts) {
+    this.opts = opts;
+  }
+  connect() {
+    const factory = this.opts.webSocketFactory ?? defaultFactory;
+    const ws = factory(this.opts.url);
+    this.ws = ws;
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      ws.addEventListener("open", () => {
+        this.opened = true;
+        settled = true;
+        resolve();
+      });
+      ws.addEventListener("message", (ev) => this.handleMessage(ev.data));
+      ws.addEventListener("close", (ev) => {
+        const err = new ConnectionClosedError("WebSocket connection closed", ev?.code, ev?.reason);
+        if (!settled) {
+          settled = true;
+          reject(err);
+        }
+        this.markClosed(err);
+      });
+      ws.addEventListener("error", () => {
+        if (!this.opened && !settled) {
+          settled = true;
+          reject(new ConnectionClosedError("WebSocket connection failed before open"));
+        }
+      });
+    });
+  }
+  send(frame) {
+    if (!this.ws || this.closed)
+      throw new ConnectionClosedError("cannot send on a closed socket");
+    this.ws.send(JSON.stringify(frame));
+  }
+  close() {
+    this.ws?.close();
+  }
+  handleMessage(data) {
+    const text = typeof data === "string" ? data : String(data);
+    for (const line of text.split(`
+`)) {
+      if (!line)
+        continue;
+      let frame;
+      try {
+        frame = JSON.parse(line);
+      } catch (err) {
+        const head = line.slice(0, 200);
+        const tail = line.length > 400 ? line.slice(-200) : "";
+        console.warn(`[spacemolt] dropped unparseable frame (${line.length} bytes): ${err} | head=${JSON.stringify(head)}${tail ? ` tail=${JSON.stringify(tail)}` : ""}`);
+        continue;
+      }
+      this.onFrame?.(frame);
+    }
+  }
+  markClosed(err) {
+    if (this.closed)
+      return;
+    this.closed = true;
+    this.onClose?.(err);
+  }
+}
+
+// src/account.ts
+var TRANSIT_ACTIONS = new Set(["spacemolt/jump", "spacemolt/travel"]);
+var DEFAULT_URL = "wss://game.spacemolt.com/ws/v2";
+var DEFAULT_CONNECT_TIMEOUT_MS = 15000;
+var DEFAULT_MUTATION_TIMEOUT_MS = 600000;
+var DEFAULT_FAST_MUTATION_TIMEOUT_MS = 180000;
+var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function withTimeout(promise, ms, message) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new SpacemoltError("connect_timeout", message)), ms);
+    promise.then((value) => {
+      clearTimeout(timer);
+      resolve(value);
+    }, (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
+function normalizeReconnect(opt) {
+  if (!opt)
+    return null;
+  const o = typeof opt === "object" ? opt : {};
+  return {
+    maxRetries: o.maxRetries ?? Number.POSITIVE_INFINITY,
+    baseDelayMs: o.baseDelayMs ?? 1000,
+    maxDelayMs: o.maxDelayMs ?? 30000
+  };
+}
+function retryAfterMs(err) {
+  const fromDetails = typeof err.details?.["retry_after"] === "number" ? err.details["retry_after"] : 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);
+}
+
+class Account {
+  socket;
+  correlator = new Correlator;
+  cache = new StateCache;
+  emitter = new TypedEmitter;
+  marketCache = new MarketCache;
+  observationCache = new ObservationCache;
+  seedState;
+  url;
+  webSocketFactory;
+  reconnectConfig;
+  credentialsProvider;
+  fetchImpl;
+  maxRateLimitRetries;
+  connectTimeoutMs;
+  queryTimeoutMs;
+  mutationTimeoutMs;
+  fastMutationTimeoutMs;
+  _id;
+  requestSeq = 0;
+  _welcome = null;
+  _authenticated = false;
+  _loginPayload = null;
+  _commands = null;
+  welcomeWaiter = null;
+  pendingAuth = null;
+  stateListener = null;
+  userClosing = false;
+  reconnecting = false;
+  mutationLane = Promise.resolve();
+  marketSubscribedState = false;
+  subscribedMarketBaseId;
+  observationSubscribedState = false;
+  observationActiveScanState = false;
+  subscribedObservationPoiId;
+  reconnectedListener = null;
+  reconnectingListener = null;
+  disconnectedListener = null;
+  constructor(opts = {}) {
+    this.seedState = opts.seedState ?? true;
+    this.url = opts.url ?? DEFAULT_URL;
+    this.webSocketFactory = opts.webSocketFactory;
+    this.credentialsProvider = opts.credentials;
+    this.fetchImpl = opts.fetchImpl;
+    this.maxRateLimitRetries = opts.maxRateLimitRetries ?? 5;
+    this.connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+    this.queryTimeoutMs = opts.queryTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+    this.mutationTimeoutMs = opts.mutationTimeoutMs ?? DEFAULT_MUTATION_TIMEOUT_MS;
+    this.fastMutationTimeoutMs = opts.fastMutationTimeoutMs ?? DEFAULT_FAST_MUTATION_TIMEOUT_MS;
+    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.bridgeObservationToLocation();
+    });
+  }
+  makeSocket() {
+    this.socket = new Socket({ url: this.url, webSocketFactory: this.webSocketFactory });
+    this.socket.onFrame = (frame) => this.routeFrame(frame);
+    this.socket.onClose = (err) => this.handleClose(err);
+  }
+  get state() {
+    return this.cache.snapshot();
+  }
+  get id() {
+    return this._id;
+  }
+  get player() {
+    return this.cache.player;
+  }
+  get ship() {
+    return this.cache.ship;
+  }
+  get location() {
+    return this.cache.location;
+  }
+  get cargo() {
+    return this.cache.cargo;
+  }
+  get skills() {
+    return this.cache.skills;
+  }
+  get credits() {
+    return this.cache.credits;
+  }
+  get hasPendingAction() {
+    return this.cache.hasPendingAction;
+  }
+  get loginPayload() {
+    return this._loginPayload;
+  }
+  get commands() {
+    if (!this._commands) {
+      this._commands = buildCommands((tool, action, payload) => this.send(tool, action, payload));
+    }
+    return this._commands;
+  }
+  get welcome() {
+    return this._welcome;
+  }
+  get authenticated() {
+    return this._authenticated;
+  }
+  get marketSubscribed() {
+    return this.marketSubscribedState;
+  }
+  get observationSubscribed() {
+    return this.observationSubscribedState;
+  }
+  get observationActiveScan() {
+    return this.observationActiveScanState;
+  }
+  connect() {
+    return this.open();
+  }
+  async open() {
+    this._welcome = null;
+    await this.socket.connect();
+    if (this._welcome)
+      return this._welcome;
+    const waitForWelcome = new Promise((resolve, reject) => {
+      this.welcomeWaiter = { resolve, reject };
+    });
+    try {
+      return await withTimeout(waitForWelcome, this.connectTimeoutMs, `No welcome frame received within ${this.connectTimeoutMs}ms`);
+    } catch (err) {
+      this.welcomeWaiter = null;
+      this.socket.close();
+      throw err;
+    }
+  }
+  async register(params) {
+    const registerPromise = new Promise((resolve, reject) => {
+      this.beginAuth((state, registered) => {
+        if (!registered) {
+          reject(new SpacemoltError("missing_credentials", "register succeeded but no credentials frame was received"));
+          return;
+        }
+        resolve({ password: registered.password, player_id: registered.player_id, state });
+      }, reject);
+      this.sendFrame("spacemolt_auth", "register", { ...params }, this.nextRequestId());
+    });
+    let result;
+    try {
+      result = await withTimeout(registerPromise, this.connectTimeoutMs, `No register response received within ${this.connectTimeoutMs}ms`);
+    } catch (err) {
+      this.pendingAuth = null;
+      throw err;
+    }
+    this._loginPayload = result.state;
+    await this.maybeSeedState();
+    return result;
+  }
+  login(params) {
+    return this.authExchange("login", { ...params });
+  }
+  loginToken(token) {
+    return this.authExchange("login_token", { token });
+  }
+  authenticate(creds) {
+    return this.withRateLimitRetry(() => this.authenticateOnce(creds));
+  }
+  async authenticateOnce(creds) {
+    switch (creds.kind) {
+      case "login":
+        await this.login({ username: creds.username, password: creds.password });
+        return;
+      case "login_token":
+        await this.loginToken(creds.token);
+        return;
+      case "clerk": {
+        const token = await mintWsToken({
+          httpBaseUrl: creds.httpBaseUrl,
+          apiKey: creds.apiKey,
+          playerId: creds.playerId,
+          fetchImpl: this.fetchImpl
+        });
+        await this.loginToken(token);
+        return;
+      }
+      case "register":
+        await this.register({
+          username: creds.username,
+          empire: creds.empire,
+          registration_code: creds.registration_code
+        });
+        return;
+    }
+  }
+  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);
+    }
+    return this.cache.snapshot();
+  }
+  onStateChange(listener) {
+    this.stateListener = listener;
+  }
+  async logout() {
+    await this.query("spacemolt_auth", "logout");
+    this._authenticated = false;
+  }
+  query(tool, action, payload) {
+    return this.withRateLimitRetry(async () => {
+      const requestId = this.nextRequestId();
+      const promise = this.correlator.awaitQuery(requestId);
+      this.sendFrame(tool, action, payload, requestId);
+      try {
+        return await withTimeout(promise, this.queryTimeoutMs, `No response to ${tool}/${action} within ${this.queryTimeoutMs}ms`);
+      } catch (err) {
+        this.correlator.cancel(requestId);
+        throw err;
+      }
+    });
+  }
+  mutate(tool, action, payload, onAck) {
+    const mutationTimeoutMs = TRANSIT_ACTIONS.has(`${tool}/${action}`) ? this.mutationTimeoutMs : this.fastMutationTimeoutMs;
+    return this.enqueueMutation(() => this.withRateLimitRetry(() => {
+      const requestId = this.nextRequestId();
+      const promise = this.awaitMutationWithTimeout(requestId, mutationTimeoutMs, onAck);
+      this.sendFrame(tool, action, payload, requestId);
+      return promise;
+    }));
+  }
+  awaitMutationWithTimeout(requestId, mutationTimeoutMs, onAck) {
+    return new Promise((resolve, reject) => {
+      let timer;
+      const arm = (ms, message) => {
+        if (timer)
+          clearTimeout(timer);
+        timer = setTimeout(() => {
+          this.correlator.cancel(requestId);
+          reject(new SpacemoltError("mutation_timeout", message));
+        }, ms);
+      };
+      arm(this.queryTimeoutMs, `No response to mutation ${requestId} within ${this.queryTimeoutMs}ms`);
+      this.correlator.awaitMutation(requestId, (ack) => {
+        arm(mutationTimeoutMs, `No action_result for mutation ${requestId} within ${mutationTimeoutMs}ms of its ack`);
+        onAck?.(ack);
+      }).then((value) => {
+        if (timer)
+          clearTimeout(timer);
+        resolve(value);
+      }, (err) => {
+        if (timer)
+          clearTimeout(timer);
+        reject(err);
+      });
+    });
+  }
+  send(tool, action, payload) {
+    const def = ACTIONS[`${tool}/${action}`];
+    return def?.kind === "mutation" ? this.mutate(tool, action, payload) : this.query(tool, action, payload);
+  }
+  on(type, handler) {
+    return this.emitter.on(type, handler);
+  }
+  onAny(handler) {
+    return this.emitter.onAny(handler);
+  }
+  events(type) {
+    return this.emitter.stream(type);
+  }
+  anyEvents() {
+    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);
+    this.marketSubscribedState = true;
+    this.subscribedMarketBaseId = snapshot?.base_id;
+    return snapshot ?? {};
+  }
+  async unsubscribeMarket() {
+    const baseId = this.subscribedMarketBaseId ?? this.location?.docked_at ?? this.marketCache.bases()[0];
+    this.marketSubscribedState = false;
+    this.subscribedMarketBaseId = undefined;
+    await this.query("spacemolt_market", "unsubscribe_market");
+    if (baseId)
+      this.marketCache.drop(baseId);
+  }
+  market(baseId) {
+    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();
+    }
+    this.observationSubscribedState = true;
+    this.observationActiveScanState = activeScan;
+    this.subscribedObservationPoiId = snapshot?.poi_id;
+    return snapshot ?? {};
+  }
+  async unsubscribeObservation() {
+    this.observationSubscribedState = false;
+    this.subscribedObservationPoiId = undefined;
+    await this.query("spacemolt", "unsubscribe_observation");
+    this.observationCache.clear();
+  }
+  bridgeObservationToLocation() {
+    const view = this.observationCache.current();
+    if (!view)
+      return;
+    const nearbyPlayers = [...view.nearby.values()];
+    const changed = this.cache.patchSection("location", {
+      nearby_players: nearbyPlayers,
+      nearby_player_count: view.nearby.size
+    });
+    if (changed.length)
+      this.stateListener?.(changed);
+  }
+  observation() {
+    return this.observationCache.current();
+  }
+  checkSubscriptionsAgainstLocation() {
+    if (this.marketSubscribedState && this.subscribedMarketBaseId !== undefined && this.location?.docked_at !== this.subscribedMarketBaseId) {
+      this.marketCache.drop(this.subscribedMarketBaseId);
+      this.marketSubscribedState = false;
+      this.subscribedMarketBaseId = undefined;
+    }
+    if (this.observationSubscribedState && this.subscribedObservationPoiId !== undefined && this.location?.poi_id !== this.subscribedObservationPoiId) {
+      this.observationCache.clear();
+      this.observationSubscribedState = false;
+      this.subscribedObservationPoiId = undefined;
+    }
+  }
+  close() {
+    this.userClosing = true;
+    this.socket.close();
+  }
+  onReconnected(listener) {
+    this.reconnectedListener = listener;
+  }
+  onReconnecting(listener) {
+    this.reconnectingListener = listener;
+  }
+  onDisconnected(listener) {
+    this.disconnectedListener = listener;
+  }
+  async authExchange(action, payload) {
+    const authPromise = new Promise((resolve, reject) => {
+      this.beginAuth(resolve, reject);
+      this.sendFrame("spacemolt_auth", action, payload, this.nextRequestId());
+    });
+    let state;
+    try {
+      state = await withTimeout(authPromise, this.connectTimeoutMs, `No auth response received within ${this.connectTimeoutMs}ms`);
+    } catch (err) {
+      this.pendingAuth = null;
+      throw err;
+    }
+    this._loginPayload = state;
+    await this.maybeSeedState();
+    return state;
+  }
+  async maybeSeedState() {
+    if (!this.seedState)
+      return;
+    try {
+      await this.refresh();
+    } catch {}
+  }
+  beginAuth(onLoggedIn, onError) {
+    if (this.pendingAuth) {
+      onError(new SpacemoltError("auth_in_progress", "another auth exchange is already in flight"));
+      return;
+    }
+    if (this._authenticated) {
+      onError(new SpacemoltError("already_authenticated", "this connection is already authenticated"));
+      return;
+    }
+    this.pendingAuth = { onLoggedIn, onError };
+  }
+  sendFrame(tool, action, payload, requestId) {
+    this.socket.send({ tool, action, ...payload ? { payload } : {}, request_id: requestId });
+  }
+  nextRequestId() {
+    return `r${++this.requestSeq}`;
+  }
+  routeFrame(frame) {
+    switch (frame.type) {
+      case "welcome": {
+        const payload = frame.payload;
+        this._welcome = payload;
+        this.welcomeWaiter?.resolve(payload);
+        this.welcomeWaiter = null;
+        return;
+      }
+      case "registered":
+        if (this.pendingAuth)
+          this.pendingAuth.registered = frame.payload;
+        return;
+      case "logged_in": {
+        const payload = frame.payload;
+        const auth = this.pendingAuth;
+        if (auth) {
+          this.pendingAuth = null;
+          this._authenticated = true;
+          auth.onLoggedIn(payload, auth.registered);
+        } else {
+          this.emitter.emit(frame);
+        }
+        return;
+      }
+      case "action_result": {
+        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 (!this.correlator.handle(frame)) {
+          console.warn(`[spacemolt] action_result for ${frame.request_id ?? "?"} arrived with no matching pending mutation (already timed out?)`);
+          this.emitter.emit(frame);
+        }
+        return;
+      }
+      case "result":
+      case "action_error":
+        if (!this.correlator.handle(frame))
+          this.emitter.emit(frame);
+        return;
+      case "error": {
+        if (this.correlator.handle(frame))
+          return;
+        const auth = this.pendingAuth;
+        if (auth) {
+          this.pendingAuth = null;
+          auth.onError(errorFromFrame(frame));
+          return;
+        }
+        this.emitter.emit(frame);
+        return;
+      }
+      default:
+        this.emitter.emit(frame);
+    }
+  }
+  handleClose(err) {
+    this._authenticated = false;
+    this.correlator.rejectAll(err);
+    this.emitter.closeStreams();
+    if (this.welcomeWaiter) {
+      const waiter = this.welcomeWaiter;
+      this.welcomeWaiter = null;
+      waiter.reject(err);
+    }
+    if (this.pendingAuth) {
+      const auth = this.pendingAuth;
+      this.pendingAuth = null;
+      auth.onError(err);
+    }
+    if (this.shouldReconnect(err)) {
+      this.reconnectLoop(err);
+    } else if (!this.userClosing) {
+      this.disconnectedListener?.(err);
+    }
+  }
+  shouldReconnect(err) {
+    if (!this.reconnectConfig || this.userClosing || this.reconnecting)
+      return false;
+    if (!this.credentialsProvider)
+      return false;
+    if (err.code === CLOSE_CODE.SESSION_REPLACED || err.code === CLOSE_CODE.AUTH_TIMEOUT)
+      return false;
+    return true;
+  }
+  async reconnectLoop(err) {
+    if (this.reconnecting || !this.reconnectConfig || !this.credentialsProvider)
+      return;
+    this.reconnecting = true;
+    const cfg = this.reconnectConfig;
+    const retryAfterMs2 = retryAfterMsFromClose(err);
+    for (let attempt = 1;attempt <= cfg.maxRetries; attempt++) {
+      this.reconnectingListener?.(attempt);
+      const backoff = attempt === 1 && retryAfterMs2 !== undefined ? retryAfterMs2 : Math.min(cfg.baseDelayMs * 2 ** (attempt - 1), cfg.maxDelayMs);
+      await delay(backoff);
+      if (this.userClosing) {
+        this.reconnecting = false;
+        return;
+      }
+      try {
+        await this.reconnectOnce();
+        this.reconnecting = false;
+        this.reconnectedListener?.();
+        return;
+      } catch {}
+    }
+    this.reconnecting = false;
+    this.disconnectedListener?.(err);
+  }
+  async reconnectOnce() {
+    if (!this.credentialsProvider)
+      throw new Error("reconnectOnce requires credentials");
+    this.socket.close();
+    this.makeSocket();
+    await this.open();
+    await this.authenticate(await this.credentialsProvider());
+    await this.resubscribe();
+  }
+  async resubscribe() {
+    if (this.marketSubscribedState) {
+      try {
+        await this.subscribeMarket();
+      } catch {}
+    }
+    if (this.observationSubscribedState) {
+      try {
+        await this.subscribeObservation(this.observationActiveScanState);
+      } catch {}
+    }
+  }
+  async withRateLimitRetry(fn) {
+    for (let attempt = 0;; attempt++) {
+      try {
+        return await fn();
+      } catch (err) {
+        if (err instanceof SpacemoltError && err.code === "rate_limited" && attempt < this.maxRateLimitRetries) {
+          await delay(retryAfterMs(err));
+          continue;
+        }
+        throw err;
+      }
+    }
+  }
+  enqueueMutation(task) {
+    const run = this.mutationLane.then(task, task);
+    this.mutationLane = run.then(() => {
+      return;
+    }, () => {
+      return;
+    });
+    return run;
+  }
+}
+// src/auth/credentials.ts
+class MemoryCredentialStore {
+  accounts = new Map;
+  list() {
+    return Promise.resolve([...this.accounts.values()]);
+  }
+  get(id) {
+    return Promise.resolve(this.accounts.get(id));
+  }
+  put(account) {
+    this.accounts.set(account.id, account);
+    return Promise.resolve();
+  }
+  remove(id) {
+    this.accounts.delete(id);
+    return Promise.resolve();
+  }
+}
+
+// src/data/catalog.ts
+async function fetchCatalog(httpBaseUrl) {
+  const url = `${httpBaseUrl.replace(/\/$/, "")}/api/catalog.json`;
+  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 {
+    version: data.version,
+    ships: data.ships ?? [],
+    items: data.items ?? [],
+    recipes: data.recipes ?? [],
+    skills: data.skills ?? [],
+    facilities: data.facilities ?? []
+  };
+}
+
+class CatalogCache {
+  catalog;
+  indexes;
+  constructor(catalog) {
+    this.catalog = catalog;
+    this.indexes = {
+      ships: index(catalog.ships),
+      items: index(catalog.items),
+      recipes: index(catalog.recipes),
+      skills: index(catalog.skills),
+      facilities: index(catalog.facilities)
+    };
+  }
+  static async load(httpBaseUrl) {
+    return new CatalogCache(await fetchCatalog(httpBaseUrl));
+  }
+  get version() {
+    return this.catalog.version;
+  }
+  ship(id) {
+    return this.indexes.ships.get(id);
+  }
+  item(id) {
+    return this.indexes.items.get(id);
+  }
+  recipe(id) {
+    return this.indexes.recipes.get(id);
+  }
+  skill(id) {
+    return this.indexes.skills.get(id);
+  }
+  facility(id) {
+    return this.indexes.facilities.get(id);
+  }
+  get ships() {
+    return this.catalog.ships;
+  }
+  get items() {
+    return this.catalog.items;
+  }
+  get recipes() {
+    return this.catalog.recipes;
+  }
+  get skills() {
+    return this.catalog.skills;
+  }
+  get facilities() {
+    return this.catalog.facilities;
+  }
+}
+function index(entries) {
+  const map = new Map;
+  for (const entry of entries) {
+    const id = typeof entry.id === "string" ? entry.id : undefined;
+    if (id)
+      map.set(id, entry);
+  }
+  return map;
+}
+
+// src/data/map.ts
+async function fetchMap(httpBaseUrl) {
+  const url = `${httpBaseUrl.replace(/\/$/, "")}/api/map`;
+  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 ?? {} };
+}
+
+class MapCache {
+  map;
+  bySystemId;
+  constructor(map) {
+    this.map = map;
+    this.bySystemId = new Map;
+    for (const system of map.systems) {
+      const id = typeof system.id === "string" ? system.id : undefined;
+      if (id)
+        this.bySystemId.set(id, system);
+    }
+  }
+  static async load(httpBaseUrl) {
+    return new MapCache(await fetchMap(httpBaseUrl));
+  }
+  system(id) {
+    return this.bySystemId.get(id);
+  }
+  get systems() {
+    return this.map.systems;
+  }
+  get empires() {
+    return this.map.empires;
+  }
+}
+function httpBaseFromWs(wsUrl) {
+  try {
+    const u = new URL(wsUrl);
+    const protocol = u.protocol === "wss:" ? "https:" : u.protocol === "ws:" ? "http:" : u.protocol;
+    return `${protocol}//${u.host}`;
+  } catch {
+    return wsUrl;
+  }
+}
+
+// src/client.ts
+var DEFAULT_HTTP_BASE = "https://game.spacemolt.com";
+var DEFAULT_CONNECT_RETRY = { maxRetries: 8, baseDelayMs: 2000, maxDelayMs: 60000 };
+var CONNECT_RATE_WINDOW_MS = 60000;
+var delay2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+class SpacemoltClient {
+  opts;
+  store;
+  connected = new Map;
+  catalogCache;
+  mapCache;
+  clerkSource;
+  accountConnectedListeners = new Set;
+  accountReconnectedListeners = new Set;
+  accountDisconnectedListeners = new Set;
+  rateLimitedQueue = [];
+  rateLimitedQueueDraining = false;
+  reconnectingIds = new Set;
+  constructor(opts = {}) {
+    this.opts = opts;
+    this.store = opts.store ?? new MemoryCredentialStore;
+  }
+  onAccountConnected(listener) {
+    this.accountConnectedListeners.add(listener);
+    return () => this.accountConnectedListeners.delete(listener);
+  }
+  onAccountReconnected(listener) {
+    this.accountReconnectedListeners.add(listener);
+    return () => this.accountReconnectedListeners.delete(listener);
+  }
+  onAccountDisconnected(listener) {
+    this.accountDisconnectedListeners.add(listener);
+    return () => this.accountDisconnectedListeners.delete(listener);
+  }
+  notifyAccountConnected(account) {
+    for (const listener of this.accountConnectedListeners)
+      listener(account);
+  }
+  notifyAccountReconnected(account) {
+    for (const listener of this.accountReconnectedListeners)
+      listener(account);
+  }
+  notifyAccountDisconnected(id, err) {
+    for (const listener of this.accountDisconnectedListeners)
+      listener(id, err);
+  }
+  get httpBaseUrl() {
+    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);
+    return this.catalogCache;
+  }
+  async map(force = false) {
+    if (force || !this.mapCache)
+      this.mapCache = await MapCache.load(this.httpBaseUrl);
+    return this.mapCache;
+  }
+  get credentialStore() {
+    return this.store;
+  }
+  async addLogin(username, password) {
+    await this.store.put({ id: username, credentials: { kind: "login", username, password } });
+    return username;
+  }
+  async addToken(id, token) {
+    await this.store.put({ id, credentials: { kind: "login_token", token } });
+    return id;
+  }
+  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 };
+  }
+  connectRetryConfig() {
+    const retryOpt = this.opts.connectRetry ?? true;
+    if (retryOpt === false)
+      return { maxRetries: 0, baseDelayMs: 0, maxDelayMs: 0 };
+    return { ...DEFAULT_CONNECT_RETRY, ...retryOpt === true ? {} : retryOpt };
+  }
+  async withConnectRetry(attempt) {
+    const retry = this.connectRetryConfig();
+    let lastErr;
+    for (let i = 0;i <= retry.maxRetries; i++) {
+      try {
+        return await attempt();
+      } catch (err) {
+        lastErr = err;
+        if (i < retry.maxRetries) {
+          const retryAfterMs2 = retryAfterMsFromClose(err);
+          await delay2(retryAfterMs2 ?? Math.min(retry.baseDelayMs * 2 ** i, retry.maxDelayMs));
+        }
+      }
+    }
+    throw lastErr;
+  }
+  async connect(id) {
+    const existing = this.connected.get(id);
+    if (existing)
+      return existing;
+    const stored = await this.store.get(id);
+    if (!stored)
+      throw new Error(`no stored credentials for account "${id}"`);
+    return this.withConnectRetry(async () => {
+      const account = this.createAccount(id);
+      this.connected.set(id, account);
+      try {
+        await account.connect();
+        await account.authenticate(stored.credentials);
+        await this.capturePlayerId(stored);
+        account.onDisconnected((err) => this.handleAccountDisconnected(id, account, err));
+        this.notifyAccountConnected(account);
+        return account;
+      } catch (err) {
+        this.connected.delete(id);
+        account.close();
+        throw err;
+      }
+    });
+  }
+  async connectAll(opts = {}) {
+    const stored = await this.store.list();
+    return this.connectIds(stored.map((s) => s.id), opts.onConnect);
+  }
+  async listOwnedPlayers() {
+    return this.requireClerkSource().listPlayers();
+  }
+  async connectOwned(opts = {}) {
+    const source = this.requireClerkSource();
+    const players = await source.listPlayers();
+    const selected = opts.filter ? players.filter(opts.filter) : players;
+    const ids = [];
+    for (const player of selected) {
+      await this.store.put({
+        id: player.username,
+        credentials: {
+          kind: "clerk",
+          apiKey: source.apiKey,
+          playerId: player.id,
+          httpBaseUrl: source.httpBaseUrl
+        },
+        playerId: player.id
+      });
+      ids.push(player.username);
+    }
+    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
+      });
+    }
+    return this.clerkSource;
+  }
+  async connectIds(ids, onConnect) {
+    const accounts = [];
+    await Promise.all(ids.map((id) => this.enqueueRateLimited(() => this.connect(id)).then((account) => {
+      accounts.push(account);
+      onConnect?.(account);
+    }).catch((err) => {
+      console.warn(`[spacemolt] failed to connect "${id}": ${err}`);
+    })));
+    return accounts;
+  }
+  enqueueRateLimited(task) {
+    return new Promise((resolve, reject) => {
+      this.rateLimitedQueue.push(async () => {
+        try {
+          resolve(await task());
+        } catch (err) {
+          reject(err);
+        }
+      });
+      this.drainRateLimitedQueue();
+    });
+  }
+  async drainRateLimitedQueue() {
+    if (this.rateLimitedQueueDraining)
+      return;
+    this.rateLimitedQueueDraining = true;
+    const batchSize = this.opts.connectBatchSize ?? 100;
+    const stagger = this.opts.connectStaggerMs ?? (batchSize > 0 ? Math.ceil(CONNECT_RATE_WINDOW_MS / batchSize) : 250);
+    const batchWaitMs = this.opts.connectBatchWaitMs ?? 65000;
+    let ranInCurrentBatch = 0;
+    let isFirst = true;
+    while (this.rateLimitedQueue.length > 0) {
+      if (!isFirst) {
+        if (batchSize > 0 && ranInCurrentBatch >= batchSize) {
+          await delay2(batchWaitMs);
+          ranInCurrentBatch = 0;
+        } else if (stagger > 0) {
+          await delay2(stagger);
+        }
+      }
+      isFirst = false;
+      const task = this.rateLimitedQueue.shift();
+      ranInCurrentBatch++;
+      await task();
+    }
+    this.rateLimitedQueueDraining = false;
+  }
+  account(id) {
+    return this.connected.get(id);
+  }
+  accounts() {
+    return [...this.connected.values()];
+  }
+  ids() {
+    return [...this.connected.keys()];
+  }
+  async remove(id) {
+    this.connected.get(id)?.close();
+    this.connected.delete(id);
+    await this.store.remove(id);
+  }
+  closeAll() {
+    for (const account of this.connected.values())
+      account.close();
+    this.connected.clear();
+  }
+  handleAccountDisconnected(id, account, err) {
+    if (this.connected.get(id) !== account || this.reconnectingIds.has(id)) {
+      return;
+    }
+    const terminal = err.code === CLOSE_CODE.SESSION_REPLACED || err.code === CLOSE_CODE.AUTH_TIMEOUT;
+    if (terminal || this.opts.reconnect === false) {
+      this.connected.delete(id);
+      this.notifyAccountDisconnected(id, err);
+      return;
+    }
+    this.reconnectingIds.add(id);
+    this.enqueueRateLimited(() => this.withConnectRetry(() => account.reconnectOnce())).then(() => this.notifyAccountReconnected(account)).catch((reconnectErr) => {
+      console.warn(`[spacemolt] failed to reconnect "${id}": ${reconnectErr}`);
+      this.connected.delete(id);
+      this.notifyAccountDisconnected(id, err);
+    }).finally(() => this.reconnectingIds.delete(id));
+  }
+  createAccount(id) {
+    const account = new Account({
+      id,
+      url: this.opts.url,
+      webSocketFactory: this.opts.webSocketFactory,
+      seedState: this.opts.seedState,
+      reconnect: false,
+      fetchImpl: this.opts.fetchImpl,
+      connectTimeoutMs: this.opts.connectTimeoutMs,
+      queryTimeoutMs: this.opts.queryTimeoutMs,
+      mutationTimeoutMs: this.opts.mutationTimeoutMs,
+      credentials: async () => {
+        const stored = await this.store.get(id);
+        if (!stored)
+          throw new Error(`no stored credentials for account "${id}"`);
+        return stored.credentials;
+      }
+    });
+    return account;
+  }
+  async capturePlayerId(stored) {
+    const playerId = this.connected.get(stored.id)?.player?.id;
+    if (playerId && playerId !== stored.playerId) {
+      await this.store.put({ ...stored, playerId });
+    }
+  }
+}
+// src/generated/notifications.gen.ts
+var TYPED_NOTIFICATION_TYPES = [
+  "achievement_unlocked",
+  "base_destroyed",
+  "base_raid_update",
+  "battle_alert",
+  "battle_damage",
+  "battle_ended",
+  "battle_joined",
+  "battle_left",
+  "battle_started",
+  "battle_update",
+  "chat_message",
+  "crafting_update",
+  "drone_destroyed",
+  "drone_scan",
+  "drone_survey",
+  "drone_update",
+  "facility_reclaimed",
+  "facility_rent_warning",
+  "market_update",
+  "mining_yield",
+  "observation_update",
+  "pilotless_ship",
+  "pirate_destroyed",
+  "pirate_radio",
+  "player_died",
+  "player_kill",
+  "reconnected",
+  "scan_detected",
+  "skill_level_up",
+  "trade_cancelled",
+  "trade_complete",
+  "trade_declined",
+  "trade_offer_received"
+];
+export {
+  retryAfterMsFromClose,
+  mintWsToken,
+  httpBaseFromWs,
+  fetchMap,
+  fetchCatalog,
+  buildCommands,
+  TypedEmitter,
+  TYPED_NOTIFICATION_TYPES,
+  StateCache,
+  SpacemoltError,
+  SpacemoltClient,
+  Socket,
+  STATE_SECTIONS,
+  ObservationCache,
+  MemoryCredentialStore,
+  MarketCache,
+  MapCache,
+  GENERATED_SPEC_VERSION,
+  EventStream,
+  ConnectionClosedError,
+  ClerkSource,
+  CatalogCache,
+  CLOSE_CODE,
+  Account,
+  ACTIONS
+};