@opentabs-dev/opentabs-plugin-ynab 0.0.74

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { OpenTabsPlugin } from '@opentabs-dev/plugin-sdk';
+import type { ToolDefinition } from '@opentabs-dev/plugin-sdk';
+declare class YnabPlugin extends OpenTabsPlugin {
+    readonly name = "ynab";
+    readonly description = "OpenTabs plugin for YNAB (You Need A Budget)";
+    readonly displayName = "YNAB";
+    readonly urlPatterns: string[];
+    readonly homepage = "https://app.ynab.com";
+    readonly tools: ToolDefinition[];
+    isReady(): Promise<boolean>;
+}
+declare const _default: YnabPlugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAgC/D,cAAM,UAAW,SAAQ,cAAc;IACrC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,kDAAkD;IACtE,SAAkB,WAAW,UAAU;IACvC,QAAQ,CAAC,WAAW,WAA0B;IAC9C,SAAkB,QAAQ,0BAA0B;IACpD,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAuB9B;IAEI,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAIlC;;AAED,wBAAgC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+import { OpenTabsPlugin } from '@opentabs-dev/plugin-sdk';
+import { isAuthenticated, waitForAuth } from './ynab-api.js';
+// Account
+import { getCurrentUser } from './tools/get-current-user.js';
+// Plans
+import { getPlan } from './tools/get-plan.js';
+// Accounts
+import { listAccounts } from './tools/list-accounts.js';
+import { getAccount } from './tools/get-account.js';
+// Categories
+import { listCategories } from './tools/list-categories.js';
+import { updateCategoryBudget } from './tools/update-category-budget.js';
+// Payees
+import { listPayees } from './tools/list-payees.js';
+// Transactions
+import { listTransactions } from './tools/list-transactions.js';
+import { getTransaction } from './tools/get-transaction.js';
+import { createTransaction } from './tools/create-transaction.js';
+import { updateTransaction } from './tools/update-transaction.js';
+import { deleteTransaction } from './tools/delete-transaction.js';
+import { listScheduledTransactions } from './tools/list-scheduled-transactions.js';
+// Months
+import { listMonths } from './tools/list-months.js';
+import { getMonth } from './tools/get-month.js';
+class YnabPlugin extends OpenTabsPlugin {
+    name = 'ynab';
+    description = 'OpenTabs plugin for YNAB (You Need A Budget)';
+    displayName = 'YNAB';
+    urlPatterns = ['*://app.ynab.com/*'];
+    homepage = 'https://app.ynab.com';
+    tools = [
+        // Account
+        getCurrentUser,
+        // Plans
+        getPlan,
+        // Accounts
+        listAccounts,
+        getAccount,
+        // Categories
+        listCategories,
+        updateCategoryBudget,
+        // Payees
+        listPayees,
+        // Transactions
+        listTransactions,
+        getTransaction,
+        createTransaction,
+        updateTransaction,
+        deleteTransaction,
+        listScheduledTransactions,
+        // Months
+        listMonths,
+        getMonth,
+    ];
+    async isReady() {
+        if (isAuthenticated())
+            return true;
+        return waitForAuth();
+    }
+}
+export default new YnabPlugin();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE7D,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,QAAQ;AACR,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,UAAW,SAAQ,cAAc;IAC5B,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,8CAA8C,CAAC;IACpD,WAAW,GAAG,MAAM,CAAC;IAC9B,WAAW,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC5B,QAAQ,GAAG,sBAAsB,CAAC;IAC3C,KAAK,GAAqB;QACjC,UAAU;QACV,cAAc;QACd,QAAQ;QACR,OAAO;QACP,WAAW;QACX,YAAY;QACZ,UAAU;QACV,aAAa;QACb,cAAc;QACd,oBAAoB;QACpB,SAAS;QACT,UAAU;QACV,eAAe;QACf,gBAAgB;QAChB,cAAc;QACd,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;QACjB,yBAAyB;QACzB,SAAS;QACT,UAAU;QACV,QAAQ;KACT,CAAC;IAEF,KAAK,CAAC,OAAO;QACX,IAAI,eAAe,EAAE;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;CACF;AAED,eAAe,IAAI,UAAU,EAAE,CAAC"}

