@dizzlkheinz/ynab-mcpb 0.17.0 → 0.17.1

package/dist/server/YNABMCPServer.d.ts

@@ -33,39 +33,43 @@ export declare class YNABMCPServer {
     private warmCacheForBudget;
     handleListTools(): Promise<{
         tools: {
-            name: string;
             inputSchema: {
+                [x: string]: unknown;
                 type: "object";
-                required?: string[] | undefined;
                 properties?: {
                     [x: string]: object;
                 } | undefined;
+                required?: string[] | undefined;
             };
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined | undefined;
-                sizes?: string[] | undefined;
-            }[] | undefined;
-            title?: string | undefined | undefined;
-            description?: string | undefined | undefined;
+            name: string;
+            description?: string | undefined;
             outputSchema?: {
+                [x: string]: unknown;
                 type: "object";
-                required?: string[] | undefined;
                 properties?: {
                     [x: string]: object;
                 } | undefined;
-                additionalProperties?: boolean | undefined | undefined;
+                required?: string[] | undefined;
             } | undefined;
             annotations?: {
-                title?: string | undefined | undefined;
-                readOnlyHint?: boolean | undefined | undefined;
-                destructiveHint?: boolean | undefined | undefined;
-                idempotentHint?: boolean | undefined | undefined;
-                openWorldHint?: boolean | undefined | undefined;
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
             } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "forbidden" | "required" | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+            title?: string | undefined;
         }[];
     }>;
     handleListResources(): Promise<{
@@ -78,6 +82,11 @@ export declare class YNABMCPServer {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -85,6 +94,11 @@ export declare class YNABMCPServer {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -92,47 +106,66 @@ export declare class YNABMCPServer {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         } | {
-            type: "resource_link";
-            name: string;
             uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
-            mimeType?: string | undefined | undefined;
             icons?: {
                 src: string;
-                mimeType?: string | undefined | undefined;
+                mimeType?: string | undefined;
                 sizes?: string[] | undefined;
             }[] | undefined;
-            title?: string | undefined | undefined;
-            description?: string | undefined | undefined;
+            title?: string | undefined;
         } | {
             type: "resource";
             resource: {
                 uri: string;
                 text: string;
+                mimeType?: string | undefined;
                 _meta?: {
                     [x: string]: unknown;
                 } | undefined;
-                mimeType?: string | undefined | undefined;
             } | {
                 uri: string;
                 blob: string;
+                mimeType?: string | undefined;
                 _meta?: {
                     [x: string]: unknown;
                 } | undefined;
-                mimeType?: string | undefined | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
         structuredContent?: {
             [x: string]: unknown;
@@ -152,6 +185,11 @@ export declare class YNABMCPServer {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -159,6 +197,11 @@ export declare class YNABMCPServer {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -166,47 +209,66 @@ export declare class YNABMCPServer {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         } | {
-            type: "resource_link";
-            name: string;
             uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
-            mimeType?: string | undefined | undefined;
             icons?: {
                 src: string;
-                mimeType?: string | undefined | undefined;
+                mimeType?: string | undefined;
                 sizes?: string[] | undefined;
             }[] | undefined;
-            title?: string | undefined | undefined;
-            description?: string | undefined | undefined;
+            title?: string | undefined;
         } | {
             type: "resource";
             resource: {
                 uri: string;
                 text: string;
+                mimeType?: string | undefined;
                 _meta?: {
                     [x: string]: unknown;
                 } | undefined;
-                mimeType?: string | undefined | undefined;
             } | {
                 uri: string;
                 blob: string;
+                mimeType?: string | undefined;
                 _meta?: {
                     [x: string]: unknown;
                 } | undefined;
-                mimeType?: string | undefined | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
         structuredContent?: {
             [x: string]: unknown;
@@ -214,39 +276,43 @@ export declare class YNABMCPServer {
         isError?: boolean | undefined;
     } | import("./prompts.js").PromptResponse | {
         tools: {
-            name: string;
             inputSchema: {
+                [x: string]: unknown;
                 type: "object";
-                required?: string[] | undefined;
                 properties?: {
                     [x: string]: object;
                 } | undefined;
+                required?: string[] | undefined;
             };
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined | undefined;
-                sizes?: string[] | undefined;
-            }[] | undefined;
-            title?: string | undefined | undefined;
-            description?: string | undefined | undefined;
+            name: string;
+            description?: string | undefined;
             outputSchema?: {
+                [x: string]: unknown;
                 type: "object";
-                required?: string[] | undefined;
                 properties?: {
                     [x: string]: object;
                 } | undefined;
-                additionalProperties?: boolean | undefined | undefined;
+                required?: string[] | undefined;
             } | undefined;
             annotations?: {
-                title?: string | undefined | undefined;
-                readOnlyHint?: boolean | undefined | undefined;
-                destructiveHint?: boolean | undefined | undefined;
-                idempotentHint?: boolean | undefined | undefined;
-                openWorldHint?: boolean | undefined | undefined;
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
+            } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "forbidden" | "required" | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
             } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+            title?: string | undefined;
         }[];
         description: string;
         messages: {

package/dist/server/securityMiddleware.d.ts

@@ -24,6 +24,11 @@ export declare function withSecurityWrapper<T extends Record<string, unknown>>(t
     content: ({
         type: "text";
         text: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
@@ -31,6 +36,11 @@ export declare function withSecurityWrapper<T extends Record<string, unknown>>(t
         type: "image";
         data: string;
         mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
@@ -38,47 +48,66 @@ export declare function withSecurityWrapper<T extends Record<string, unknown>>(t
         type: "audio";
         data: string;
         mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
     } | {
-        type: "resource_link";
-        name: string;
         uri: string;
+        name: string;
+        type: "resource_link";
+        description?: string | undefined;
+        mimeType?: string | undefined;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
-        mimeType?: string | undefined | undefined;
         icons?: {
             src: string;
-            mimeType?: string | undefined | undefined;
+            mimeType?: string | undefined;
             sizes?: string[] | undefined;
         }[] | undefined;
-        title?: string | undefined | undefined;
-        description?: string | undefined | undefined;
+        title?: string | undefined;
     } | {
         type: "resource";
         resource: {
             uri: string;
             text: string;
+            mimeType?: string | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
-            mimeType?: string | undefined | undefined;
         } | {
             uri: string;
             blob: string;
+            mimeType?: string | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
-            mimeType?: string | undefined | undefined;
         };
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
     })[];
     _meta?: {
         [x: string]: unknown;
+        "io.modelcontextprotocol/related-task"?: {
+            [x: string]: unknown;
+            taskId: string;
+        } | undefined;
     } | undefined;
     structuredContent?: {
         [x: string]: unknown;

package/dist/tools/schemas/outputs/index.d.ts

@@ -1,5 +1,5 @@
-export { GetUserOutputSchema, type GetUserOutput, ConvertAmountOutputSchema, type ConvertAmountOutput, GetDefaultBudgetOutputSchema, type GetDefaultBudgetOutput, SetDefaultBudgetOutputSchema, type SetDefaultBudgetOutput, ClearCacheOutputSchema, type ClearCacheOutput, SetOutputFormatOutputSchema, type SetOutputFormatOutput, DiagnosticInfoOutputSchema, type DiagnosticInfoOutput, GetBudgetOutputSchema, type GetBudgetOutput, } from './utilityOutputs.js';
-export { UserSchema, ConversionSchema, DateFormatSchema, CurrencyFormatSchema, BudgetDetailSchema, ServerInfoSchema, MemoryInfoSchema, EnvironmentInfoSchema, CacheInfoSchema, DeltaInfoSchema, } from './utilityOutputs.js';
+export { GetUserOutputSchema, type GetUserOutput, GetDefaultBudgetOutputSchema, type GetDefaultBudgetOutput, SetDefaultBudgetOutputSchema, type SetDefaultBudgetOutput, ClearCacheOutputSchema, type ClearCacheOutput, SetOutputFormatOutputSchema, type SetOutputFormatOutput, DiagnosticInfoOutputSchema, type DiagnosticInfoOutput, GetBudgetOutputSchema, type GetBudgetOutput, } from './utilityOutputs.js';
+export { UserSchema, DateFormatSchema, CurrencyFormatSchema, BudgetDetailSchema, ServerInfoSchema, MemoryInfoSchema, EnvironmentInfoSchema, CacheInfoSchema, DeltaInfoSchema, } from './utilityOutputs.js';
 export { ListBudgetsOutputSchema, type ListBudgetsOutput, BudgetSummarySchema, type BudgetSummary, } from './budgetOutputs.js';
 export { ListAccountsOutputSchema, type ListAccountsOutput, GetAccountOutputSchema, type GetAccountOutput, AccountSchema, type Account, } from './accountOutputs.js';
 export { ListTransactionsOutputSchema, type ListTransactionsOutput, GetTransactionOutputSchema, type GetTransactionOutput, TransactionSchema, type Transaction, TransactionPreviewSchema, type TransactionPreview, } from './transactionOutputs.js';

package/dist/tools/schemas/outputs/index.js

@@ -1,5 +1,5 @@
-export { GetUserOutputSchema, ConvertAmountOutputSchema, GetDefaultBudgetOutputSchema, SetDefaultBudgetOutputSchema, ClearCacheOutputSchema, SetOutputFormatOutputSchema, DiagnosticInfoOutputSchema, GetBudgetOutputSchema, } from './utilityOutputs.js';
-export { UserSchema, ConversionSchema, DateFormatSchema, CurrencyFormatSchema, BudgetDetailSchema, ServerInfoSchema, MemoryInfoSchema, EnvironmentInfoSchema, CacheInfoSchema, DeltaInfoSchema, } from './utilityOutputs.js';
+export { GetUserOutputSchema, GetDefaultBudgetOutputSchema, SetDefaultBudgetOutputSchema, ClearCacheOutputSchema, SetOutputFormatOutputSchema, DiagnosticInfoOutputSchema, GetBudgetOutputSchema, } from './utilityOutputs.js';
+export { UserSchema, DateFormatSchema, CurrencyFormatSchema, BudgetDetailSchema, ServerInfoSchema, MemoryInfoSchema, EnvironmentInfoSchema, CacheInfoSchema, DeltaInfoSchema, } from './utilityOutputs.js';
 export { ListBudgetsOutputSchema, BudgetSummarySchema, } from './budgetOutputs.js';
 export { ListAccountsOutputSchema, GetAccountOutputSchema, AccountSchema, } from './accountOutputs.js';
 export { ListTransactionsOutputSchema, GetTransactionOutputSchema, TransactionSchema, TransactionPreviewSchema, } from './transactionOutputs.js';

package/dist/tools/schemas/outputs/utilityOutputs.d.ts

@@ -8,21 +8,6 @@ export declare const GetUserOutputSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type GetUserOutput = z.infer<typeof GetUserOutputSchema>;
-export declare const ConversionSchema: z.ZodObject<{
-    original_amount: z.ZodNumber;
-    converted_amount: z.ZodNumber;
-    to_milliunits: z.ZodBoolean;
-    description: z.ZodString;
-}, z.core.$strip>;
-export declare const ConvertAmountOutputSchema: z.ZodObject<{
-    conversion: z.ZodObject<{
-        original_amount: z.ZodNumber;
-        converted_amount: z.ZodNumber;
-        to_milliunits: z.ZodBoolean;
-        description: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export type ConvertAmountOutput = z.infer<typeof ConvertAmountOutputSchema>;
 export declare const GetDefaultBudgetOutputSchema: z.ZodObject<{
     default_budget_id: z.ZodNullable<z.ZodString>;
     has_default: z.ZodBoolean;

package/dist/tools/schemas/outputs/utilityOutputs.js

@@ -6,15 +6,6 @@ export const UserSchema = z.object({
 export const GetUserOutputSchema = z.object({
     user: UserSchema,
 });
-export const ConversionSchema = z.object({
-    original_amount: z.number(),
-    converted_amount: z.number(),
-    to_milliunits: z.boolean(),
-    description: z.string(),
-});
-export const ConvertAmountOutputSchema = z.object({
-    conversion: ConversionSchema,
-});
 export const GetDefaultBudgetOutputSchema = z.object({
     default_budget_id: z.string().nullable(),
     has_default: z.boolean(),

package/dist/tools/utilityTools.d.ts

@@ -1,12 +1,5 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import * as ynab from 'ynab';
-import { z } from 'zod/v4';
 import type { ToolFactory } from '../types/toolRegistration.js';
-export declare const ConvertAmountSchema: z.ZodObject<{
-    amount: z.ZodNumber;
-    to_milliunits: z.ZodBoolean;
-}, z.core.$strict>;
-export type ConvertAmountParams = z.infer<typeof ConvertAmountSchema>;
 export declare function handleGetUser(ynabAPI: ynab.API): Promise<CallToolResult>;
-export declare function handleConvertAmount(_ynabAPI: ynab.API, params: ConvertAmountParams): Promise<CallToolResult>;
 export declare const registerUtilityTools: ToolFactory;

package/dist/tools/utilityTools.js

@@ -1,15 +1,8 @@
-import { z } from 'zod/v4';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { withToolErrorHandling } from '../types/index.js';
 import { createAdapters } from './adapters.js';
 import { emptyObjectSchema } from './schemas/common.js';
 import { ToolAnnotationPresets } from './toolCategories.js';
-export const ConvertAmountSchema = z
-    .object({
-    amount: z.number().finite(),
-    to_milliunits: z.boolean(),
-})
-    .strict();
 export async function handleGetUser(ynabAPI) {
     return await withToolErrorHandling(async () => {
         const response = await ynabAPI.user.getUser();
@@ -27,38 +20,8 @@ export async function handleGetUser(ynabAPI) {
         };
     }, 'ynab:get_user', 'getting user information');
 }
-export async function handleConvertAmount(_ynabAPI, params) {
-    return await withToolErrorHandling(async () => {
-        const { amount, to_milliunits } = params;
-        let result;
-        let description;
-        if (to_milliunits) {
-            result = Math.round(amount * 1000);
-            description = `$${amount.toFixed(2)} = ${result} milliunits`;
-        }
-        else {
-            result = amount / 1000;
-            description = `${amount} milliunits = $${result.toFixed(2)}`;
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: responseFormatter.format({
-                        conversion: {
-                            original_amount: amount,
-                            converted_amount: result,
-                            to_milliunits,
-                            description,
-                        },
-                    }),
-                },
-            ],
-        };
-    }, 'ynab:convert_amount', 'converting amount');
-}
 export const registerUtilityTools = (registry, context) => {
-    const { adapt, adaptNoInput } = createAdapters(context);
+    const { adaptNoInput } = createAdapters(context);
     registry.register({
         name: 'get_user',
         description: 'Get information about the authenticated user',
@@ -71,16 +34,4 @@ export const registerUtilityTools = (registry, context) => {
             },
         },
     });
-    registry.register({
-        name: 'convert_amount',
-        description: 'Convert between dollars and milliunits with integer arithmetic for precision',
-        inputSchema: ConvertAmountSchema,
-        handler: adapt(handleConvertAmount),
-        metadata: {
-            annotations: {
-                ...ToolAnnotationPresets.UTILITY_LOCAL,
-                title: 'YNAB: Convert Amount',
-            },
-        },
-    });
 };

package/docs/maintainers/npm-publishing.md

@@ -0,0 +1,27 @@
+# npm publishing (maintainers)
+
+This repo publishes the package `@dizzlkheinz/ynab-mcpb` to the public npm registry via GitHub Actions (`.github/workflows/publish.yml`).
+
+## Trusted publishing (OIDC)
+
+This package is configured as a **Trusted Publisher** on npm (OIDC). With that enabled, the publish workflow does **not** need an npm token and can still work even if the package is set to “disallow tokens”.
+
+Note: `npm whoami` will still fail in CI under OIDC; authentication happens only during `npm publish`.
+
+## Common failure: `npm ERR! need auth`
+
+This error means the runner has no valid auth for `https://registry.npmjs.org/`.
+
+Checklist:
+
+- The Trusted Publisher entry matches exactly (repo, workflow filename `publish.yml`, and environment `npm-publish`).
+- The workflow has `permissions: id-token: write`.
+- You’re using a recent npm CLI (the workflow uses Node `24`).
+- For first-time scoped publishes, the workflow uses `npm publish --access public`.
+
+## Local manual publish (optional)
+
+```bash
+npm adduser
+npm publish --access public
+```