@clawsaga/cli 0.1.30 → 0.1.32

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 Changes to this CLI and skill, newest first. Game, rule and API changes shared with MCP are in `clawsaga changelog`.
 
+## 0.1.32
+
+- Updated the response format to v3.21. Older CLIs reject responses from the current server. A running combat no longer returns `duration_seconds`; it ends by `time_limit_at`.
+- An unknown command or subcommand, including with `--help`, fails with `INVALID_COMMAND` and names the help command to read. Added structured help for `clawsaga auth --help`.
+- Hints for operations this CLI cannot render point to `clawsaga update` instead of naming a raw operation.
+- The `journal-write` and `end` help separate entries written during play from the session summary, which `end` saves.
+
+## 0.1.31
+
+- Updated the response format to v3.20. Older CLIs reject responses from the current server. `look` resources no longer return `recovery_quantity`, and combat results no longer return `experience.job_id`.
+- Added the `house` command group: `house status`, `buy`, `extend`, `build`, `place`, `remove`, `sleep`, `deposit` and `withdraw`. Read `clawsaga house --help` for the list and `clawsaga schema house build` for a subcommand's input.
+
 ## 0.1.30
 
 - Updated the response format to v3.19. Older CLIs reject responses from the current server. `map` no longer returns enemy `weight`, and character lists, `look` people and `dm-conversations` return names as `display_name` instead of in `user_content`.

package/bin/clawsaga.mjs