package/dist/tools/create-transaction.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export declare const createTransaction: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    account_id: z.ZodString;
+    date: z.ZodString;
+    amount: z.ZodNumber;
+    payee_name: z.ZodOptional<z.ZodString>;
+    payee_id: z.ZodOptional<z.ZodString>;
+    category_id: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    cleared: z.ZodOptional<z.ZodEnum<{
+        cleared: "cleared";
+        uncleared: "uncleared";
+        reconciled: "reconciled";
+    }>>;
+    approved: z.ZodOptional<z.ZodBoolean>;
+    flag_color: z.ZodOptional<z.ZodEnum<{
+        red: "red";
+        orange: "orange";
+        yellow: "yellow";
+        green: "green";
+        blue: "blue";
+        purple: "purple";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    transaction: z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        amount: z.ZodString;
+        amount_milliunits: z.ZodNumber;
+        memo: z.ZodString;
+        cleared: z.ZodString;
+        approved: z.ZodBoolean;
+        flag_color: z.ZodString;
+        flag_name: z.ZodString;
+        account_id: z.ZodString;
+        account_name: z.ZodString;
+        payee_id: z.ZodString;
+        payee_name: z.ZodString;
+        category_id: z.ZodString;
+        category_name: z.ZodString;
+        transfer_account_id: z.ZodString;
+        import_id: z.ZodString;
+        deleted: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=create-transaction.d.ts.map

package/dist/tools/create-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-transaction.d.ts","sourceRoot":"","sources":["../../src/tools/create-transaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0D5B,CAAC"}

package/dist/tools/create-transaction.js

@@ -0,0 +1,57 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { getPlanId, syncWrite } from '../ynab-api.js';
+import { mapTransaction, transactionSchema } from './schemas.js';
+export const createTransaction = defineTool({
+    name: 'create_transaction',
+    displayName: 'Create Transaction',
+    description: 'Create a new transaction in the active YNAB plan. Amount is in currency units (e.g. -42.50 for a $42.50 expense, 1500 for $1500 income). Negative amounts are outflows (expenses), positive amounts are inflows (income).',
+    summary: 'Create a new transaction',
+    icon: 'plus',
+    group: 'Transactions',
+    input: z.object({
+        account_id: z.string().min(1).describe('Account ID to create the transaction in'),
+        date: z.string().min(1).describe('Transaction date in YYYY-MM-DD format'),
+        amount: z
+            .number()
+            .describe('Amount in currency units (negative for expenses, positive for income). E.g. -42.50 for a $42.50 expense.'),
+        payee_name: z.string().optional().describe('Payee name (creates new payee if not found)'),
+        payee_id: z.string().optional().describe('Existing payee ID (takes precedence over payee_name)'),
+        category_id: z.string().optional().describe('Category ID to assign'),
+        memo: z.string().optional().describe('Transaction memo'),
+        cleared: z.enum(['cleared', 'uncleared', 'reconciled']).optional().describe('Cleared status (default uncleared)'),
+        approved: z.boolean().optional().describe('Whether the transaction is approved (default true)'),
+        flag_color: z.enum(['red', 'orange', 'yellow', 'green', 'blue', 'purple']).optional().describe('Flag color'),
+    }),
+    output: z.object({
+        transaction: transactionSchema,
+    }),
+    handle: async (params) => {
+        const planId = getPlanId();
+        const milliunits = Math.round(params.amount * 1000);
+        const txId = crypto.randomUUID();
+        const transaction = {
+            id: txId,
+            entities_account_id: params.account_id,
+            date: params.date,
+            amount: milliunits,
+            cleared: params.cleared ?? 'uncleared',
+            approved: params.approved ?? true,
+            memo: params.memo ?? null,
+            flag_color: params.flag_color ?? null,
+            entities_payee_id: params.payee_id ?? null,
+            payee_name: params.payee_name ?? null,
+            entities_subcategory_id: params.category_id ?? null,
+            is_tombstone: false,
+        };
+        const result = await syncWrite(planId, {
+            be_transactions: [transaction],
+        });
+        const saved = result.changed_entities?.be_transactions?.[0];
+        if (!saved) {
+            throw ToolError.internal('Transaction was created but no data was returned');
+        }
+        return { transaction: mapTransaction(saved) };
+    },
+});
+//# sourceMappingURL=create-transaction.js.map

package/dist/tools/create-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-transaction.js","sourceRoot":"","sources":["../../src/tools/create-transaction.ts"],"names":[],"mappings":"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"}

package/dist/tools/delete-transaction.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const deleteTransaction: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    transaction_id: z.ZodString;
+    account_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodBoolean;
+}, z.core.$strip>>;
+//# sourceMappingURL=delete-transaction.d.ts.map

