@opentabs-dev/opentabs-plugin-ynab 0.0.86 → 0.0.87

package/dist/adapter.iife.js

@@ -14270,6 +14270,33 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   };
   var toMilliunits = (amount) => Math.round(amount * 1e3);
   var notTombstone = (x) => !x.is_tombstone;
+  var findCategory = (entities, id) => {
+    const c = (entities?.be_subcategories ?? []).find((s) => s.id === id && notTombstone(s));
+    if (!c) throw ToolError.notFound(`Category not found: ${id}`);
+    return c;
+  };
+  var findCategoryGroup = (entities, id) => {
+    const g = (entities?.be_master_categories ?? []).find((m) => m.id === id && notTombstone(m));
+    if (!g) throw ToolError.notFound(`Category group not found: ${id}`);
+    return g;
+  };
+  var assertCategoryGroupDeletable = (group) => {
+    if (group.deletable !== true) {
+      throw ToolError.validation(`Category group "${group.name}" is not deletable.`);
+    }
+  };
+  var assertCategoryDeletable = (category) => {
+    if (category.entities_account_id != null || category.type !== CATEGORY_TYPE_DEFAULT) {
+      throw ToolError.validation(`Category "${category.name}" is system-managed and cannot be deleted.`);
+    }
+  };
+  var nextTopSortableIndex = (rows, step = 10) => {
+    let min = 0;
+    for (const r of rows) {
+      if (typeof r.sortable_index === "number" && r.sortable_index < min) min = r.sortable_index;
+    }
+    return min - step;
+  };
   var userSchema = external_exports.object({
     id: external_exports.string().describe("User ID"),
     first_name: external_exports.string().describe("First name"),
@@ -14390,6 +14417,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     /** Category-to-category transfer. */
     MOVEMENT: "manual_movement"
   };
+  var GOAL_TYPE = {
+    /** "Set aside" or "Refill" — `goal_needs_whole_amount` differentiates. */
+    NEED: "NEED",
+    /** "Have a balance of" — no date, no cadence. */
+    TARGET_BALANCE: "TB",
+    /** "Have a balance of by date" — one-shot with `goal_target_date`. */
+    TARGET_BY_DATE: "TBD",
+    /** Debt payment goals on debt-account categories. */
+    DEBT: "DEBT",
+    /** Legacy "Monthly Funding". The modern UI no longer creates these but they
+        still exist on older categories and the API still honors them. */
+    MONTHLY_FUNDING: "MF"
+  };
+  var CATEGORY_TYPE_DEFAULT = "DFT";
   var SUBCATEGORY_BUDGET_PREFIX = "mcb";
   var MONTHLY_BUDGET_PREFIX = "mb";
   var toMonthKey = (month) => month.substring(0, 7);
@@ -14412,6 +14453,128 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     blue: "Blue",
     purple: "Purple"
   };