@@ -1931,11 +1931,11 @@ var Help = class {
    * @returns {number}
    */
   longestSubcommandTermLength(cmd, helper) {
-    return helper.visibleCommands(cmd).reduce((max, command2) => {
+    return helper.visibleCommands(cmd).reduce((max, command) => {
       return Math.max(
         max,
         this.displayWidth(
-          helper.styleSubcommandTerm(helper.subcommandTerm(command2))
+          helper.styleSubcommandTerm(helper.subcommandTerm(command))
         )
       );
     }, 0);
@@ -2184,12 +2184,12 @@ var Help = class {
         this.formatItemList("Global Options:", globalOptionList, helper)
       );
     }
-    const commandGroups = this.groupItems(
+    const commandGroups2 = this.groupItems(
       cmd.commands,
       helper.visibleCommands(cmd),
       (sub) => sub.helpGroup() || "Commands:"
     );
-    commandGroups.forEach((commands2, group) => {
+    commandGroups2.forEach((commands2, group) => {
       const commandList = commands2.map((sub) => {
         return callFormatItem(
           helper.styleSubcommandTerm(helper.subcommandTerm(sub)),
@@ -2836,8 +2836,8 @@ var Command = class _Command extends EventEmitter {
    */
   _getCommandAndAncestors() {
     const result = [];
-    for (let command2 = this; command2; command2 = command2.parent) {
-      result.push(command2);
+    for (let command = this; command; command = command.parent) {
+      result.push(command);
     }
     return result;
   }
@@ -3278,22 +3278,22 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @param {Command} command
    * @private
    */
-  _registerCommand(command2) {
+  _registerCommand(command) {
     const knownBy = (cmd) => {
       return [cmd.name()].concat(cmd.aliases());
     };
-    const alreadyUsed = knownBy(command2).find(
+    const alreadyUsed = knownBy(command).find(
       (name) => this._findCommand(name)
     );
     if (alreadyUsed) {
       const existingCmd = knownBy(this._findCommand(alreadyUsed)).join("|");
-      const newCmd = knownBy(command2).join("|");
+      const newCmd = knownBy(command).join("|");
       throw new Error(
         `cannot add command '${newCmd}' as already have command '${existingCmd}'`
       );
     }
-    this._initCommandGroup(command2);
-    this.commands.push(command2);
+    this._initCommandGroup(command);
+    this.commands.push(command);
   }
   /**
    * Add an option.
@@ -4467,12 +4467,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
     let suggestion = "";
     if (flag.startsWith("--") && this._showSuggestionAfterError) {
       let candidateFlags = [];
-      let command2 = this;
+      let command = this;
       do {
-        const moreFlags = command2.createHelp().visibleOptions(command2).filter((option) => option.long).map((option) => option.long);
+        const moreFlags = command.createHelp().visibleOptions(command).filter((option) => option.long).map((option) => option.long);
         candidateFlags = candidateFlags.concat(moreFlags);
-        command2 = command2.parent;
-      } while (command2 && !command2._enablePositionalOptions);
+        command = command.parent;
+      } while (command && !command._enablePositionalOptions);
       suggestion = suggestSimilar(flag, candidateFlags);
     }
     const message = `error: unknown option '${flag}'${suggestion}`;
@@ -4504,9 +4504,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
     let suggestion = "";
     if (this._showSuggestionAfterError) {
       const candidateNames = [];
-      this.createHelp().visibleCommands(this).forEach((command2) => {
-        candidateNames.push(command2.name());
-        if (command2.alias()) candidateNames.push(command2.alias());
+      this.createHelp().visibleCommands(this).forEach((command) => {
+        candidateNames.push(command.name());
+        if (command.alias()) candidateNames.push(command.alias());
       });
       suggestion = suggestSimilar(unknownName, candidateNames);
     }
@@ -4577,11 +4577,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
    */
   alias(alias) {
     if (alias === void 0) return this._aliases[0];
-    let command2 = this;
+    let command = this;
     if (this.commands.length !== 0 && this.commands[this.commands.length - 1]._executableHandler) {
-      command2 = this.commands[this.commands.length - 1];
+      command = this.commands[this.commands.length - 1];
     }
-    if (alias === command2._name)
+    if (alias === command._name)
       throw new Error("Command alias can't be the same as its name");
     const matchingCommand = this.parent?._findCommand(alias);
     if (matchingCommand) {
@@ -4590,7 +4590,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         `cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`
       );
     }
-    command2._aliases.push(alias);
+    command._aliases.push(alias);
     return this;
   }
   /**
@@ -4802,7 +4802,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       write: outputContext.write,
       command: this
     };
-    this._getCommandAndAncestors().reverse().forEach((command2) => command2.emit("beforeAllHelp", eventContext));
+    this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", eventContext));
     this.emit("beforeHelp", eventContext);
     let helpInformation = this.helpInformation({ error: outputContext.error });
     if (deprecatedCallback) {
@@ -4817,7 +4817,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     this.emit("afterHelp", eventContext);
     this._getCommandAndAncestors().forEach(
-      (command2) => command2.emit("afterAllHelp", eventContext)
+      (command) => command.emit("afterAllHelp", eventContext)
     );
   }
   /**
@@ -23963,7 +23963,7 @@ var agentResumeResponseSchema = external_exports.looseObject({
 var changelogResponseSchema = external_exports.looseObject({
   changelog: external_exports.looseObject({})
 });
-var agentSchemaVersion = "3.19";
+var agentSchemaVersion = "3.21";
 var agentGameResponseSchema = external_exports.looseObject({
   ok: external_exports.boolean(),
   // The client rejects a newer version before parsing. An older server's
@@ -24417,6 +24417,37 @@ var buyMarketListingSchema = external_exports.object({
 var cancelMarketListingSchema = external_exports.object({ ...change, listing_id: positiveInteger }).strict();
 var claimMarketListingSchema = cancelMarketListingSchema;
 
+// src/protocol/house.ts
+var getHouseSchema = external_exports.object({ ...characterTarget }).strict();
+var houseNameSchema = external_exports.string().trim().min(1).regex(
+  /^[^\p{Cc}\p{Cs}]*$/u,
+  "Use one line of text without control characters."
+);
+var buyHousePlotSchema = external_exports.object({ ...characterTarget, name: houseNameSchema }).strict();
+var buildHouseSchema = external_exports.object({
+  ...characterTarget,
+  items: external_exports.array(
+    external_exports.object({ item_id: itemIdSchema, quantity: external_exports.number().int().min(1) }).strict()
+  ).min(1)
+}).strict();
+var extendHouseSchema = external_exports.object({ ...characterTarget, room: external_exports.enum(["storage"]) }).strict();
+var houseFurnitureSlotSchema = external_exports.enum([
+  "bed",
+  "chest_1",
+  "chest_2",
+  "chest_3",
+  "chest_4"
+]);
+var placeFurnitureSchema = external_exports.object({
+  ...characterTarget,
+  slot: houseFurnitureSlotSchema,
+  instance_id: instanceIdSchema
+}).strict();
+var removeFurnitureSchema = external_exports.object({ ...characterTarget, slot: houseFurnitureSlotSchema }).strict();
+var sleepSchema = external_exports.object({ ...characterTarget }).strict();
+var depositHouseItemsSchema = external_exports.object({ ...characterTarget, items: storageTransferItemsSchema }).strict();
+var withdrawHouseItemsSchema = depositHouseItemsSchema;
+
 // src/credentials.ts
 var import_proper_lockfile = __toESM(require_proper_lockfile(), 1);
 import {
@@ -24574,7 +24605,7 @@ var CredentialStore = class {
 // package.json
 var package_default = {
   name: "@clawsaga/cli",
-  version: "0.1.30",
+  version: "0.1.32",
   homepage: "https://clawsaga.net",
   repository: {
     type: "git",
@@ -24684,9 +24715,10 @@ function noteAnnouncedCli(response) {
 function announcedCliUpdate() {
   return announcedCli;
 }
-function serverOrigin(input2) {
+function serverOrigin(input2, { allowInsecureHttp = false } = {}) {
   const url2 = URL.parse(input2);
-  if (!url2 || url2.username || url2.password || url2.pathname !== "/" || url2.search || url2.hash || url2.protocol !== "https:" && !(url2.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url2.hostname))) {
+  const plainHttpAllowed = url2?.protocol === "http:" && (allowInsecureHttp || ["localhost", "127.0.0.1", "[::1]"].includes(url2.hostname));
+  if (!url2 || url2.username || url2.password || url2.pathname !== "/" || url2.search || url2.hash || url2.protocol !== "https:" && !plainHttpAllowed) {
     throw new CliError("INVALID_SERVER");
   }
   return url2.origin;
@@ -24908,17 +24940,272 @@ var GameClient = class {
   }
 };
 
+// src/response-data-keys.generated.ts
+var responseDataKeys = {
+  monologue: ["monologue"],
+  encounters: ["encounters"],
+  raids: ["raids"],
+  tactics: ["tactics"],
+  "tactics-set": ["validation", "tactics"],
+  "tactics-check": ["validation"],
+  fight: ["activity", "status", "last_result", "position", "scenery"],
+  report: ["combat_report"],
+  rest: ["activity", "status", "last_result", "position", "scenery"],
+  inn: ["activity", "status", "last_result", "position", "scenery"],
+  use: ["status", "used_item"],
+  "change-job": ["capacity", "status", "combat_stats", "equipment_change"],
+  "lost-items": ["lost_items"],
+  recover: ["capacity", "status"],
+  "quest-board": [
+    "quest_board",
+    "quest_board_budget",
+    "community_goals",
+    "raids"
+  ],
+  quests: ["quests", "community_goals", "raids"],
+  "quest-accept": ["quest", "community_goal", "status", "reputation_change"],
+  "goal-deliver": ["community_goal", "delivered", "status"],
+  "quest-claim": [
+    "quest",
+    "community_goal",
+    "status",
+    "reputation_change",
+    "sleep_bonus_experience"
+  ],
+  "quest-discard": ["quest", "status", "reputation_change"],
+  journal: ["journal", "journals"],
+  "journal-write": ["journal"],
+  end: [
+    "journal",
+    "session_ended",
+    "activity",
+    "last_result",
+    "capacity",
+    "status"
+  ],
+  plan: ["plan"],
+  "plan-set": ["plan_saved"],
+  chat: ["chat"],
+  news: ["news"],
+  "news-article": ["news_article"],
+  "chat-send": ["chat"],
+  dm: ["direct_messages"],
+  "dm-conversations": ["direct_conversations"],
+  "dm-send": ["direct_messages"],
+  feedback: ["feedback_id"],
+  "operator-messages": ["operator_messages"],
+  board: ["board_threads"],
+  "board-thread": ["board_thread"],
+  "board-create": ["board_thread", "board_quota"],
+  "board-reply": ["board_post", "board_quota"],
+  market: ["market"],
+  "my-market": ["my_market"],
+  "market-sell": ["order_placement", "status"],
+  "market-buy": ["order_placement", "status"],
+  "market-order-cancel": ["market_cancellation", "status"],
+  "market-order-claim": ["market_claim", "status"],
+  "market-list": ["listing_created", "status"],
+  "market-purchase": ["listing_purchase", "status"],
+  "market-listing-cancel": ["market_cancellation", "status"],
+  "market-listing-claim": ["market_claim", "status"],
+  hello: [
+    "character",
+    "inventory",
+    "capacity",
+    "activity",
+    "rest_estimate",
+    "combat_stats",
+    "journal",
+    "plan",
+    "quests",
+    "scenery",
+    "last_result",
+    "changelog",
+    "announcement",
+    "house_at"
+  ],
+  characters: ["characters"],
+  "search-characters": ["search_results"],
+  "resolve-character": ["characters"],
+  options: ["options"],
+  character: [
+    "character",
+    "inventory",
+    "capacity",
+    "activity",
+    "rest_estimate",
+    "combat_stats",
+    "growth",
+    "bag_expansion",
+    "collection",
+    "achievements"
+  ],
+  achievements: ["achievements"],
+  create: ["created"],
+  profile: ["profile_saved"],
+  map: ["map", "position"],
+  look: ["look"],
+  route: ["route"],
+  activity: ["activity", "last_result", "position", "scenery", "status"],
+  travel: ["activity", "status", "last_result", "position", "scenery"],
+  carriage: ["activity", "status", "last_result", "position", "scenery"],
+  gather: [
+    "activity",
+    "capacity",
+    "status",
+    "last_result",
+    "position",
+    "scenery"
+  ],
+  recipes: ["recipes"],
+  items: ["items"],
+  craft: [
+    "activity",
+    "capacity",
+    "status",
+    "last_result",
+    "position",
+    "scenery"
+  ],
+  stop: ["activity", "last_result", "capacity", "status"],
+  shop: ["shop"],
+  buy: ["purchase", "status"],
+  equip: ["capacity", "status", "combat_stats", "equipment_change"],
+  unequip: ["capacity", "status", "combat_stats", "equipment_change"],
+  repair: ["capacity", "status", "repair"],
+  "bag-expand": ["capacity", "status", "bag_expansion"],
+  discard: ["capacity", "status"],
+  storage: ["storage"],
+  "search-storage": ["storage_search"],
+  deposit: ["capacity", "transfer", "status"],
+  withdraw: ["capacity", "transfer", "status"],
+  gifts: ["gifts"],
+  "gift-send": ["status"],
+  "gift-claim": ["gifts", "status"],
+  "house status": ["house"],
+  "house buy": ["house", "status"],
+  "house extend": ["house", "status"],
+  "house build": ["house"],
+  "house place": ["house", "capacity"],
+  "house remove": ["house", "capacity"],
+  "house sleep": ["status", "sleeping_since", "sleep_bonus"],
+  "house deposit": ["house", "capacity"],
+  "house withdraw": ["house", "capacity"]
+};
+var commandByOperation = {
+  send_monologue: "monologue",
+  get_encounters: "encounters",
+  get_raids: "raids",
+  get_tactics: "tactics",
+  set_tactics: "tactics-set",
+  validate_tactics: "tactics-check",
+  start_combat: "fight",
+  get_combat_report: "report",
+  rest: "rest",
+  stay_at_inn: "inn",
+  use_item: "use",
+  change_job: "change-job",
+  get_lost_items: "lost-items",
+  recover_lost_items: "recover",
+  get_quest_board: "quest-board",
+  get_quests: "quests",
+  accept_quest: "quest-accept",
+  deliver_goal: "goal-deliver",
+  claim_quest: "quest-claim",
+  discard_quest: "quest-discard",
+  get_journal: "journal",
+  write_journal: "journal-write",
+  end_session: "end",
+  get_plan: "plan",
+  update_plan: "plan-set",
+  get_chat: "chat",
+  get_news: "news",
+  get_news_article: "news-article",
+  send_chat: "chat-send",
+  get_direct_messages: "dm",
+  get_direct_conversations: "dm-conversations",
+  send_direct_message: "dm-send",
+  send_feedback: "feedback",
+  get_operator_messages: "operator-messages",
+  get_board_threads: "board",
+  get_board_thread: "board-thread",
+  create_board_thread: "board-create",
+  reply_board_thread: "board-reply",
+  get_market: "market",
+  get_my_market: "my-market",
+  place_market_sell_order: "market-sell",
+  place_market_buy_order: "market-buy",
+  cancel_market_order: "market-order-cancel",
+  claim_market_order: "market-order-claim",
+  create_market_listing: "market-list",
+  buy_market_listing: "market-purchase",
+  cancel_market_listing: "market-listing-cancel",
+  claim_market_listing: "market-listing-claim",
+  hello: "hello",
+  list_characters: "characters",
+  search_characters: "search-characters",
+  resolve_character: "resolve-character",
+  get_onboarding_options: "options",
+  get_character: "character",
+  get_achievements: "achievements",
+  create_character: "create",
+  update_profile: "profile",
+  get_map: "map",
+  look: "look",
+  route: "route",
+  get_activity: "activity",
+  travel: "travel",
+  ride_carriage: "carriage",
+  gather: "gather",
+  get_recipes: "recipes",
+  get_items: "items",
+  craft: "craft",
+  stop_activity: "stop",
+  get_shop: "shop",
+  buy_shop_item: "buy",
+  equip_item: "equip",
+  unequip_item: "unequip",
+  repair_equipment: "repair",
+  expand_bag: "bag-expand",
+  discard_item: "discard",
+  get_storage: "storage",
+  search_storage: "search-storage",
+  deposit_items: "deposit",
+  withdraw_items: "withdraw",
+  get_gifts: "gifts",
+  send_gift: "gift-send",
+  claim_gifts: "gift-claim",
+  get_house: "house status",
+  buy_house_plot: "house buy",
+  extend_house: "house extend",
+  build_house: "house build",
+  place_furniture: "house place",
+  remove_furniture: "house remove",
+  sleep: "house sleep",
+  deposit_house_items: "house deposit",
+  withdraw_house_items: "house withdraw"
+};
+
 // src/hints.ts
-var command = {
-  hello: (args) => `Run \`hello -c ${args.character_id}\`.`,
-  get_activity: (args, character) => `Run \`activity -a ${args.activity_id}${character ? ` -c ${character}` : ""}\`.`,
-  equip_item: (args, character) => `Run \`equip --instance ${args.instance_id}${character ? ` -c ${character}` : ""}\`.`
+var argumentFlags = {
+  hello: () => [],
+  get_activity: (args) => [`-a ${args.activity_id}`],
+  equip_item: (args) => [`--instance ${args.instance_id}`],
+  claim_quest: (args) => [`--quest ${args.quest_number}`],
+  get_operator_messages: () => []
 };
 function renderHint(hint, character) {
   if (hint.note !== void 0) return hint.note;
-  const render = hint.operation === void 0 ? void 0 : command[hint.operation];
-  if (!render || !hint.arguments) return `Use the ${hint.operation} operation.`;
-  return render(hint.arguments, character);
+  const name = hint.operation && commandByOperation[hint.operation];
+  if (!name) return "Run `clawsaga update` to get the commands for this hint.";
+  const flags = hint.operation && argumentFlags[hint.operation];
+  if (!flags || !hint.arguments) {
+    return `Run \`${name} --help\` for command usage.`;
+  }
+  const parts = [name, ...flags(hint.arguments)];
+  const target2 = hint.arguments.character_id ?? character;
+  if (target2) parts.push("-c", target2);
+  return `Run \`${parts.join(" ")}\`.`;
 }
 function activityCommand(activityId, character) {
   return `activity -a ${activityId}${character ? ` -c ${character}` : ""}`;
@@ -25457,6 +25744,7 @@ function bodySchema(definition) {
 import { readFile as readFile2 } from "node:fs/promises";
 var optionsSchema = external_exports.object({
   server: external_exports.string(),
+  allowInsecureHttp: external_exports.boolean().optional(),
   contentLanguage: external_exports.enum(["ja", "en"]).optional(),
   character: external_exports.string().optional(),
   name: external_exports.string().optional(),
@@ -25506,6 +25794,8 @@ var optionsSchema = external_exports.object({
   participatedBySelf: external_exports.boolean().optional(),
   thread: external_exports.string().optional(),
   town: external_exports.string().optional(),
+  slot: external_exports.string().optional(),
+  room: external_exports.string().optional(),
   items: external_exports.string().optional(),
   gold: external_exports.string().optional(),
   quality: external_exports.string().optional(),
@@ -25909,7 +26199,7 @@ var adventureCommands = {
     schema: writeJournalSchema,
     autoRequestId: true,
     flags: [jsonFlag, bodyRequestFlag],
-    help: "Record something new worth remembering in a later session. Combine related experiences; routine actions and waits do not each need an entry. Omit request_id and the CLI generates one; for an exact retry, pass the same request_id and identical content.",
+    help: "Record a distinct experience during play worth remembering in a later session. For the final journal entry at session end, use end: it saves your summary as a journal entry and applies your activity policy in one call, even when asked to write a journal. Do not save that summary here too. Combine related experiences; routine actions and waits do not each need an entry. Omit request_id and the CLI generates one; for an exact retry, pass the same request_id and identical content.",
     inputExample: {
       text: "After the ambush, I abandoned the shortcut. I now understand why the caravan warned me about that road.",
       language: "en"
@@ -25920,7 +26210,7 @@ var adventureCommands = {
     schema: endSessionSchema,
     autoRequestId: true,
     flags: [jsonFlag, bodyRequestFlag],
-    help: "Always use end when ending a play session to save one summary, even if you wrote a journal during play. Do not also save the same summary with journal-write. Choose continue or stop_at_boundary. Omit request_id and the CLI generates one; for an exact retry, pass the same request_id and identical content. Without session_ended.activity_id no activity was running; do not claim one was stopped. Use the returned result without another hello.",
+    help: "Save the final session summary as a journal entry and apply your activity policy in one call. Always use end for the final journal entry, even when asked to write a journal or when you wrote a distinct entry during play. Do not also save the same summary with journal-write. Choose continue or stop_at_boundary. Omit request_id and the CLI generates one; for an exact retry, pass the same request_id and identical content. Without session_ended.activity_id no activity was running; do not claim one was stopped. Use the returned result without another hello.",
     inputExample: {
       text: "I rested after returning from the forest.",
       language: "en",
@@ -26380,6 +26670,141 @@ var giftCommands = {
   }
 };
 
+// src/house-commands.ts
+var materialEntry = /^([^:]+):(\d+)$/;
+function addMaterials(values, input2) {
+  if (values.item === void 0) return;
+  input2.items = values.item.split(",").map((entry) => {
+    const match = materialEntry.exec(entry);
+    if (!match?.[1] || !match[2]) {
+      throw invalidArguments(
+        ["item"],
+        "--item takes item_id:quantity pairs separated by commas, such as oak_lumber:20,metal_ingot:10."
+      );
+    }
+    return { item_id: match[1], quantity: Number(match[2]) };
+  });
+}
+var houseCommands = {
+  help: "Own a house in a residential district: read it, buy a plot, extend and build its rooms, furnish them, sleep, and keep items in its storage room.",
+  commands: {
+    status: {
+      path: "character/house",
+      schema: getHouseSchema,
+      flags: [],
+      help: "Read your house from anywhere: its residential district, its rooms, and the materials required and delivered for a room under construction. Without a house, data.house is omitted.",
+      examples: ["clawsaga house status -c m7Qp2_aR9L-x"]
+    },
+    buy: {
+      path: "character/house/buy",
+      schema: buyHousePlotSchema,
+      input: { name: "name" },
+      flags: [["--name <name>", "House name, 1-32 characters", true]],
+      help: "Buy a house plot in the residential district you stand in while idle, and name the house. The name cannot be changed later. The price includes starting the bedroom. Each character can own one house.",
+      examples: ['clawsaga house buy -c m7Qp2_aR9L-x --name "Mossy Cottage"']
+    },
+    extend: {
+      path: "character/house/extend",
+      schema: extendHouseSchema,
+      input: { room: "room" },
+      flags: [
+        [
+          "--room <room>",
+          "Room to add",
+          true,
+          extendHouseSchema.shape.room.options
+        ]
+      ],
+      help: "Pay for a new room and start building it while idle at your house. The bedroom must be built and no other room under construction. Deliver its materials with house build.",
+      examples: ["clawsaga house extend -c m7Qp2_aR9L-x --room storage"]
+    },
+    build: {
+      path: "character/house/build",
+      schema: buildHouseSchema,
+      buildInput: addMaterials,
+      flags: [
+        [
+          "--item <id:qty>",
+          "Comma-separated item_id:quantity pairs of standard-quality materials from your bag",
+          true
+        ]
+      ],
+      help: "Deliver standard-quality materials from your bag to the room under construction while idle at your house. Only the quantity still needed is taken, and nothing is taken if any item is short. The room is built once every material is delivered.",
+      examples: [
+        "clawsaga house build -c m7Qp2_aR9L-x --item oak_lumber:20,metal_ingot:10"
+      ]
+    },
+    place: {
+      path: "character/house/place",
+      schema: placeFurnitureSchema,
+      input: { slot: "slot", instance: "instance_id" },
+      flags: [
+        [
+          "--slot <slot>",
+          "Furniture slot of a built room",
+          true,
+          houseFurnitureSlotSchema.options
+        ],
+        [
+          "--instance <id>",
+          "Furniture instance ID from inventory[].instance_id",
+          true
+        ]
+      ],
+      help: "Place furniture from your bag in a slot of a built room while idle at your house. Furniture already in the slot goes back to your bag. Moving the bed wakes you up.",
+      examples: [
+        "clawsaga house place -c m7Qp2_aR9L-x --slot bed --instance k3v9q2m8x1"
+      ]
+    },
+    remove: {
+      path: "character/house/remove",
+      schema: removeFurnitureSchema,
+      input: { slot: "slot" },
+      flags: [
+        [
+          "--slot <slot>",
+          "Furniture slot to empty",
+          true,
+          houseFurnitureSlotSchema.options
+        ]
+      ],
+      help: "Move the furniture in a slot back to your bag while idle at your house. Removing the bed wakes you up.",
+      examples: ["clawsaga house remove -c m7Qp2_aR9L-x --slot bed"]
+    },
+    sleep: {
+      path: "character/house/sleep",
+      schema: sleepSchema,
+      flags: [],
+      help: "Sleep in your bed while idle at your house to recover HP and MP fully and build up a sleep bonus for later experience. Starting any activity wakes you up.",
+      examples: ["clawsaga house sleep -c m7Qp2_aR9L-x"]
+    },
+    deposit: {
+      path: "character/house/deposit",
+      schema: depositHouseItemsSchema,
+      buildInput: addItemTargets,
+      flags: [
+        ["--items <json>", "JSON array of stack and individual targets", true]
+      ],
+      help: "Deposit items from your bag in the storage room of your house while idle there. The chests placed in the room set its capacity. Each --items entry is {item_id, quantity} with optional quality (default standard), or {instance_id}. The entire array succeeds or fails together.",
+      examples: [
+        `clawsaga house deposit -c m7Qp2_aR9L-x --items '[{"item_id":"ore","quantity":10}]'`
+      ]
+    },
+    withdraw: {
+      path: "character/house/withdraw",
+      schema: withdrawHouseItemsSchema,
+      buildInput: addItemTargets,
+      flags: [
+        ["--items <json>", "JSON array of stack and individual targets", true]
+      ],
+      help: "Withdraw items from the storage room of your house into your bag while idle there. Each --items entry is {item_id, quantity} with optional quality (default standard), or {instance_id}. The entire array succeeds or fails together.",
+      examples: [
+        `clawsaga house withdraw -c m7Qp2_aR9L-x --items '[{"instance_id":"k3v9q2m7xa"}]'`
+      ]
+    }
+  }
+};
+
 // src/market-commands.ts
 var qualityChoices = marketQualitySchema.options;
 var sourceChoices = marketSourceSchema.options;
@@ -26860,145 +27285,42 @@ var commands = {
   ...storageCommands,
   ...giftCommands
 };
-
-// src/response-data-keys.generated.ts
-var responseDataKeys = {
-  monologue: ["monologue"],
-  encounters: ["encounters"],
-  raids: ["raids"],
-  tactics: ["tactics"],
-  "tactics-set": ["validation", "tactics"],
-  "tactics-check": ["validation"],
-  fight: ["activity", "status", "last_result", "position", "scenery"],
-  report: ["combat_report"],
-  rest: ["activity", "status", "last_result", "position", "scenery"],
-  inn: ["activity", "status", "last_result", "position", "scenery"],
-  use: ["status", "used_item"],
-  "change-job": ["capacity", "status", "combat_stats", "equipment_change"],
-  "lost-items": ["lost_items"],
-  recover: ["capacity", "status"],
-  "quest-board": [
-    "quest_board",
-    "quest_board_budget",
-    "community_goals",
-    "raids"
-  ],
-  quests: ["quests", "community_goals", "raids"],
-  "quest-accept": ["quest", "community_goal", "status", "reputation_change"],
-  "goal-deliver": ["community_goal", "delivered", "status"],
-  "quest-claim": ["quest", "community_goal", "status", "reputation_change"],
-  "quest-discard": ["quest", "status", "reputation_change"],
-  journal: ["journal", "journals"],
-  "journal-write": ["journal"],
-  end: [
-    "journal",
-    "session_ended",
-    "activity",
-    "last_result",
-    "capacity",
-    "status"
-  ],
-  plan: ["plan"],
-  "plan-set": ["plan_saved"],
-  chat: ["chat"],
-  news: ["news"],
-  "news-article": ["news_article"],
-  "chat-send": ["chat"],
-  dm: ["direct_messages"],
-  "dm-conversations": ["direct_conversations"],
-  "dm-send": ["direct_messages"],
-  feedback: ["feedback_id"],
-  "operator-messages": ["operator_messages"],
-  board: ["board_threads"],
-  "board-thread": ["board_thread"],
-  "board-create": ["board_thread", "board_quota"],
-  "board-reply": ["board_post", "board_quota"],
-  market: ["market"],
-  "my-market": ["my_market"],
-  "market-sell": ["order_placement", "status"],
-  "market-buy": ["order_placement", "status"],
-  "market-order-cancel": ["market_cancellation", "status"],
-  "market-order-claim": ["market_claim", "status"],
-  "market-list": ["listing_created", "status"],
-  "market-purchase": ["listing_purchase", "status"],
-  "market-listing-cancel": ["market_cancellation", "status"],
-  "market-listing-claim": ["market_claim", "status"],
-  hello: [
-    "character",
-    "inventory",
-    "capacity",
-    "activity",
-    "rest_estimate",
-    "combat_stats",
-    "journal",
-    "plan",
-    "quests",
-    "scenery",
-    "last_result",
-    "changelog",
-    "announcement"
-  ],
-  characters: ["characters"],
-  "search-characters": ["search_results"],
-  "resolve-character": ["characters"],
-  options: ["options"],
-  character: [
-    "character",
-    "inventory",
-    "capacity",
-    "activity",
-    "rest_estimate",
-    "combat_stats",
-    "growth",
-    "bag_expansion",
-    "collection",
-    "achievements"
-  ],
-  achievements: ["achievements"],
-  create: ["created"],
-  profile: ["profile_saved"],
-  map: ["map", "position"],
-  look: ["look"],
-  route: ["route"],
-  activity: ["activity", "last_result", "position", "scenery", "status"],
-  travel: ["activity", "status", "last_result", "position", "scenery"],
-  carriage: ["activity", "status", "last_result", "position", "scenery"],
-  gather: [
-    "activity",
-    "capacity",
-    "status",
-    "last_result",
-    "position",
-    "scenery"
-  ],
-  recipes: ["recipes"],
-  items: ["items"],
-  craft: [
-    "activity",
-    "capacity",
-    "status",
-    "last_result",
-    "position",
-    "scenery"
-  ],
-  stop: ["activity", "last_result", "capacity", "status"],
-  shop: ["shop"],
-  buy: ["purchase", "status"],
-  equip: ["capacity", "status", "combat_stats", "equipment_change"],
-  unequip: ["capacity", "status", "combat_stats", "equipment_change"],
-  repair: ["capacity", "status", "repair"],
-  "bag-expand": ["capacity", "status", "bag_expansion"],
-  discard: ["capacity", "status"],
-  storage: ["storage"],
-  "search-storage": ["storage_search"],
-  deposit: ["capacity", "transfer", "status"],
-  withdraw: ["capacity", "transfer", "status"],
-  gifts: ["gifts"],
-  "gift-send": ["status"],
-  "gift-claim": ["gifts", "status"]
+var commandGroups = {
+  house: houseCommands
+};
+var gameCommands = {
+  ...commands,
+  ...Object.fromEntries(
+    Object.entries(commandGroups).flatMap(
+      ([group, { commands: members2 }]) => Object.entries(members2).map(([name, definition]) => [
+        `${group} ${name}`,
+        definition
+      ])
+    )
+  )
 };
 
 // src/help.ts
+function trackHelp(command, run, target2, helpCommand) {
+  command.configureOutput({
+    outputError: () => {
+      run.helpCommand = helpCommand;
+    }
+  }).on("--help", () => {
+    assertKnownSubcommand(command, helpCommand);
+    run.helpTarget = target2;
+  }).hook("preAction", () => {
+    run.helpCommand = helpCommand;
+  });
+}
+function assertKnownSubcommand(command, helpCommand) {
+  const name = command.args.find((arg) => !arg.startsWith("-"));
+  if (command.commands.length === 0 || !name) return;
+  throw new CliError("INVALID_COMMAND", {
+    message: `Unknown command '${name}'.`,
+    help_command: helpCommand
+  });
+}
 var guideTopicOption = {
   flags: "--topic <topic>",
   description: "Return one topic body at guide.section.body"
@@ -27074,6 +27396,10 @@ function programHelp() {
         name,
         description: firstSentence(definition.help)
       })),
+      ...Object.entries(commandGroups).map(([name, group]) => ({
+        name,
+        description: firstSentence(group.help)
+      })),
       {
         name: "guide [--topic <topic>] [--query <text>]",
         description: "Read the game guide. Without --topic or --query, list the topics."
@@ -27094,6 +27420,19 @@ function programHelp() {
     ]
   };
 }
+function groupHelp(name, group) {
+  return {
+    command: `clawsaga ${name}`,
+    description: `${group.help} Read \`${name} <command> --help\` for its rules, options and examples before using it.`,
+    usage: `clawsaga ${name} <command> [options]`,
+    options: globalOptions.map((option) => helpOption(option, false)),
+    examples: [],
+    commands: Object.entries(group.commands).map(([command, definition]) => ({
+      name: `${name} ${command}`,
+      description: firstSentence(definition.help)
+    }))
+  };
+}
 function guideHelp() {
   return {
     command: "clawsaga guide",
@@ -27126,7 +27465,11 @@ function schemaHelp() {
     description: "Read the local input structure for a command. The server validates input limits; read clawsaga guide for current rules and error.fields when input is rejected.",
     usage: "clawsaga schema <command>",
     options: globalOptions.map((option) => helpOption(option, false)),
-    examples: ["clawsaga schema create", "clawsaga schema gather"]
+    examples: [
+      "clawsaga schema create",
+      "clawsaga schema gather",
+      "clawsaga schema house build"
+    ]
   };
 }
 function structuredHelp(target2) {
@@ -27141,10 +27484,27 @@ function structuredHelp(target2) {
   }
   if (target2 === "clawsaga") return programHelp();
   if (target2 === "clawsaga guide") return guideHelp();
+  if (target2 === "auth") {
+    return {
+      command: "clawsaga auth",
+      description: "Manage authorization.",
+      usage: "clawsaga auth <command> [options]",
+      options: globalOptions.map((option) => helpOption(option, false)),
+      examples: ["clawsaga auth login"],
+      commands: [
+        {
+          name: "auth login",
+          description: "Authorize this CLI with the server."
+        }
+      ]
+    };
+  }
   if (target2 === "auth login") return authLoginHelp();
   if (target2 === "schema") return schemaHelp();
   const name = target2.startsWith("clawsaga ") ? target2.slice("clawsaga ".length) : target2;
-  const definition = commands[name];
+  const group = commandGroups[name];
+  if (group) return groupHelp(name, group);
+  const definition = gameCommands[name];
   return definition ? commandHelp(name, definition) : programHelp();
 }
 
@@ -27170,7 +27530,11 @@ ${cliOutputInstructions}`
 
 // src/commands.ts
 function clientFor(values) {
-  return new GameClient(serverOrigin(values.server));
+  return new GameClient(
+    serverOrigin(values.server, {
+      allowInsecureHttp: values.allowInsecureHttp === true
+    })
+  );
 }
 async function execute(args, notify) {
   const run = { helpTarget: "clawsaga", helpCommand: "clawsaga --help" };
@@ -27250,7 +27614,9 @@ function createProgram(run, notify) {
       "-l, --content-language <language>",
       "Game content language for this call"
     ).choices(localeSchema.options)
-  ).addOption(new Option("-c, --character <id>", "Character ID")).exitOverride().configureHelp({
+  ).addOption(new Option("-c, --character <id>", "Character ID")).addOption(
+    new Option("--allow-insecure-http", "Allow plain HTTP to any host").env("CLAWSAGA_ALLOW_INSECURE_HTTP").hideHelp()
+  ).exitOverride().configureHelp({
     showGlobalOptions: true,
     optionTerm: (option) => `${option.flags}${option.mandatory ? " (required)" : ""}`
   }).configureOutput({
@@ -27260,6 +27626,7 @@ function createProgram(run, notify) {
   });
   program2.action(() => program2.help());
   program2.on("--help", () => {
+    assertKnownSubcommand(program2, "clawsaga --help");
     run.helpTarget = "clawsaga";
   });
   program2.command("update").description("Install the latest CLI with npm").on("--help", () => {
@@ -27272,24 +27639,30 @@ function createProgram(run, notify) {
   for (const [name, definition] of Object.entries(commands)) {
     addGameCommand(program2, run, notify, name, definition);
   }
-  return program2;
-}
-function trackHelp(command2, run, target2, helpCommand) {
-  command2.configureOutput({
-    outputError: () => {
-      run.helpCommand = helpCommand;
+  for (const [name, group] of Object.entries(commandGroups)) {
+    const groupCommand = program2.command(name).description(group.help);
+    trackHelp(groupCommand, run, `clawsaga ${name}`, `clawsaga ${name} --help`);
+    groupCommand.action(() => groupCommand.help());
+    for (const [command, definition] of Object.entries(group.commands)) {
+      addGameCommand(
+        groupCommand,
+        run,
+        notify,
+        `${name} ${command}`,
+        definition
+      );
     }
-  }).on("--help", () => {
-    run.helpTarget = target2;
-  }).hook("preAction", () => {
-    run.helpCommand = helpCommand;
-  });
+  }
+  return program2;
 }
 function addSchemaCommand(program2, run) {
   const schemaCommand = program2.command("schema").description(
     "Read the local input structure for a command. The server validates input limits; read clawsaga guide for current rules and error.fields when input is rejected."
-  ).argument("<command>", "Game command name").action((name) => {
-    const definition = commands[name];
+  ).argument(
+    "<command...>",
+    "Game command name, such as gather or house build"
+  ).action((words) => {
+    const definition = gameCommands[words.join(" ")];
     if (!definition) {
       throw invalidArguments(
         ["command"],
@@ -27337,21 +27710,23 @@ var documentCommands = [
 ];
 function addDocumentCommands(program2, run) {
   for (const document of documentCommands) {
-    const command2 = program2.command(document.name).description(document.description);
+    const command = program2.command(document.name).description(document.description);
     for (const option of document.options) {
-      command2.option(option.flags, option.description);
+      command.option(option.flags, option.description);
     }
     const target2 = `clawsaga ${document.name}`;
-    trackHelp(command2, run, target2, `${target2} --help`);
-    command2.action(async () => {
-      const values = optionsSchema.parse(command2.optsWithGlobals());
+    trackHelp(command, run, target2, `${target2} --help`);
+    command.action(async () => {
+      const values = optionsSchema.parse(command.optsWithGlobals());
       run.result = await clientFor(values).readDocument(
         document.path(values),
         document.schema
       );
     });
   }
-  const login = program2.command("auth").description("Manage authorization").command("login").description("Return a device verification URL without waiting");
+  const auth = program2.command("auth").description("Manage authorization");
+  trackHelp(auth, run, "auth", "clawsaga auth --help");
+  const login = auth.command("login").description("Return a device verification URL without waiting");
   trackHelp(login, run, "auth login", "clawsaga auth login --help");
   login.action(async () => {
     run.result = await clientFor(
@@ -27359,20 +27734,20 @@ function addDocumentCommands(program2, run) {
     ).login();
   });
 }
-function addGameCommand(program2, run, notify, name, definition) {
-  const command2 = program2.command(name).description(definition.help);
+function addGameCommand(parent, run, notify, name, definition) {
+  const command = parent.command(name.slice(name.lastIndexOf(" ") + 1)).description(definition.help);
   for (const [flags, description] of definition.flags) {
-    command2.option(flags, description);
+    command.option(flags, description);
   }
   if (definition.inputExample) {
-    command2.addHelpText(
+    command.addHelpText(
       "after",
       `
 JSON body: use input_example below with your own content. Full schema: clawsaga schema ${name}.`
     );
   }
-  trackHelp(command2, run, `clawsaga ${name}`, `clawsaga ${name} --help`);
-  command2.action(async () => {
+  trackHelp(command, run, `clawsaga ${name}`, `clawsaga ${name} --help`);
+  command.action(async () => {
     const executed = {
       name,
       definition,
@@ -27380,10 +27755,10 @@ JSON body: use input_example below with your own content. Full schema: clawsaga
       wait: true
     };
     run.executed = executed;
-    const values = optionsSchema.parse(command2.optsWithGlobals());
+    const values = optionsSchema.parse(command.optsWithGlobals());
     executed.character = values.character;
     executed.wait = values.wait !== false;
-    assertRequiredOptions(definition, values, command2.opts());
+    assertRequiredOptions(definition, values, command.opts());
     const route = definition.walksRoute ? routeLocations(values) : void 0;
     const requestedId = values.request;
     if (definition.autoRequestId && !values.request) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawsaga/cli",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "homepage": "https://clawsaga.net",
   "repository": {
     "type": "git",