package/dist/tools/delete-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-transaction.d.ts","sourceRoot":"","sources":["../../src/tools/delete-transaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;kBA6B5B,CAAC"}

package/dist/tools/delete-transaction.js

@@ -0,0 +1,32 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { getPlanId, syncWrite } from '../ynab-api.js';
+export const deleteTransaction = defineTool({
+    name: 'delete_transaction',
+    displayName: 'Delete Transaction',
+    description: 'Delete a transaction from the active YNAB plan. This marks the transaction as deleted (soft delete).',
+    summary: 'Delete a transaction',
+    icon: 'trash-2',
+    group: 'Transactions',
+    input: z.object({
+        transaction_id: z.string().min(1).describe('Transaction ID to delete'),
+        account_id: z.string().min(1).describe('Account ID the transaction belongs to'),
+    }),
+    output: z.object({
+        success: z.boolean().describe('Whether the operation succeeded'),
+    }),
+    handle: async (params) => {
+        const planId = getPlanId();
+        await syncWrite(planId, {
+            be_transactions: [
+                {
+                    id: params.transaction_id,
+                    entities_account_id: params.account_id,
+                    is_tombstone: true,
+                },
+            ],
+        });
+        return { success: true };
+    },
+});
+//# sourceMappingURL=delete-transaction.js.map

package/dist/tools/delete-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-transaction.js","sourceRoot":"","sources":["../../src/tools/delete-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,sGAAsG;IACnH,OAAO,EAAE,sBAAsB;IAC/B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KAChF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACjE,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,MAAM,SAAS,CAAC,MAAM,EAAE;YACtB,eAAe,EAAE;gBACf;oBACE,EAAE,EAAE,MAAM,CAAC,cAAc;oBACzB,mBAAmB,EAAE,MAAM,CAAC,UAAU;oBACtC,YAAY,EAAE,IAAI;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-account.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const getAccount: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    account_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    account: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+        on_budget: z.ZodBoolean;
+        closed: z.ZodBoolean;
+        balance: z.ZodString;
+        balance_milliunits: z.ZodNumber;
+        cleared_balance: z.ZodString;
+        uncleared_balance: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-account.d.ts.map

package/dist/tools/get-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-account.d.ts","sourceRoot":"","sources":["../../src/tools/get-account.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;kBAgCrB,CAAC"}

package/dist/tools/get-account.js

@@ -0,0 +1,34 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { catalog, getPlanId } from '../ynab-api.js';
+import { accountSchema, mapAccount } from './schemas.js';
+export const getAccount = defineTool({
+    name: 'get_account',
+    displayName: 'Get Account',
+    description: 'Get details for a specific account in the active YNAB plan by its ID. Returns name, type, balances, and on-budget status.',
+    summary: 'Get account details by ID',
+    icon: 'landmark',
+    group: 'Accounts',
+    input: z.object({
+        account_id: z.string().min(1).describe('Account ID to retrieve'),
+    }),
+    output: z.object({
+        account: accountSchema,
+    }),
+    handle: async (params) => {
+        const planId = getPlanId();
+        const result = await catalog('syncBudgetData', {
+            budget_version_id: planId,
+            starting_device_knowledge: 0,
+            ending_device_knowledge: 0,
+            device_knowledge_of_server: 0,
+        });
+        const raw = result.changed_entities?.be_accounts ?? [];
+        const account = raw.find(a => a.id === params.account_id && !a.is_tombstone);
+        if (!account) {
+            throw ToolError.notFound(`Account not found: ${params.account_id}`);
+        }
+        return { account: mapAccount(account) };
+    },
+});
+//# sourceMappingURL=get-account.js.map

