nostr-bray 1.27.0 → 1.27.1

package/dist/catalog.js

@@ -108,11 +108,17 @@ export class ActionCatalog {
             description: 'Execute an action found via search-actions. Pass the exact action name and its parameters.',
             inputSchema: {
                 action: z.string().describe('Action name from search-actions results'),
-                params: z.record(z.string(), z.unknown()).default({}).describe('Parameters for the action (see search-actions results for expected params)'),
+                params: z.record(z.string(), z.unknown()).optional().describe('Parameters for the action (see search-actions results for expected params). Alias: parameters.'),
+                // Alias for clients that naturally reach for "parameters" rather than "params".
+                // Without this, MCP SDK strips unknown keys from the validated args and the
+                // inner action handler receives an empty object, causing spurious
+                // "expected string, received undefined" validation failures.
+                parameters: z.record(z.string(), z.unknown()).optional().describe('Alias for params. Either field is accepted.'),
             },
             annotations: { openWorldHint: true },
-        }, async ({ action, params }) => {
-            return catalog.execute(action, params);
+        }, async ({ action, params, parameters }) => {
+            const resolved = (params ?? parameters ?? {});
+            return catalog.execute(action, resolved);
         });
     }
 }

package/dist/relay/handlers.d.ts

@@ -37,6 +37,7 @@ export declare function handleRelayAdd(ctx: SigningContext, pool: RelayPool, arg
     reconfigured: boolean;
 };
 export interface RelayQueryArgs {
+    ids?: string[];
     kinds?: number[];
     authors?: string[];
     tags?: Record<string, string[]>;

package/dist/relay/handlers.js

@@ -81,6 +81,8 @@ export function handleRelayAdd(ctx, pool, args) {
 /** Query events from relays by arbitrary filter. Uses explicit relays if provided, otherwise the active identity's read relays. */
 export async function handleRelayQuery(pool, npub, args) {
     const filter = {};
+    if (args.ids?.length)
+        filter.ids = args.ids;
     if (args.kinds?.length)
         filter.kinds = args.kinds;
     if (args.authors?.length)

package/dist/relay/tools.js

@@ -50,21 +50,49 @@ export function registerRelayTools(server, deps) {
         };
     });
     server.registerTool('relay-query', {
-        description: 'Query events from Nostr relays by kind, author, tags, or time range. Useful for discovering events, scanning for specific kinds, or investigating unknown event schemas. Uses explicit relays if provided, otherwise the active identity\'s read relays.',
+        description: 'Query events from Nostr relays by kind, author, ids, tags, or time range. Useful for discovering events, scanning for specific kinds, or investigating unknown event schemas. Uses explicit relays if provided, otherwise the active identity\'s read relays. Filter fields may be supplied either as top-level arguments or wrapped in a single "filter" object (both shapes are accepted).',
         inputSchema: {
+            ids: z.array(z.string()).optional().describe('Event IDs (hex) to fetch directly'),
             kinds: z.array(z.number().int()).optional().describe('Event kinds to filter by (e.g. [30301, 31000])'),
             authors: z.array(z.string()).optional().describe('Hex pubkeys of event authors'),
             tags: z.record(z.string(), z.array(z.string())).optional().describe('Tag filters as key-value pairs (e.g. {"#p": ["hex..."], "#d": ["prefix"]})'),
-            since: z.number().int().optional().describe('Unix timestamp — only events created after this time'),
-            until: z.number().int().optional().describe('Unix timestamp — only events created before this time'),
-            limit: z.number().int().min(1).max(500).default(50).describe('Maximum number of events to return (default 50, max 500)'),
+            since: z.number().int().optional().describe('Unix timestamp, only events created after this time'),
+            until: z.number().int().optional().describe('Unix timestamp, only events created before this time'),
+            limit: z.number().int().min(1).max(500).optional().describe('Maximum number of events to return (default 50, max 500)'),
             relays: z.array(relayUrl).optional().describe('Explicit relay URLs to query (overrides identity relay set)'),
             search: z.string().optional().describe('Full-text search query (NIP-50). Only works on relays that support NIP-50; others will ignore it.'),
+            // Alias: some MCP clients naturally wrap the whole filter in a single "filter" object.
+            // Without this alias the MCP SDK silently strips the unknown key, leaving the handler
+            // with an empty argument set and returning a broad firehose of events.
+            filter: z.object({
+                ids: z.array(z.string()).optional(),
+                kinds: z.array(z.number().int()).optional(),
+                authors: z.array(z.string()).optional(),
+                tags: z.record(z.string(), z.array(z.string())).optional(),
+                since: z.number().int().optional(),
+                until: z.number().int().optional(),
+                limit: z.number().int().min(1).max(500).optional(),
+                search: z.string().optional(),
+            }).optional().describe('Alias: all filter fields wrapped in a single object. Merged with any top-level fields; top-level values win on conflict.'),
         },
         annotations: { readOnlyHint: true },
-    }, async ({ kinds, authors, tags, since, until, limit, relays, search }) => {
+    }, async (args) => {
+        // Merge nested "filter" alias with top-level fields. Top-level values win on conflict so
+        // the canonical form stays authoritative, but a caller that only supplies "filter" still
+        // gets everything through. Without this merge the MCP SDK strips the unknown top-level
+        // "filter" key and the handler receives an empty object, yielding a firehose response.
+        const f = args.filter ?? {};
+        const mergedLimit = args.limit ?? f.limit ?? 50;
         const events = await handleRelayQuery(deps.pool, deps.ctx.activeNpub, {
-            kinds, authors, tags, since, until, limit, relays, search,
+            ids: args.ids ?? f.ids,
+            kinds: args.kinds ?? f.kinds,
+            authors: args.authors ?? f.authors,
+            tags: args.tags ?? f.tags,
+            since: args.since ?? f.since,
+            until: args.until ?? f.until,
+            limit: mergedLimit,
+            relays: args.relays,
+            search: args.search ?? f.search,
         });
         const summary = events.map(e => ({
             id: e.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nostr-bray",
-  "version": "1.27.0",
+  "version": "1.27.1",
   "description": "Trust-aware Nostr for AI and humans. Three dimensions of trust -- verification, proximity, and access -- woven into every interaction.",
   "type": "module",
   "main": "dist/index.js",