@clawsaga/cli 0.1.31 → 0.1.33

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Changes to this CLI and skill, newest first. Game, rule and API changes shared with MCP are in `clawsaga changelog`.
 
+## 0.1.33
+
+- Updated the response format to v3.22. Older CLIs reject responses from the current server. Battle reports carry the items used and left, gauges and enemy MP, and status effects carry their `percent`.
+- Tactics: `potion_items` is gone; `potion` and the new `cure` action take optional `item_ids`, and `potion_limit` counts both. Added the conditions `enemy_mp_below`, `gauge_at_least` and `enemy_last_action`, and `power_at_least` on `enemy_winding_up` and `enemy_attacking_heavy`.
+- `craft --use-fine` uses fine intermediate materials first. `quest-deliver`, `quest-claim` and `house build` accept `--allow-quality`, and `discard --quality` discards a fine or superior stack.
+- `fight --input` can be combined with `--practice`. Hints given when an activity starts, such as unused fine materials, stay on the final output.
+
+## 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`.

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);
@@ -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)
     );
   }
   /**
@@ -23871,6 +23871,7 @@ var activityIdSchema = external_exports.number().int().min(1);
 var instanceIdSchema = external_exports.string().regex(/^[0-9a-z]{10}$/);
 var dropIdSchema = instanceIdSchema;
 var itemIdSchema = external_exports.string().regex(/^[a-z][a-z0-9_]{0,63}$/);
+var itemQualitySchema = external_exports.enum(["standard", "fine", "superior"]);
 var skillIdSchema = external_exports.enum([
   "mining",
   "gathering",
@@ -23963,7 +23964,7 @@ var agentResumeResponseSchema = external_exports.looseObject({
 var changelogResponseSchema = external_exports.looseObject({
   changelog: external_exports.looseObject({})
 });
-var agentSchemaVersion = "3.20";
+var agentSchemaVersion = "3.22";
 var agentGameResponseSchema = external_exports.looseObject({
   ok: external_exports.boolean(),
   // The client rejects a newer version before parsing. An older server's
@@ -24026,6 +24027,7 @@ var craftSchema = external_exports.object({
   ...characterTarget,
   recipe_id: external_exports.string().min(1),
   max_fee_per_lot: external_exports.number().int().min(0).optional(),
+  use_fine_materials: external_exports.boolean().optional(),
   request_id: external_exports.uuid()
 }).strict();
 var stopActivitySchema = external_exports.object({ ...characterTarget, activity_id: activityIdSchema }).strict();
@@ -24051,7 +24053,8 @@ var discardItemSchema = external_exports.object({
     external_exports.object({
       kind: external_exports.literal("stack"),
       item_id: itemIdSchema,
-      quantity: external_exports.number().int().positive()
+      quantity: external_exports.number().int().positive(),
+      quality: itemQualitySchema.optional()
     }).strict(),
     external_exports.object({
       kind: external_exports.literal("individual"),
@@ -24080,17 +24083,50 @@ var combatStatusSchema = external_exports.enum([
   "empowered",
   "regen"
 ]);
+var combatActionKindSchema = external_exports.enum([
+  "attack",
+  "heavy_attack",
+  "defend",
+  "ability",
+  "potion",
+  "cure",
+  "none"
+]);
+var heavyPowerAtLeastSchema = external_exports.number().int().min(1).optional().describe(
+  "Match only a heavy attack of at least this power percent, as shown by next_heavy.power_percent."
+);
 var tacticConditionSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({
-    kind: external_exports.enum(["hp_below", "mp_below", "enemy_hp_below"]),
+    kind: external_exports.enum([
+      "hp_below",
+      "mp_below",
+      "enemy_hp_below",
+      "enemy_mp_below"
+    ]),
     percent: external_exports.number().int().min(1)
   }).strict().describe(
     "Matches when the named current percentage is strictly below percent. HP percentages use current / maximum HP; MP uses its 0\u2013100 value."
   ),
-  external_exports.object({ kind: external_exports.literal("enemy_winding_up") }).strict().describe(
+  external_exports.object({
+    kind: external_exports.literal("gauge_at_least"),
+    value: external_exports.number().int().min(1)
+  }).strict().describe("Matches when your gauge is at least value."),
+  external_exports.object({
+    kind: external_exports.literal("enemy_last_action"),
+    action: combatActionKindSchema
+  }).strict().describe(
+    "Matches when the enemy took this kind of action on the previous tick. A heavy attack is a charged ability released; an interrupted one counts as attack. Doing nothing, charging without acting and retreating count as none."
+  ),
+  external_exports.object({
+    kind: external_exports.literal("enemy_winding_up"),
+    power_at_least: heavyPowerAtLeastSchema
+  }).strict().describe(
     "Matches when the enemy heavy attack is at most two ticks away, including the tick it occurs."
   ),
-  external_exports.object({ kind: external_exports.literal("enemy_attacking_heavy") }).strict().describe("Matches on the tick when the enemy heavy attack occurs."),
+  external_exports.object({
+    kind: external_exports.literal("enemy_attacking_heavy"),
+    power_at_least: heavyPowerAtLeastSchema
+  }).strict().describe("Matches on the tick when the enemy heavy attack occurs."),
   external_exports.object({ kind: external_exports.literal("enemy_recovering") }).strict().describe("Matches on the recovery tick after a heavy attack."),
   external_exports.object({ kind: external_exports.literal("enemy_heavy_interruptible") }).strict().describe(
     "Matches when the scheduled enemy heavy attack can be interrupted."
@@ -24099,7 +24135,7 @@ var tacticConditionSchema = external_exports.discriminatedUnion("kind", [
     kind: external_exports.literal("potions_below"),
     count: external_exports.number().int().min(1)
   }).strict().describe(
-    "Matches when usable potions remaining in this battle are strictly below count."
+    "Matches when the potions you can still drink in this battle, left in your bag and under potion_limit, are strictly below count."
   ),
   external_exports.object({ kind: external_exports.literal("enemy_weak_to"), damage_type: damageTypeSchema }).strict().describe("Matches when the enemy resistance for damage_type is negative."),
   external_exports.object({
@@ -24122,9 +24158,27 @@ var tacticConditionSchema = external_exports.discriminatedUnion("kind", [
     "Matches when the named enemy status has more than one tick left, or not; one tick left counts as missing."
   )
 ]);
+var battleItemIdsSchema = external_exports.array(itemIdSchema).min(1).refine(
+  (itemIds) => new Set(itemIds).size === itemIds.length,
+  "item_ids must not repeat"
+).optional();
 var tacticActionSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({ kind: external_exports.enum(["attack", "defend", "potion", "retreat"]) }).strict().describe(
-    "A potion action is usable only with a remaining potion and missing HP."
+  external_exports.object({ kind: external_exports.enum(["attack", "defend", "retreat"]) }).strict(),
+  external_exports.object({
+    kind: external_exports.literal("potion"),
+    item_ids: battleItemIdsSchema.describe(
+      "Potions this rule may drink. When omitted, any potion usable in battle."
+    )
+  }).strict().describe(
+    "Drinks a potion from your bag when one remains and HP is missing: the weakest that fills the missing HP, or the strongest when none does."
+  ),
+  external_exports.object({
+    kind: external_exports.literal("cure"),
+    item_ids: battleItemIdsSchema.describe(
+      "Cure items this rule may use. When omitted, any cure item usable in battle."
+    )
+  }).strict().describe(
+    "Uses a cure item from your bag when it removes a status on you: the one that removes the most of them, then the one that removes the fewest kinds of status."
   ),
   external_exports.object({ kind: external_exports.literal("ability"), ability_id: combatIdSchema }).strict().describe(
     "Uses the ability when it is unlocked, off cooldown, affordable in MP and its effect is currently applicable."
@@ -24142,13 +24196,7 @@ var tacticSchema = external_exports.object({
     "Evaluated from top to bottom each tick. The first matching, usable action runs; otherwise use a basic attack."
   ),
   potion_limit: external_exports.number().int().min(0).describe(
-    "Most potions one battle may use in total, capped by the bag at start. Each is consumed when used; zero disables potions."
-  ),
-  potion_items: external_exports.array(itemIdSchema).min(1).refine(
-    (itemIds) => new Set(itemIds).size === itemIds.length,
-    "potion_items must not repeat"
-  ).optional().describe(
-    "Item IDs of potions in drinking order. When omitted, drinks every potion usable in battle, weakest first."
+    "Most potions and cure items one battle may use in total, taken from your bag as they are used. Unused items stay in the bag; zero disables both."
   )
 }).strict().meta({ id: "Tactic" });
 var presetIdSchema = external_exports.enum(["safe", "aggressive"]);
@@ -24206,12 +24254,14 @@ var deliverGoalSchema = external_exports.object({
   ...characterTarget,
   goal_id: questNumber,
   item_id: itemIdSchema,
-  quantity: questNumber
+  quantity: questNumber,
+  allow_quality: itemQualitySchema.optional()
 }).strict();
 var claimQuestSchema = external_exports.object({
   ...characterTarget,
   quest_number: questNumber.optional(),
-  goal_id: questNumber.optional()
+  goal_id: questNumber.optional(),
+  allow_quality: itemQualitySchema.optional()
 }).strict().refine(
   (input2) => input2.quest_number !== void 0 !== (input2.goal_id !== void 0),
   { message: "Supply exactly one of quest_number and goal_id" }
@@ -24366,7 +24416,6 @@ var getGiftsSchema = external_exports.object({
 
 // src/protocol/market.ts
 var change = { ...characterTarget, request_id: uuidSchema };
-var marketQualitySchema = external_exports.enum(["standard", "fine", "superior"]);
 var positiveInteger = external_exports.number().int().positive();
 var marketSourceSchema = external_exports.enum(["carried", "storage"]);
 var marketSectionSchema = external_exports.enum(["orders", "listings", "trades"]);
@@ -24374,7 +24423,7 @@ var getMarketSchema = external_exports.object({
   ...characterTarget,
   town_id: locationIdSchema,
   item_id: itemIdSchema.optional(),
-  quality: marketQualitySchema.optional(),
+  quality: itemQualitySchema.optional(),
   levels: external_exports.number().int().min(1).optional(),
   cursor: external_exports.number().int().positive().optional(),
   max_price: positiveInteger.optional(),
@@ -24388,7 +24437,7 @@ var getMyMarketSchema = external_exports.object({
 var placeMarketSellOrderSchema = external_exports.object({
   ...change,
   item_id: itemIdSchema,
-  quality: marketQualitySchema,
+  quality: itemQualitySchema,
   quantity: positiveInteger,
   unit_price: positiveInteger,
   source: marketSourceSchema
@@ -24396,7 +24445,7 @@ var placeMarketSellOrderSchema = external_exports.object({
 var placeMarketBuyOrderSchema = external_exports.object({
   ...change,
   item_id: itemIdSchema,
-  quality: marketQualitySchema,
+  quality: itemQualitySchema,
   quantity: positiveInteger,
   unit_price: positiveInteger
 }).strict();
@@ -24428,7 +24477,8 @@ 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)
+  ).min(1),
+  allow_quality: itemQualitySchema.optional()
 }).strict();
 var extendHouseSchema = external_exports.object({ ...characterTarget, room: external_exports.enum(["storage"]) }).strict();
 var houseFurnitureSlotSchema = external_exports.enum([
@@ -24605,7 +24655,7 @@ var CredentialStore = class {
 // package.json
 var package_default = {
   name: "@clawsaga/cli",
-  version: "0.1.31",
+  version: "0.1.33",
   homepage: "https://clawsaga.net",
   repository: {
     type: "git",
@@ -24940,17 +24990,274 @@ var GameClient = class {
   }
 };
 
+// src/response-data-keys.generated.ts
+var responseDataKeys = {
+  monologue: ["monologue"],
+  encounters: ["encounters", "hunting_ground_thinned"],
+  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",
+    "fine_materials_unused",
+    "position",
+    "scenery"
+  ],
+  recipes: ["recipes"],
+  items: ["items"],
+  craft: [
+    "activity",
+    "capacity",
+    "status",
+    "last_result",
+    "fine_materials_unused",
+    "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}` : ""}`;
@@ -25250,6 +25557,13 @@ function acceptedActivityNote(activity, nextPollAfterSeconds, requestId) {
     request_id: requestId
   };
 }
+function withStartHints(started, completed) {
+  if (!started.hints?.length) return completed;
+  return {
+    ...completed,
+    hints: [...started.hints, ...completed.hints ?? []]
+  };
+}
 async function repeatActivity(client, path2, input2, values, count, options) {
   let confirmed = 0;
   let lastRequestId;
@@ -25274,12 +25588,15 @@ async function repeatActivity(client, path2, input2, values, count, options) {
     if (!started.ok) {
       return { ...started, repetition: summary("start_rejected") };
     }
-    const completed = started.data.last_result ? started : await waitForActivity(
-      client,
-      values,
+    const completed = started.data.last_result ? started : withStartHints(
       started,
-      options?.notify,
-      requestId
+      await waitForActivity(
+        client,
+        values,
+        started,
+        options?.notify,
+        requestId
+      )
     );
     if (!completed.ok) {
       return { ...completed, repetition: summary("activity_failed") };
@@ -25469,6 +25786,12 @@ var requestFlag = [
   "--request <uuid>",
   "Reuse the same ID and arguments after an uncertain result"
 ];
+var allowQualityFlag = [
+  "--allow-quality <quality>",
+  "Highest item quality to use (default standard). Lower qualities are used first",
+  false,
+  itemQualitySchema.options
+];
 var limitFlag = [
   "--limit <number>",
   "Entries per page; limits and defaults are set by the server"
@@ -25544,6 +25867,8 @@ var optionsSchema = external_exports.object({
   items: external_exports.string().optional(),
   gold: external_exports.string().optional(),
   quality: external_exports.string().optional(),
+  allowQuality: external_exports.string().optional(),
+  useFine: external_exports.boolean().optional(),
   levels: external_exports.string().optional(),
   maxPrice: external_exports.string().optional(),
   minDurability: external_exports.string().optional(),
@@ -25716,25 +26041,27 @@ var adventureCommands = {
     schema: startCombatSchema,
     input: { enemy: "enemy_id", preset: "preset", practice: "practice" },
     startsActivity: true,
-    // 同じ戦術ファイルを相手を変えて使い回せるよう、ファイルのenemy_idを任意とし、
-    // --enemyがあればそちらを使う。
+    // 同じ戦術ファイルを相手を変えて使い回したり練習で試したりできるよう、ファイルの
+    // enemy_idを任意とし、--enemyと--practiceがあればファイルの値より優先する。
     bodyInput: (values, body) => {
-      if (values.preset !== void 0 || values.practice !== void 0) {
+      if (values.preset !== void 0) {
         throw invalidArguments(
           ["input"],
-          "Use either --input or --preset/--practice. --enemy may be combined with --input."
+          "Use either --input or --preset. --enemy and --practice may be combined with --input."
         );
       }
-      if (values.enemy !== void 0) {
-        return { ...body, enemy_id: values.enemy };
-      }
-      if (!("enemy_id" in body)) {
+      const withFlags = {
+        ...body,
+        ...values.enemy !== void 0 ? { enemy_id: values.enemy } : {},
+        ...values.practice !== void 0 ? { practice: values.practice } : {}
+      };
+      if (!("enemy_id" in withFlags)) {
         throw invalidArguments(
           ["enemy_id"],
           "Pass --enemy or include enemy_id in the --input file."
         );
       }
-      return body;
+      return withFlags;
     },
     flags: [
       [
@@ -25749,7 +26076,7 @@ var adventureCommands = {
       ],
       noWaitFlag
     ],
-    help: "Start one battle while idle and wait for its outcome. Use flags, or --input with an optional one-battle tactic. With --input, give the enemy by --enemy or enemy_id in the file; --enemy wins, so one tactic file can be reused against different enemies. Do not combine tactic with preset. Inline tactics do not change the saved tactic used for ambushes. A raid boss enemy_id at its location uses a daily raid attempt (see raids).",
+    help: "Start one battle while idle and wait for its outcome. Use flags, or --input with an optional one-battle tactic. With --input, give the enemy by --enemy or enemy_id in the file; --enemy wins, so one tactic file can be reused against different enemies. Add --practice to try an --input tactic on a training dummy. Do not combine tactic with preset. Inline tactics do not change the saved tactic used for ambushes. A raid boss enemy_id at its location uses a daily raid attempt (see raids).",
     inputExample: { enemy_id: "wolf", tactic: { rules: [], potion_limit: 0 } },
     examples: [
       "clawsaga fight -c m7Qp2_aR9L-x --enemy wolf",
@@ -25886,21 +26213,24 @@ var adventureCommands = {
     input: {
       goal: ["goal_id", "number"],
       item: "item_id",
-      quantity: ["quantity", "number"]
+      quantity: ["quantity", "number"],
+      allowQuality: "allow_quality"
     },
     flags: [
       ["--goal <id>", "Joined world quest ID from quests", true],
       ["--item <id>", "Item ID to deliver", true],
-      ["--quantity <number>", "Number of standard-quality items", true]
+      ["--quantity <number>", "Number of items", true],
+      allowQualityFlag
     ],
-    help: "Deliver standard-quality items from your bag to a joined world quest while idle in its town. The items are consumed; data.delivered reports the points earned. Rewards are paid only by claiming after the world quest ends."
+    help: "Deliver items from your bag to a joined world quest while idle in its town. Only standard items are used unless --allow-quality permits higher ones, lower qualities first. The items are consumed; data.delivered reports the points earned. Rewards are paid only by claiming after the world quest ends."
   },
   "quest-claim": {
     path: "character/quests/claim",
     schema: claimQuestSchema,
     input: {
       quest: ["quest_number", "number"],
-      goal: ["goal_id", "number"]
+      goal: ["goal_id", "number"],
+      allowQuality: "allow_quality"
     },
     buildInput: exactlyOne(
       ["quest", "goal"],
@@ -25908,9 +26238,10 @@ var adventureCommands = {
     ),
     flags: [
       ["--quest <number>", "Quest number from quests or quest-accept"],
-      ["--goal <id>", "Ended world quest ID from quests"]
+      ["--goal <id>", "Ended world quest ID from quests"],
+      allowQualityFlag
     ],
-    help: "Claim when idle in the quest\u2019s report town. Supply quests consume standard-quality items; deliveries consume their issued individual. Check the deadline if present. --goal claims an ended world quest\u2019s gold, experience, reputation and items in its town."
+    help: "Claim when idle in the quest\u2019s report town. Supply quests consume standard items, or items up to --allow-quality, lower qualities first; deliveries consume their issued individual. Check the deadline if present. --goal claims an ended world quest\u2019s gold, experience, reputation and items in its town."
   },
   "quest-discard": {
     path: "character/quests/discard",
@@ -25944,7 +26275,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"
@@ -25955,7 +26286,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",
@@ -26003,7 +26334,7 @@ var adventureCommands = {
     path: "character/chat/send",
     schema: sendChatSchema,
     flags: [jsonFlag],
-    help: "Post a message to your current chat channel. Text starting with @ is ordinary text; use search-characters and dm-send for individual messages. Each successful call creates a new message.",
+    help: "Post a message of up to 400 Unicode code points to your current chat channel. Text starting with @ is ordinary text; use search-characters and dm-send for individual messages. Each successful call creates a new message.",
     inputExample: {
       text: "Greetings, fellow adventurers.",
       language: "en"
@@ -26466,15 +26797,17 @@ var houseCommands = {
     build: {
       path: "character/house/build",
       schema: buildHouseSchema,
+      input: { allowQuality: "allow_quality" },
       buildInput: addMaterials,
       flags: [
         [
           "--item <id:qty>",
-          "Comma-separated item_id:quantity pairs of standard-quality materials from your bag",
+          "Comma-separated item_id:quantity pairs of materials from your bag",
           true
-        ]
+        ],
+        allowQualityFlag
       ],
-      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.",
+      help: "Deliver materials from your bag to the room under construction while idle at your house. Only standard materials are used unless --allow-quality permits higher ones, lower qualities first; quality has no effect on the room. 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"
       ]
@@ -26551,7 +26884,7 @@ var houseCommands = {
 };
 
 // src/market-commands.ts
-var qualityChoices = marketQualitySchema.options;
+var qualityChoices = itemQualitySchema.options;
 var sourceChoices = marketSourceSchema.options;
 function marketWriteContext(values) {
   return {
@@ -26863,13 +27196,18 @@ var productionCommands = {
     schema: craftSchema,
     input: {
       recipe: "recipe_id",
-      maxFeePerLot: ["max_fee_per_lot", "number"]
+      maxFeePerLot: ["max_fee_per_lot", "number"],
+      useFine: "use_fine_materials"
     },
     startsActivity: true,
     repeat: { requestIdPerLot: true },
     autoRequestId: true,
     flags: [
       ["--recipe <id>", "Recipe ID from recipes", true],
+      [
+        "--use-fine",
+        "Use fine intermediate materials first, then standard ones. They raise the chance of a fine or superior result for equipment and furniture"
+      ],
       [
         "--max-fee-per-lot <gold>",
         "Refuse a lot whose gold fee is above this. Omit it to accept the fee the recipe lists"
@@ -26881,7 +27219,7 @@ var productionCommands = {
       ],
       noWaitFlag
     ],
-    help: "Craft goods from standard-quality materials while idle; wait for each lot. Each lot gets a new request ID. To retry one uncertain lot, keep its recipe and fee limit and use --request with --count 1. Wait for the whole command before starting another activity.",
+    help: "Craft goods while idle; wait for each lot. Only standard materials are used unless --use-fine is given. Each lot gets a new request ID. To retry one uncertain lot, keep its recipe and fee limit and use --request with --count 1. Wait for the whole command before starting another activity.",
     examples: [
       "clawsaga craft -c m7Qp2_aR9L-x --recipe wolf_jerky --count 3",
       "clawsaga craft -c m7Qp2_aR9L-x --recipe metal_ingot --max-fee-per-lot 10 --no-wait"
@@ -26977,7 +27315,7 @@ var productionCommands = {
         true
       ]
     ],
-    help: "Choose kit or npc repair explicitly at a town smithy while idle. Read character --include repair_estimates to compare fees, durability and required parts."
+    help: "Choose kit or npc repair explicitly at a town smithy while idle. Read character --include repair_estimates; each equipment row in data.inventory carries repair_estimate.kit and repair_estimate.npc with fees, durability and required kits."
   },
   "bag-expand": {
     path: "character/bag/expand",
@@ -27004,15 +27342,22 @@ var productionCommands = {
       input2.target = stack ? {
         kind: "stack",
         item_id: values.item,
-        quantity: values.quantity === void 0 ? void 0 : integerFlag("quantity", values.quantity)
+        quantity: values.quantity === void 0 ? void 0 : integerFlag("quantity", values.quantity),
+        ...values.quality === void 0 ? {} : { quality: values.quality }
       } : { kind: "individual", instance_id: values.instance };
     },
     flags: [
       ["--item <id>", "Stack item ID from inventory"],
       ["--quantity <number>", "Stack quantity to discard"],
+      [
+        "--quality <quality>",
+        "Stack quality (default standard)",
+        false,
+        itemQualitySchema.options
+      ],
       ["--instance <id>", "Item instance ID from inventory"]
     ],
-    help: "Permanently discard a standard-quality stack quantity or one item instance while idle.",
+    help: "Permanently discard a stack quantity (standard unless --quality is given) or one item instance while idle.",
     examples: [
       "clawsaga discard -c m7Qp2_aR9L-x --item wolf_meat --quantity 10",
       "clawsaga discard -c m7Qp2_aR9L-x --instance k3v9q2m7xa"
@@ -27045,160 +27390,27 @@ var gameCommands = {
   )
 };
 
-// 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"]
-};
-
 // 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"
@@ -27305,8 +27517,8 @@ function groupHelp(name, group) {
     usage: `clawsaga ${name} <command> [options]`,
     options: globalOptions.map((option) => helpOption(option, false)),
     examples: [],
-    commands: Object.entries(group.commands).map(([command2, definition]) => ({
-      name: `${name} ${command2}`,
+    commands: Object.entries(group.commands).map(([command, definition]) => ({
+      name: `${name} ${command}`,
       description: firstSentence(definition.help)
     }))
   };
@@ -27362,6 +27574,21 @@ 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;
@@ -27489,6 +27716,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", () => {
@@ -27505,29 +27733,18 @@ function createProgram(run, notify) {
     const groupCommand = program2.command(name).description(group.help);
     trackHelp(groupCommand, run, `clawsaga ${name}`, `clawsaga ${name} --help`);
     groupCommand.action(() => groupCommand.help());
-    for (const [command2, definition] of Object.entries(group.commands)) {
+    for (const [command, definition] of Object.entries(group.commands)) {
       addGameCommand(
         groupCommand,
         run,
         notify,
-        `${name} ${command2}`,
+        `${name} ${command}`,
         definition
       );
     }
   }
   return program2;
 }
-function trackHelp(command2, run, target2, helpCommand) {
-  command2.configureOutput({
-    outputError: () => {
-      run.helpCommand = helpCommand;
-    }
-  }).on("--help", () => {
-    run.helpTarget = target2;
-  }).hook("preAction", () => {
-    run.helpCommand = helpCommand;
-  });
-}
 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."
@@ -27583,21 +27800,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(
@@ -27606,19 +27825,19 @@ function addDocumentCommands(program2, run) {
   });
 }
 function addGameCommand(parent, run, notify, name, definition) {
-  const command2 = parent.command(name.slice(name.lastIndexOf(" ") + 1)).description(definition.help);
+  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,
@@ -27626,10 +27845,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.31",
+  "version": "0.1.33",
   "homepage": "https://clawsaga.net",
   "repository": {
     "type": "git",