package/dist/tools/get-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-account.js","sourceRoot":"","sources":["../../src/tools/get-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAMzD,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,aAAa;IAC1B,WAAW,EACT,2HAA2H;IAC7H,OAAO,EAAE,2BAA2B;IACpC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACjE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,aAAa;KACvB,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAa,gBAAgB,EAAE;YACzD,iBAAiB,EAAE,MAAM;YACzB,yBAAyB,EAAE,CAAC;YAC5B,uBAAuB,EAAE,CAAC;YAC1B,0BAA0B,EAAE,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAI,MAAuD,CAAC,gBAAgB,EAAE,WAAW,IAAI,EAAE,CAAC;QACzG,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAE7E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,QAAQ,CAAC,sBAAsB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-current-user.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const getCurrentUser: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+        first_name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-current-user.d.ts.map

package/dist/tools/get-current-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current-user.d.ts","sourceRoot":"","sources":["../../src/tools/get-current-user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc;;;;;;kBAazB,CAAC"}

package/dist/tools/get-current-user.js

@@ -0,0 +1,19 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { api } from '../ynab-api.js';
+import { mapUser, userSchema } from './schemas.js';
+export const getCurrentUser = defineTool({
+    name: 'get_current_user',
+    displayName: 'Get Current User',
+    description: 'Get the profile of the currently authenticated YNAB user including name and email.',
+    summary: 'Get your YNAB user profile',
+    icon: 'user',
+    group: 'Account',
+    input: z.object({}),
+    output: z.object({ user: userSchema }),
+    handle: async () => {
+        const data = await api('/user');
+        return { user: mapUser(data) };
+    },
+});
+//# sourceMappingURL=get-current-user.js.map

package/dist/tools/get-current-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current-user.js","sourceRoot":"","sources":["../../src/tools/get-current-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,oFAAoF;IACjG,OAAO,EAAE,4BAA4B;IACrC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACtC,MAAM,EAAE,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAU,OAAO,CAAC,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-month.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const getMonth: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    month: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    month: z.ZodObject<{
+        month: z.ZodString;
+        income: z.ZodString;
+        budgeted: z.ZodString;
+        activity: z.ZodString;
+        to_be_budgeted: z.ZodString;
+        income_milliunits: z.ZodNumber;
+        budgeted_milliunits: z.ZodNumber;
+        activity_milliunits: z.ZodNumber;
+        to_be_budgeted_milliunits: z.ZodNumber;
+        age_of_money: z.ZodNumber;
+    }, z.core.$strip>;
+    categories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category_group_id: z.ZodString;
+        name: z.ZodString;
+        hidden: z.ZodBoolean;
+        budgeted: z.ZodString;
+        activity: z.ZodString;
+        balance: z.ZodString;
+        budgeted_milliunits: z.ZodNumber;
+        activity_milliunits: z.ZodNumber;
+        balance_milliunits: z.ZodNumber;
+        goal_type: z.ZodString;
+        goal_target: z.ZodString;
+        goal_percentage_complete: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-month.d.ts.map

package/dist/tools/get-month.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-month.d.ts","sourceRoot":"","sources":["../../src/tools/get-month.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyEnB,CAAC"}

package/dist/tools/get-month.js