+  var cadenceWireValue = {
+    weekly: 2,
+    monthly: 1,
+    yearly: 13
+  };
+  var isValidCalendarDate = (s) => {
+    const parts = s.split("-").map(Number);
+    const year = parts[0] ?? 0;
+    const month = parts[1] ?? 0;
+    const day = parts[2] ?? 0;
+    if (month < 1 || month > 12) return false;
+    const maxDay = new Date(year, month, 0).getDate();
+    return day >= 1 && day <= maxDay;
+  };
+  var needGoalShape = {
+    target: external_exports.number().positive().describe("Goal amount in currency units (e.g. 50 for $50)"),
+    cadence: external_exports.enum(["weekly", "monthly", "yearly"]).optional().describe("How often the goal recurs. Defaults to monthly."),
+    every: external_exports.number().int().min(1).optional().describe("Multiplier on cadence (e.g. cadence=monthly + every=5 means every 5 months). Defaults to 1."),
+    day: external_exports.number().int().min(0).max(31).optional().describe("Day-of-week (0=Sunday, 6=Saturday) for weekly cadence, or day-of-month (1-31) for monthly cadence."),
+    start_date: external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD").refine(isValidCalendarDate, "Date must be a valid calendar date").optional().describe("First occurrence date (YYYY-MM-DD). Required for yearly cadence; optional for others.")
+  };
+  var yearlyNeedRefine = (data, ctx) => {
+    if (data.cadence === "yearly" && !data.start_date) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: 'start_date is required when cadence is "yearly"',
+        path: ["start_date"]
+      });
+    }
+  };
+  var needCadenceDayRefine = (data, ctx) => {
+    if (data.day === void 0) return;
+    const cadence = data.cadence ?? "monthly";
+    if (cadence === "weekly" && (data.day < 0 || data.day > 6)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "For weekly cadence, day must be 0\u20136 (0=Sunday, 6=Saturday)",
+        path: ["day"]
+      });
+    } else if (cadence === "monthly" && (data.day < 1 || data.day > 31)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "For monthly cadence, day must be 1\u201331",
+        path: ["day"]
+      });
+    } else if (cadence === "yearly") {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "For yearly cadence, use start_date to set the recurrence anchor instead of day",
+        path: ["day"]
+      });
+    }
+  };
+  var goalSpecSchema = external_exports.discriminatedUnion("type", [
+    external_exports.object({ type: external_exports.literal("set_aside"), ...needGoalShape }).strict().superRefine(yearlyNeedRefine).superRefine(needCadenceDayRefine),
+    external_exports.object({ type: external_exports.literal("refill"), ...needGoalShape }).strict().superRefine(yearlyNeedRefine).superRefine(needCadenceDayRefine),
+    external_exports.object({
+      type: external_exports.literal("target_balance"),
+      target: external_exports.number().positive().describe("Balance to maintain in currency units")
+    }).strict(),
+    external_exports.object({
+      type: external_exports.literal("target_by_date"),
+      target: external_exports.number().positive().describe("Target balance to have by the given date in currency units"),
+      date: external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD").refine(isValidCalendarDate, "Date must be a valid calendar date").describe("Target date YYYY-MM-DD")
+    }).strict(),
+    external_exports.object({
+      type: external_exports.literal("debt"),
+      target: external_exports.number().positive().describe("Monthly payment amount in currency units"),
+      day: external_exports.number().int().min(1).max(31).optional().describe("Day of month the payment is due (1-31). Defaults to 1.")
+    }).strict(),
+    external_exports.object({ type: external_exports.literal("none") }).strict()
+  ]);
+  var NO_GOAL_FIELDS = {
+    goal_type: null,
+    goal_created_on: null,
+    goal_needs_whole_amount: null,
+    goal_target_amount: 0,
+    goal_target_date: null,
+    goal_cadence: null,
+    goal_cadence_frequency: null,
+    goal_day: null
+  };
+  var buildGoalFields = (goal) => {
+    if (!goal || goal.type === "none") return { ...NO_GOAL_FIELDS };
+    const now = /* @__PURE__ */ new Date();
+    const createdOn = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-01`;
+    const base = { ...NO_GOAL_FIELDS, goal_created_on: createdOn };
+    switch (goal.type) {
+      case "set_aside":
+      case "refill": {
+        const cadence = goal.cadence ?? "monthly";
+        return {
+          ...base,
+          goal_type: GOAL_TYPE.NEED,
+          goal_needs_whole_amount: goal.type === "set_aside",
+          goal_target_amount: toMilliunits(goal.target),
+          goal_cadence: cadenceWireValue[cadence],
+          goal_cadence_frequency: goal.every ?? 1,
+          goal_day: cadence === "yearly" ? null : goal.day ?? null,
+          goal_target_date: goal.start_date ?? null
+        };
+      }
+      case "target_balance":
+        return { ...base, goal_type: GOAL_TYPE.TARGET_BALANCE, goal_target_amount: toMilliunits(goal.target) };
+      case "target_by_date":
+        return {
+          ...base,
+          goal_type: GOAL_TYPE.TARGET_BY_DATE,
+          goal_target_amount: toMilliunits(goal.target),
+          goal_target_date: goal.date
+        };
+      case "debt":
+        return {
+          ...base,
+          goal_type: GOAL_TYPE.DEBT,
+          goal_target_amount: toMilliunits(goal.target),
+          goal_cadence: cadenceWireValue.monthly,
+          goal_cadence_frequency: 1,
+          goal_day: goal.day ?? 1
+        };
+    }
+  };
   var resolvePayee = (existingPayees, payeeName) => {
     const target = payeeName.toLowerCase();
     const match = existingPayees.find((p) => notTombstone(p) && p.name?.toLowerCase() === target);
@@ -14434,7 +14597,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     };
     return { payeeId, newPayee };
   };
-  var buildAccountCalcMap = (entities) => new Map((entities.be_account_calculations ?? []).map((c) => [c.entities_account_id, c]));
+  var buildAccountCalcMap = (entities) => new Map(
+    (entities.be_account_calculations ?? []).filter((c) => c.entities_account_id).map((c) => [c.entities_account_id, c])
+  );
   var buildMonthlyBudgetCalcMap = (calcs) => {
     const map2 = /* @__PURE__ */ new Map();
     for (const calc of calcs) {
@@ -14481,7 +14646,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       budgeted: budget?.budgeted ?? c.budgeted,
       activity: (calc?.cash_outflows ?? 0) + (calc?.credit_outflows ?? 0),
       balance: calc?.balance ?? c.balance,
-      goal_target: calc?.goal_target ?? c.goal_target,
       goal_percentage_complete: calc?.goal_percentage_complete ?? c.goal_percentage_complete
     });
   };
@@ -14561,7 +14725,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     activity_milliunits: c.activity ?? 0,
     balance_milliunits: c.balance ?? 0,
     goal_type: c.goal_type ?? "",
-    goal_target: formatMilliunits(c.goal_target ?? 0),
+    // The "goal target" the user configured is stored on the category itself:
+    // - MF (legacy Monthly Funding): the static target lives in `monthly_funding`
+    // - All modern goal types (NEED, TB, TBD, DEBT): use `goal_target_amount`
+    // The calc's `goal_target` is YNAB's dynamically-computed "needed this month",
+    // which for refill goals returns max(0, target - current_balance) — surprising
+    // and not what users mean when they ask for the goal target.
+    goal_target: formatMilliunits(
+      (c.goal_type === GOAL_TYPE.MONTHLY_FUNDING ? c.monthly_funding : c.goal_target_amount) ?? 0
+    ),
     goal_percentage_complete: c.goal_percentage_complete ?? 0
   });
   var mapPayee = (p) => ({
@@ -14638,6 +14810,105 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     deleted: s.is_tombstone === true
   });
 
+  // src/tools/create-category.ts
+  var createCategory = defineTool({
+    name: "create_category",
+    displayName: "Create Category",
+    description: 'Create a new category in an existing category group. Optionally set an initial goal: "set_aside" (set aside X per cadence), "refill" (refill the balance up to X per cadence), "target_balance" (have a balance of X), or "target_by_date" (have a balance of X by a specific date). NEED-style goals (set_aside, refill) accept weekly/monthly/yearly cadence. Debt goals are not supported for new categories \u2014 they only apply to existing debt-account categories.',
+    summary: "Create a new budget category",
+    icon: "plus",
+    group: "Categories",
+    input: external_exports.object({
+      group_id: external_exports.string().min(1).describe("Category group ID to create the category in"),
+      name: external_exports.string().min(1).describe("Name of the new category"),
+      goal: goalSpecSchema.optional().describe("Optional initial goal for the category"),
+      note: external_exports.string().optional().describe("Optional note for the category")
+    }),
+    output: external_exports.object({
+      category: categorySchema
+    }),
+    handle: async (params) => {
+      if (params.goal?.type === "debt") {
+        throw ToolError.validation("Debt goals can only be set on debt-account categories.");
+      }
+      const planId = getPlanId();
+      const categoryId = crypto.randomUUID();
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      assertCategoryGroupDeletable(findCategoryGroup(budget.changed_entities, params.group_id));
+      const childCategories = (budget.changed_entities?.be_subcategories ?? []).filter(
+        (c) => c.entities_master_category_id === params.group_id
+      );
+      const monthKey = currentMonthKey();
+      const categoryEntry = {
+        id: categoryId,
+        is_tombstone: false,
+        entities_master_category_id: params.group_id,
+        entities_account_id: null,
+        internal_name: null,
+        sortable_index: nextTopSortableIndex(childCategories, 5),
+        name: params.name,
+        type: CATEGORY_TYPE_DEFAULT,
+        note: params.note ?? null,
+        monthly_funding: 0,
+        is_hidden: false,
+        pinned_index: null,
+        pinned_goal_index: null,
+        ...buildGoalFields(params.goal)
+      };
+      const budgetEntry = {
+        id: formatSubcategoryBudgetId(monthKey, categoryId),
+        is_tombstone: false,
+        entities_monthly_budget_id: formatMonthlyBudgetId(monthKey, planId),
+        entities_subcategory_id: categoryId,
+        budgeted: 0
+      };
+      await syncWrite(
+        planId,
+        {
+          be_subcategories: [categoryEntry],
+          be_monthly_subcategory_budgets: [budgetEntry]
+        },
+        serverKnowledge
+      );
+      return { category: mapCategory(categoryEntry) };
+    }
+  });
+
+  // src/tools/create-category-group.ts
+  var createCategoryGroup = defineTool({
+    name: "create_category_group",
+    displayName: "Create Category Group",
+    description: "Create a new category group in the active YNAB plan.",
+    summary: "Create a category group",
+    icon: "folder-plus",
+    group: "Categories",
+    input: external_exports.object({
+      name: external_exports.string().min(1).describe("Name of the new category group")
+    }),
+    output: external_exports.object({
+      group: categoryGroupSchema
+    }),
+    handle: async (params) => {
+      const planId = getPlanId();
+      const groupId = crypto.randomUUID();
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      const groupEntry = {
+        id: groupId,
+        is_tombstone: false,
+        internal_name: "",
+        deletable: true,
+        sortable_index: nextTopSortableIndex(budget.changed_entities?.be_master_categories ?? []),
+        name: params.name,
+        note: "",
+        is_hidden: false
+      };
+      await syncWrite(planId, { be_master_categories: [groupEntry] }, serverKnowledge);
+      return { group: mapCategoryGroup(groupEntry) };
+    }
+  });
+
   // src/tools/create-transaction.ts
   var createTransaction = defineTool({
     name: "create_transaction",
@@ -14733,6 +15004,71 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
+  // src/tools/delete-category.ts
+  var deleteCategory = defineTool({
+    name: "delete_category",
+    displayName: "Delete Category",
+    description: "Delete a category from the active YNAB plan. This is a soft delete (tombstone). Existing transactions assigned to this category remain in place but the category will no longer appear in budget views.",
+    summary: "Delete a category",
+    icon: "trash-2",
+    group: "Categories",
+    input: external_exports.object({
+      category_id: external_exports.string().min(1).describe("Category ID to delete")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean()
+    }),
+    handle: async (params) => {
+      const planId = getPlanId();
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      const existing2 = findCategory(budget.changed_entities, params.category_id);
+      assertCategoryDeletable(existing2);
+      await syncWrite(
+        planId,
+        { be_subcategories: [{ ...existing2, is_tombstone: true }] },
+        serverKnowledge
+      );
+      return { success: true };
+    }
+  });
+
+  // src/tools/delete-category-group.ts
+  var deleteCategoryGroup = defineTool({
+    name: "delete_category_group",
+    displayName: "Delete Category Group",
+    description: "Delete a category group and all of its child categories from the active YNAB plan. This is a soft delete (tombstone). Internal/non-deletable groups (Credit Card Payments, Hidden Categories, Internal Master Category) cannot be deleted.",
+    summary: "Delete a category group and its children",
+    icon: "folder-x",
+    group: "Categories",
+    input: external_exports.object({
+      group_id: external_exports.string().min(1).describe("Category group ID to delete")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean(),
+      deleted_category_count: external_exports.number().describe("Number of child categories that were also tombstoned")
+    }),
+    handle: async (params) => {
+      const planId = getPlanId();
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      const group = findCategoryGroup(budget.changed_entities, params.group_id);
+      assertCategoryGroupDeletable(group);
+      const childCategories = (budget.changed_entities?.be_subcategories ?? []).filter(
+        (c) => c.entities_master_category_id === params.group_id && notTombstone(c)
+      );
+      await syncWrite(
+        planId,
+        {
+          be_master_categories: [{ ...group, is_tombstone: true }],
+          be_subcategories: childCategories.map((c) => ({ ...c, is_tombstone: true }))
+        },
+        serverKnowledge
+      );
+      return { success: true, deleted_category_count: childCategories.length };
+    }
+  });
+
   // src/tools/delete-transaction.ts
   var deleteTransaction = defineTool({
     name: "delete_transaction",
@@ -15138,17 +15474,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       const monthlyBudgetId = formatMonthlyBudgetId(monthKey, planId);
       const budget = await syncBudget(planId);
       const serverKnowledge = budget.current_server_knowledge ?? 0;
-      const subcategories = budget.changed_entities?.be_subcategories ?? [];
       const existingBudgets = budget.changed_entities?.be_monthly_subcategory_budgets ?? [];
-      const findCategory = (id) => {
-        const c = subcategories.find((s) => s.id === id && notTombstone(s));
-        if (!c?.id) throw ToolError.notFound(`Category not found: ${id}`);
-        return { ...c, id: c.id };
-      };
-      const fromCategory = params.from_category_id ? findCategory(params.from_category_id) : null;
-      const toCategory = params.to_category_id ? findCategory(params.to_category_id) : null;
-      const fromBudgetId = fromCategory ? formatSubcategoryBudgetId(monthKey, fromCategory.id) : null;
-      const toBudgetId = toCategory ? formatSubcategoryBudgetId(monthKey, toCategory.id) : null;
+      const fromCategoryId = params.from_category_id;
+      const toCategoryId = params.to_category_id;
+      const fromCategory = fromCategoryId ? findCategory(budget.changed_entities, fromCategoryId) : null;
+      const toCategory = toCategoryId ? findCategory(budget.changed_entities, toCategoryId) : null;
+      const fromBudgetId = fromCategoryId ? formatSubcategoryBudgetId(monthKey, fromCategoryId) : null;
+      const toBudgetId = toCategoryId ? formatSubcategoryBudgetId(monthKey, toCategoryId) : null;
       const buildEntry = (categoryId, budgetId, signedDelta) => {
         const current = existingBudgets.find((b) => b.id === budgetId && notTombstone(b))?.budgeted ?? 0;
         return {
@@ -15160,9 +15492,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         };
       };
       const budgetEntries = [];
-      if (fromCategory && fromBudgetId) budgetEntries.push(buildEntry(fromCategory.id, fromBudgetId, -milliunits));
-      if (toCategory && toBudgetId) budgetEntries.push(buildEntry(toCategory.id, toBudgetId, milliunits));
-      const source = fromCategory && toCategory ? MONEY_MOVEMENT_SOURCE.MOVEMENT : MONEY_MOVEMENT_SOURCE.ASSIGN;
+      if (fromCategoryId && fromBudgetId) budgetEntries.push(buildEntry(fromCategoryId, fromBudgetId, -milliunits));
+      if (toCategoryId && toBudgetId) budgetEntries.push(buildEntry(toCategoryId, toBudgetId, milliunits));
+      const source = fromCategoryId && toCategoryId ? MONEY_MOVEMENT_SOURCE.MOVEMENT : MONEY_MOVEMENT_SOURCE.ASSIGN;
       const result = await syncWrite(
         planId,
         {
@@ -15198,6 +15530,96 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
+  // src/tools/snooze-category-goal.ts
+  var snoozeCategoryGoal = defineTool({
+    name: "snooze_category_goal",
+    displayName: "Snooze Category Goal",
+    description: "Snooze a category goal for a specific month so it does not appear as needing funding for that month. Pass snooze=false to un-snooze.",
+    summary: "Snooze a category goal for a month",
+    icon: "bell-off",
+    group: "Categories",
+    input: external_exports.object({
+      category_id: external_exports.string().min(1).describe("Category ID whose goal to snooze"),
+      month: external_exports.string().regex(/^\d{4}-\d{2}(-\d{2})?$/, "Month must be YYYY-MM or YYYY-MM-DD").describe("Month in YYYY-MM format (e.g. 2026-04)"),
+      snooze: external_exports.boolean().optional().describe("true to snooze (default), false to un-snooze")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean(),
+      snoozed_at: external_exports.string().nullable().describe("ISO timestamp the goal was snoozed at, or null if un-snoozed")
+    }),
+    handle: async (params) => {
+      const planId = getPlanId();
+      const monthKey = toMonthKey(params.month);
+      const budgetId = formatSubcategoryBudgetId(monthKey, params.category_id);
+      const monthlyBudgetId = formatMonthlyBudgetId(monthKey, planId);
+      const shouldSnooze = params.snooze ?? true;
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      const category = findCategory(budget.changed_entities, params.category_id);
+      if (!category.goal_type) {
+        throw ToolError.validation(`Category "${category.name}" has no goal to snooze.`);
+      }
+      const existing2 = (budget.changed_entities?.be_monthly_subcategory_budgets ?? []).find(
+        (b) => b.id === budgetId && notTombstone(b)
+      );
+      const snoozedAt = shouldSnooze ? (/* @__PURE__ */ new Date()).toISOString() : null;
+      const budgetEntry = {
+        ...existing2 ?? {},
+        id: budgetId,
+        is_tombstone: false,
+        entities_monthly_budget_id: monthlyBudgetId,
+        entities_subcategory_id: params.category_id,
+        budgeted: existing2?.budgeted ?? 0,
+        goal_snoozed_at: snoozedAt
+      };
+      await syncWrite(planId, { be_monthly_subcategory_budgets: [budgetEntry] }, serverKnowledge);
+      return { success: true, snoozed_at: snoozedAt };
+    }
+  });
+
+  // src/tools/update-category.ts
+  var updateCategory = defineTool({
+    name: "update_category",
+    displayName: "Update Category",
+    description: 'Rename a category, change its group, set/clear its goal, or hide/unhide it. Only specified fields change; omitted fields remain unchanged. Goal types: "set_aside" / "refill" (recurring NEED with optional cadence), "target_balance" (have $X), "target_by_date" (have $X by date), "debt" (recurring debt payment), or "none" to clear an existing goal.',
+    summary: "Update a category",
+    icon: "pencil",
+    group: "Categories",
+    input: external_exports.object({
+      category_id: external_exports.string().min(1).describe("Category ID to update"),
+      name: external_exports.string().min(1).optional().describe("New name"),
+      group_id: external_exports.string().min(1).optional().describe("New parent category group ID (to move the category)"),
+      goal: goalSpecSchema.optional().describe('New goal definition. Pass { type: "none" } to clear the goal.'),
+      hidden: external_exports.boolean().optional().describe("Hide or unhide the category"),
+      note: external_exports.string().optional().describe("New note (pass empty string to clear)")
+    }),
+    output: external_exports.object({
+      category: categorySchema
+    }),
+    handle: async (params) => {
+      const planId = getPlanId();
+      const budget = await syncBudget(planId);
+      const serverKnowledge = budget.current_server_knowledge ?? 0;
+      const existing2 = findCategory(budget.changed_entities, params.category_id);
+      if (params.group_id) {
+        assertCategoryGroupDeletable(findCategoryGroup(budget.changed_entities, params.group_id));
+      }
+      if (params.goal?.type === "debt" && existing2.entities_account_id == null) {
+        throw ToolError.validation("Debt goals can only be set on debt-account categories.");
+      }
+      const updated = {
+        ...existing2,
+        name: params.name ?? existing2.name,
+        entities_master_category_id: params.group_id ?? existing2.entities_master_category_id,
+        is_hidden: params.hidden ?? existing2.is_hidden,
+        note: params.note ?? existing2.note,
+        ...params.goal !== void 0 ? buildGoalFields(params.goal) : {}
+      };
+      await syncWrite(planId, { be_subcategories: [updated] }, serverKnowledge);
+      return { category: mapCategory(updated) };
+    }
+  });
+
   // src/tools/update-category-budget.ts
   var updateCategoryBudget = defineTool({
     name: "update_category_budget",
@@ -15223,12 +15645,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       const monthlyBudgetId = formatMonthlyBudgetId(monthKey, planId);
       const budget = await syncBudget(planId);
       const serverKnowledge = budget.current_server_knowledge ?? 0;
-      const category = (budget.changed_entities?.be_subcategories ?? []).find(
-        (c) => c.id === params.category_id && notTombstone(c)
-      );
-      if (!category) {
-        throw ToolError.notFound(`Category not found: ${params.category_id}`);
-      }
+      const category = findCategory(budget.changed_entities, params.category_id);
       const existingBudget = (budget.changed_entities?.be_monthly_subcategory_budgets ?? []).find(
         (b) => b.id === budgetId && notTombstone(b)
       );
@@ -15394,8 +15811,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       getAccount,
       // Categories
       listCategories,
+      createCategory,
+      updateCategory,
+      deleteCategory,
+      createCategoryGroup,
+      deleteCategoryGroup,
       updateCategoryBudget,
       moveCategoryBudget,
+      snoozeCategoryGoal,
       // Payees
       listPayees,
       // Transactions
@@ -15416,7 +15839,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   };
   var src_default = new YnabPlugin();
 
-  // dist/_adapter_entry_fb321989-7b03-4647-9b5e-64822784cb35.ts
+  // dist/_adapter_entry_0fc84288-9dca-44bb-92da-639aeea53a88.ts
   if (!globalThis.__openTabs) {
     globalThis.__openTabs = {};
   } else {
@@ -15632,5 +16055,5 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     };
     delete src_default.onDeactivate;
   }
-})();(function(){var o=(globalThis).__openTabs;if(o&&o.adapters&&o.adapters["ynab"]){var a=o.adapters["ynab"];a.__adapterHash="dddcb110d2a66a4da7a57c142d0df2274bcc27f65c27b3a8d89c81d827caa8de";if(a.tools&&Array.isArray(a.tools)){for(var i=0;i<a.tools.length;i++){Object.freeze(a.tools[i]);}Object.freeze(a.tools);}Object.freeze(a);Object.defineProperty(o.adapters,"ynab",{value:a,writable:false,configurable:false,enumerable:true});Object.defineProperty(o,"adapters",{value:o.adapters,writable:false,configurable:false});}})();
+})();(function(){var o=(globalThis).__openTabs;if(o&&o.adapters&&o.adapters["ynab"]){var a=o.adapters["ynab"];a.__adapterHash="3a2d11d4883f6b89713b9ed3995d0c919e24e6ae5699ae84dc071e130223def6";if(a.tools&&Array.isArray(a.tools)){for(var i=0;i<a.tools.length;i++){Object.freeze(a.tools[i]);}Object.freeze(a.tools);}Object.freeze(a);Object.defineProperty(o.adapters,"ynab",{value:a,writable:false,configurable:false,enumerable:true});Object.defineProperty(o,"adapters",{value:o.adapters,writable:false,configurable:false});}})();
 //# sourceMappingURL=adapter.iife.js.map