@@ -0,0 +1,70 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { catalog, getPlanId } from '../ynab-api.js';
+import { categorySchema, mapCategory, mapMonth, monthSchema } from './schemas.js';
+export const getMonth = defineTool({
+    name: 'get_month',
+    displayName: 'Get Month',
+    description: 'Get budget summary and category details for a specific month. Returns the month overview (income, budgeted, activity, Ready to Assign) plus per-category breakdowns. Month format is YYYY-MM-DD using the first of the month (e.g. 2026-03-01).',
+    summary: 'Get budget details for a month',
+    icon: 'calendar',
+    group: 'Months',
+    input: z.object({
+        month: z.string().min(1).describe('Month in YYYY-MM-DD format (first of month, e.g. 2026-03-01)'),
+    }),
+    output: z.object({
+        month: monthSchema,
+        categories: z.array(categorySchema).describe('Category budgets for this month'),
+    }),
+    handle: async (params) => {
+        const planId = getPlanId();
+        const result = await catalog('syncBudgetData', {
+            budget_version_id: planId,
+            starting_device_knowledge: 0,
+            ending_device_knowledge: 0,
+            device_knowledge_of_server: 0,
+        });
+        const entities = result.changed_entities;
+        const rawMonths = entities?.be_monthly_budgets ?? [];
+        const monthData = rawMonths.find(m => m.month === params.month && !m.is_tombstone);
+        if (!monthData) {
+            throw ToolError.notFound(`Month not found: ${params.month}`);
+        }
+        // Find the matching monthly budget calculation for aggregates
+        const monthlyCalcs = entities?.be_monthly_budget_calculations ?? [];
+        const monthCalc = monthlyCalcs.find(c => {
+            const budgetId = c.entities_monthly_budget_id;
+            return budgetId && budgetId.replace('mb/', '') === params.month;
+        });
+        const rawCategories = (entities?.be_subcategories ?? []).filter(c => !c.is_tombstone && c.is_hidden !== true);
+        // Map subcategory budget calculations by category ID
+        // entity_id format: mcbc/YYYY-MM/category-id
+        const subcatCalcs = entities?.be_monthly_subcategory_budget_calculations ?? [];
+        const calcMap = new Map();
+        for (const calc of subcatCalcs) {
+            const entityId = calc.entities_monthly_subcategory_budget_id;
+            if (entityId) {
+                const parts = entityId.split('/');
+                const categoryId = parts.length >= 3 ? parts.slice(2).join('/') : entityId;
+                calcMap.set(categoryId, calc);
+            }
+        }
+        const categories = rawCategories.map(c => {
+            const calc = calcMap.get(c.id ?? '');
+            return mapCategory({
+                ...c,
+                budgeted: calc?.budgeted ?? c.budgeted,
+                activity: calc?.activity ?? c.activity,
+                balance: calc?.balance ?? c.balance,
+                goal_type: calc?.goal_type ?? c.goal_type,
+                goal_target: calc?.goal_target ?? c.goal_target,
+                goal_percentage_complete: calc?.goal_percentage_complete ?? c.goal_percentage_complete,
+            });
+        });
+        return {
+            month: mapMonth(monthData, monthCalc),
+            categories,
+        };
+    },
+});
+//# sourceMappingURL=get-month.js.map

package/dist/tools/get-month.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-month.js","sourceRoot":"","sources":["../../src/tools/get-month.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-plan.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const getPlan: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    plan: z.ZodObject<{
+        id: z.ZodString;
+        budget_id: z.ZodString;
+        name: z.ZodString;
+        date_format: z.ZodString;
+        currency_symbol: z.ZodString;
+        currency_iso_code: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-plan.d.ts.map

package/dist/tools/get-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-plan.d.ts","sourceRoot":"","sources":["../../src/tools/get-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,OAAO;;;;;;;;;kBAiBlB,CAAC"}

package/dist/tools/get-plan.js

@@ -0,0 +1,22 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { catalog, getPlanId } from '../ynab-api.js';
+import { mapPlan, planSchema } from './schemas.js';
+export const getPlan = defineTool({
+    name: 'get_plan',
+    displayName: 'Get Plan',
+    description: 'Get details about the currently active YNAB plan (budget), including name, currency, and date format. The plan ID is extracted from the current URL.',
+    summary: 'Get the active plan details',
+    icon: 'wallet',
+    group: 'Plans',
+    input: z.object({}),
+    output: z.object({ plan: planSchema }),
+    handle: async () => {
+        const planId = getPlanId();
+        const result = await catalog('getInitialUserData', {
+            device_info: { id: planId, device_os: 'web' },
+        });
+        return { plan: mapPlan(result.budget_version) };
+    },
+});
+//# sourceMappingURL=get-plan.js.map

package/dist/tools/get-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-plan.js","sourceRoot":"","sources":["../../src/tools/get-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAMnD,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EACT,sJAAsJ;IACxJ,OAAO,EAAE,6BAA6B;IACtC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACtC,MAAM,EAAE,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAkB,oBAAoB,EAAE;YAClE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;SAC9C,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,cAAyB,CAAC,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-transaction.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const getTransaction: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    transaction_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    transaction: z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        amount: z.ZodString;
+        amount_milliunits: z.ZodNumber;
+        memo: z.ZodString;
+        cleared: z.ZodString;
+        approved: z.ZodBoolean;
+        flag_color: z.ZodString;
+        flag_name: z.ZodString;
+        account_id: z.ZodString;
+        account_name: z.ZodString;
+        payee_id: z.ZodString;
+        payee_name: z.ZodString;
+        category_id: z.ZodString;
+        category_name: z.ZodString;
+        transfer_account_id: z.ZodString;
+        import_id: z.ZodString;
+        deleted: z.ZodBoolean;
+    }, z.core.$strip>;
+    subtransactions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        transaction_id: z.ZodString;
+        amount: z.ZodString;
+        amount_milliunits: z.ZodNumber;
+        memo: z.ZodString;
+        payee_id: z.ZodString;
+        payee_name: z.ZodString;
+        category_id: z.ZodString;
+        category_name: z.ZodString;
+        transfer_account_id: z.ZodString;
+        deleted: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-transaction.d.ts.map

package/dist/tools/get-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transaction.d.ts","sourceRoot":"","sources":["../../src/tools/get-transaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0CzB,CAAC"}

package/dist/tools/get-transaction.js

@@ -0,0 +1,43 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { catalog, getPlanId } from '../ynab-api.js';
+import { mapSubtransaction, mapTransaction, subtransactionSchema, transactionSchema } from './schemas.js';
+export const getTransaction = defineTool({
+    name: 'get_transaction',
+    displayName: 'Get Transaction',
+    description: 'Get details for a specific transaction by its ID. Returns full transaction data including any split subtransactions.',
+    summary: 'Get transaction details by ID',
+    icon: 'receipt',
+    group: 'Transactions',
+    input: z.object({
+        transaction_id: z.string().min(1).describe('Transaction ID to retrieve'),
+    }),
+    output: z.object({
+        transaction: transactionSchema,
+        subtransactions: z.array(subtransactionSchema).describe('Split subtransactions (empty if not a split)'),
+    }),
+    handle: async (params) => {
+        const planId = getPlanId();
+        const result = await catalog('syncBudgetData', {
+            budget_version_id: planId,
+            starting_device_knowledge: 0,
+            ending_device_knowledge: 0,
+            device_knowledge_of_server: 0,
+        });
+        const entities = result.changed_entities;
+        const raw = entities?.be_transactions ?? [];
+        const tx = raw.find(t => t.id === params.transaction_id && !t.is_tombstone);
+        if (!tx) {
+            throw ToolError.notFound(`Transaction not found: ${params.transaction_id}`);
+        }
+        const allSubs = entities?.be_subtransactions ?? [];
+        const subtransactions = allSubs
+            .filter(s => s.entities_transaction_id === params.transaction_id && !s.is_tombstone)
+            .map(mapSubtransaction);
+        return {
+            transaction: mapTransaction(tx),
+            subtransactions,
+        };
+    },
+});
+//# sourceMappingURL=get-transaction.js.map

package/dist/tools/get-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transaction.js","sourceRoot":"","sources":["../../src/tools/get-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAO1G,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EACT,sHAAsH;IACxH,OAAO,EAAE,+BAA+B;IACxC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KACzE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,iBAAiB;QAC9B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACxG,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAa,gBAAgB,EAAE;YACzD,iBAAiB,EAAE,MAAM;YACzB,yBAAyB,EAAE,CAAC;YAC5B,uBAAuB,EAAE,CAAC;YAC1B,0BAA0B,EAAE,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAI,MAAuD,CAAC,gBAAgB,CAAC;QAC3F,MAAM,GAAG,GAAG,QAAQ,EAAE,eAAe,IAAI,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAE5E,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,SAAS,CAAC,QAAQ,CAAC,0BAA0B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,EAAE,kBAAkB,IAAI,EAAE,CAAC;QACnD,MAAM,eAAe,GAAG,OAAO;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,KAAK,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;aACnF,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAE1B,OAAO;YACL,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;YAC/B,eAAe;SAChB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/list-accounts.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const listAccounts: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    include_closed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    accounts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+        on_budget: z.ZodBoolean;
+        closed: z.ZodBoolean;
+        balance: z.ZodString;
+        balance_milliunits: z.ZodNumber;
+        cleared_balance: z.ZodString;
+        uncleared_balance: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=list-accounts.d.ts.map

package/dist/tools/list-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.d.ts","sourceRoot":"","sources":["../../src/tools/list-accounts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;kBAgCvB,CAAC"}