@naumu/mcp 0.6.0 → 0.6.2

package/dist/tools/remove-node.js

@@ -1,17 +0,0 @@
-import { z } from 'zod';
-export function registerRemoveNode(server, client) {
-    server.registerTool('naumu_remove_node', {
-        title: 'Remove Node',
-        description: 'Low-level tool: delete a node and all its connections from the knowledge graph. This is a destructive operation. **Prefer `naumu_ask`** for removing knowledge — it understands the impact on the broader graph and can handle cascading changes. Use this only when you need precise, surgical deletion.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            nodeId: z.string().describe('The node ID to delete'),
-        }),
-    }, async ({ graphId, nodeId }) => {
-        const data = await client.del(`/api/graphs/${graphId}/nodes/${nodeId}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=remove-node.js.map

package/dist/tools/remove-node.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remove-node.js","sourceRoot":"","sources":["../../src/tools/remove-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAmB;IACxE,MAAM,CAAC,YAAY,CAClB,mBAAmB,EACnB;QACC,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,2SAA2S;QACxT,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;SACpD,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,OAAO,UAAU,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/remove-reaction.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerRemoveReaction(server: McpServer, client: NaumuClient): void;

package/dist/tools/remove-reaction.js

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-export function registerRemoveReaction(server, client) {
-    server.registerTool('naumu_remove_reaction', {
-        title: 'Remove Reaction',
-        description: 'Remove your own emoji reaction from a message. Idempotent — calling on a reaction you never added is a no-op. Pair with `naumu_add_reaction` when you need to walk back an acknowledgement (e.g. you reacted 👀 to start a task and want to clear it after a final result message lands). Returns `{ ok, messageId, emoji, alreadyExisted, reactionCount, reactions }` — `alreadyExisted: false` means there was nothing to remove and the call was a no-op.',
-        inputSchema: z.object({
-            threadId: z
-                .string()
-                .describe('Thread containing the message. You must be a participant.'),
-            messageId: z
-                .string()
-                .describe('The message to remove your reaction from.'),
-            emoji: z
-                .string()
-                .min(1)
-                .describe('Emoji character to remove (must match what you originally reacted with).'),
-        }),
-    }, async ({ threadId, messageId, emoji }) => {
-        try {
-            const data = await client.post(`/api/threads/${threadId}/messages/${messageId}/reactions`, { emoji, action: 'remove' });
-            return {
-                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return {
-                content: [{ type: 'text', text: `Error: ${message}` }],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=remove-reaction.js.map

package/dist/tools/remove-reaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remove-reaction.js","sourceRoot":"","sources":["../../src/tools/remove-reaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAmB;IAC5E,MAAM,CAAC,YAAY,CAClB,uBAAuB,EACvB;QACC,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACV,8bAA8b;QAC/b,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,2DAA2D,CAAC;YACvE,SAAS,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,2CAA2C,CAAC;YACvD,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,0EAA0E,CAAC;SACtF,CAAC;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC7B,gBAAgB,QAAQ,aAAa,SAAS,YAAY,EAC1D,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAC3B,CAAC;YACF,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/reparent.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerReparent(server: McpServer, client: NaumuClient): void;

package/dist/tools/reparent.js

@@ -1,21 +0,0 @@
-import { z } from 'zod';
-export function registerReparent(server, client) {
-    server.registerTool('naumu_reparent', {
-        title: 'Reparent Node',
-        description: 'Atomically swap a node\'s parent edge. Deletes any existing `isParent: true` edges on the node and creates a new one to `newParentId` with relation `newRelation`. **Preserves the node\'s id, content, attributes, and embedding** — does NOT trigger embedding regeneration because only the parent edge changes. Idempotent: if the node already has the requested parent edge, response is `status: "skipped"`. Response shape: `{nodeId, oldParentId, newParentId, newRelation, status: "moved" | "skipped"}`. Use during /restructure to reparent children under newly-created mini-hubs.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            nodeId: z.string().describe('The child node to reparent'),
-            newParentId: z.string().describe('The new parent node id'),
-            newRelation: z
-                .string()
-                .describe('The new parent edge relation label (e.g. "PART_OF"). Must be valid per the schema for (child.type, relation, parent.type).'),
-        }),
-    }, async ({ graphId, nodeId, newParentId, newRelation }) => {
-        const data = await client.post(`/api/graphs/${graphId}/nodes/${nodeId}/reparent`, { newParentId, newRelation });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=reparent.js.map

package/dist/tools/reparent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reparent.js","sourceRoot":"","sources":["../../src/tools/reparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAmB;IACtE,MAAM,CAAC,YAAY,CAClB,gBAAgB,EAChB;QACC,KAAK,EAAE,eAAe;QACtB,WAAW,EACV,ikBAAikB;QAClkB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC1D,WAAW,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,4HAA4H,CAAC;SACxI,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC7B,eAAe,OAAO,UAAU,MAAM,WAAW,EACjD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC5B,CAAC;QACF,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/request-attachment-upload.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerRequestAttachmentUpload(server: McpServer, client: NaumuClient): void;

package/dist/tools/request-attachment-upload.js

@@ -1,59 +0,0 @@
-import { z } from 'zod';
-export function registerRequestAttachmentUpload(server, client) {
-    server.registerTool('naumu_request_attachment_upload', {
-        title: 'Request Attachment Upload',
-        description: 'Request a presigned S3 upload URL to attach a file to a message. Same flow Naumu users use for file uploads: get a signed URL, PUT the bytes to it directly, then call `naumu_post_message` with the returned `attachmentId` in `attachmentIds`. Use this when you want to deliver generated content as a file (a markdown report, a PDF, an image, an audio recording, a video). Per-MIME size caps apply (typically 50MB umbrella, 10MB for agent-readable types).\n\nReturns `{ attachmentId, uploadUrl, method, requiredHeaders, expiresAt }`. Use these EXACTLY:\n• `method` is "PUT".\n• Send every header in `requiredHeaders` (Content-Type matters for S3 signature validation).\n• Do NOT add an Authorization header — the URL itself is the auth.\n• Do NOT log `uploadUrl` — it is a bearer capability for the duration of the TTL.\n• `expiresAt` is a Unix-ms timestamp; the pending attachment vanishes at that moment whether or not you uploaded. Call `naumu_post_message` with the attachmentId before then or the upload orphans.\n\nServer-side checks at post time enforce that the attachment was uploaded by you, in this graph, for this thread — you cannot reuse an upload across threads.',
-        inputSchema: z.object({
-            threadId: z
-                .string()
-                .describe('Thread the attachment will land in. You must be a participant. The pending attachment is keyed to this thread — you cannot reuse it for a different one.'),
-            fileName: z
-                .string()
-                .min(1)
-                .describe('Original filename (with extension). Used as the display name in the message and for the S3 object suffix. Special characters are sanitized server-side.'),
-            fileType: z
-                .string()
-                .min(1)
-                .describe('MIME type, e.g. `application/pdf`, `image/png`, `text/markdown`, `audio/mpeg`, `video/mp4`. The S3 PUT will enforce this Content-Type.'),
-            fileSize: z
-                .number()
-                .int()
-                .positive()
-                .describe('File size in bytes. Validated against per-MIME caps before the URL is issued — exceeding the cap returns a 400.'),
-            audioDurationSec: z
-                .number()
-                .positive()
-                .optional()
-                .describe('For audio attachments, duration in seconds. Validated against the audio recording cap (currently 8 hours).'),
-        }),
-    }, async ({ threadId, fileName, fileType, fileSize, audioDurationSec }) => {
-        try {
-            // graphId is required by the presign endpoint, but a bot is
-            // pinned to one graph — fetch it via whoami to keep the bot
-            // from having to thread it through manually. (One-time per
-            // session if the caller caches; cheap regardless.)
-            const me = (await client.get('/api/identities/me/whoami'));
-            const body = {
-                graphId: me.graphId,
-                threadId,
-                fileName,
-                fileType,
-                fileSize,
-            };
-            if (audioDurationSec !== undefined)
-                body.audioDurationSec = audioDurationSec;
-            const data = await client.post('/api/attachments/presign', body);
-            return {
-                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return {
-                content: [{ type: 'text', text: `Error: ${message}` }],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=request-attachment-upload.js.map

package/dist/tools/request-attachment-upload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"request-attachment-upload.js","sourceRoot":"","sources":["../../src/tools/request-attachment-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,+BAA+B,CAC9C,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CAClB,iCAAiC,EACjC;QACC,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACV,wpCAAwpC;QACzpC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,0JAA0J,CAAC;YACtK,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,yJAAyJ,CAAC;YACrK,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wIAAwI,CAAC;YACpJ,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,iHAAiH,CAAC;YAC7H,gBAAgB,EAAE,CAAC;iBACjB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,4GAA4G,CAAC;SACxH,CAAC;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,EAAE;QACtE,IAAI,CAAC;YACJ,4DAA4D;YAC5D,4DAA4D;YAC5D,2DAA2D;YAC3D,mDAAmD;YACnD,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAwB,CAAC;YAClF,MAAM,IAAI,GAA4B;gBACrC,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,QAAQ;gBACR,QAAQ;gBACR,QAAQ;gBACR,QAAQ;aACR,CAAC;YACF,IAAI,gBAAgB,KAAK,SAAS;gBAAE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YAE7E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;YACjE,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/search.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerSearch(server: McpServer, client: NaumuClient): void;

package/dist/tools/search.js

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-export function registerSearch(server, client) {
-    server.registerTool('naumu_search', {
-        title: 'Search Graph',
-        description: 'Hybrid search over graph nodes. Combines exact-token text matching (good for UUIDs, proper nouns, specific labels) with semantic similarity (good for paraphrase and meaning), then fuses both rankings with Reciprocal Rank Fusion. Returns the top matches with a `matchedVia` tag — `both` is the highest-confidence signal, then `semantic`, then `text`. Use `naumu_filter` for structured queries by type and attributes (e.g. "all in-progress Tasks"). Tip: include both synonyms ("authentication login SSO") and exact tokens you remember in the same query — the fusion handles both.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            query: z
-                .string()
-                .describe('Search query text. Mix synonyms and exact tokens freely (e.g. "auth login SSO 2fa Twitter handle").'),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe('Max results to return (default 20, max 200). Adaptive cutoff may return fewer when the top match is weak.'),
-            nodeTypes: z
-                .array(z.string())
-                .optional()
-                .describe('Filter to specific node types (e.g. ["Feature", "Pain"])'),
-        }),
-    }, async ({ graphId, query, limit, nodeTypes }) => {
-        const params = new URLSearchParams();
-        params.set('q', query);
-        if (limit)
-            params.set('limit', String(limit));
-        if (nodeTypes?.length)
-            params.set('nodeTypes', nodeTypes.join(','));
-        const data = await client.get(`/api/graphs/${graphId}/search/hybrid?${params.toString()}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAmB;IACpE,MAAM,CAAC,YAAY,CAClB,cAAc,EACd;QACC,KAAK,EAAE,cAAc;QACrB,WAAW,EACV,mkBAAmkB;QACpkB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACR,qGAAqG,CACrG;YACF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,2GAA2G,CAAC;YACvH,SAAS,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,0DAA0D,CAAC;SACtE,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEpE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,OAAO,kBAAkB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3F,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/semantic-search.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerSemanticSearch(server: McpServer, client: NaumuClient): void;

package/dist/tools/semantic-search.js

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-export function registerSemanticSearch(server, client) {
-    server.registerTool('naumu_semantic_search', {
-        title: 'Semantic Search Graph',
-        description: 'Semantic search over a knowledge graph using AI embeddings. Understands meaning and context, not just exact text matches. Use `naumu_text_search` for literal/exact string matching. Use `naumu_filter` for structured queries by type and attributes (e.g. "all in-progress Tasks"). Returns nodes ranked by semantic similarity. Tip: expand your query with synonyms and related terms for best results.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            query: z
-                .string()
-                .describe('Search query text. For best results, expand with synonyms and related terms (e.g. "authentication login sign-in auth" instead of just "auth")'),
-            limit: z
-                .number()
-                .optional()
-                .default(100)
-                .describe('Max results to return (default 100, max 200)'),
-            nodeTypes: z
-                .array(z.string())
-                .optional()
-                .describe('Filter to specific node types (e.g. ["Feature", "Pain"])'),
-        }),
-    }, async ({ graphId, query, limit, nodeTypes }) => {
-        const params = new URLSearchParams();
-        params.set('q', query);
-        if (limit)
-            params.set('limit', String(limit));
-        if (nodeTypes?.length)
-            params.set('nodeTypes', nodeTypes.join(','));
-        const data = await client.get(`/api/graphs/${graphId}/search/semantic?${params.toString()}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=semantic-search.js.map

package/dist/tools/semantic-search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"semantic-search.js","sourceRoot":"","sources":["../../src/tools/semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAmB;IAC5E,MAAM,CAAC,YAAY,CAClB,uBAAuB,EACvB;QACC,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACV,6YAA6Y;QAC9Y,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACR,+IAA+I,CAC/I;YACF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,GAAG,CAAC;iBACZ,QAAQ,CAAC,8CAA8C,CAAC;YAC1D,SAAS,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,0DAA0D,CAAC;SACtE,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEpE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,OAAO,oBAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7F,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/text-search.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerTextSearch(server: McpServer, client: NaumuClient): void;

package/dist/tools/text-search.js

@@ -1,18 +0,0 @@
-import { z } from 'zod';
-export function registerTextSearch(server, client) {
-    server.registerTool('naumu_text_search', {
-        title: 'Text Search Graph',
-        description: "Case-insensitive substring search over node labels, content, and types. Use this when you know a keyword or phrase to find. For meaning-based discovery, use `naumu_semantic_search`. For structured filtering by type/attributes, use `naumu_filter`.",
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            query: z.string().describe('Search query text'),
-            limit: z.number().optional().default(20).describe('Max results to return (default 20, max 200)'),
-        }),
-    }, async ({ graphId, query, limit }) => {
-        const data = await client.get(`/api/graphs/${graphId}/search?q=${encodeURIComponent(query)}&limit=${limit}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=text-search.js.map

package/dist/tools/text-search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text-search.js","sourceRoot":"","sources":["../../src/tools/text-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAmB;IACxE,MAAM,CAAC,YAAY,CAClB,mBAAmB,EACnB;QACC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACV,wPAAwP;QACzP,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAChG,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,OAAO,aAAa,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QAC7G,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/traverse.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerTraverse(server: McpServer, client: NaumuClient): void;

package/dist/tools/traverse.js

@@ -1,19 +0,0 @@
-import { z } from 'zod';
-export function registerTraverse(server, client) {
-    server.registerTool('naumu_traverse', {
-        title: 'Traverse Knowledge Graph',
-        description: 'Query the graph structurally using natural language. A sub-LLM generates and executes Cypher queries. Use for structural questions like "tasks without a parent", "features with most tasks", "orphan nodes", "everything within 2 hops of X", or temporal filters like "nodes updated this week". For meaning-based search, use `naumu_search` instead.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            query: z
-                .string()
-                .describe('Natural language description of the structural pattern to find (e.g. "tasks without a parent", "features that don\'t resolve any pain")'),
-        }),
-    }, async ({ graphId, query }) => {
-        const data = await client.post(`/api/graphs/${graphId}/traverse`, { query });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=traverse.js.map

package/dist/tools/traverse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../src/tools/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAmB;IACtE,MAAM,CAAC,YAAY,CAClB,gBAAgB,EAChB;QACC,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACV,0VAA0V;QAC3V,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACR,yIAAyI,CACzI;SACF,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/update-node.d.ts

@@ -1,30 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-/**
- * Date attribute payload. Single day = ISO string "YYYY-MM-DD" OR
- * { start: "YYYY-MM-DD" }; range = { start, end? } where end >= start.
- * Mirrors `DateRangeValue` in `@naumu/shared/attributes/date-value` —
- * inlined here because @naumu/mcp ships standalone to npm and can't
- * depend on the private workspace package.
- */
-interface DateRangeValue {
-    start: string;
-    end?: string;
-}
-/**
- * Validate an incoming date-attribute payload. Returns either the value to send
- * to the backend (null, ISO string, or { start, end? } object) OR an error
- * message string. The backend's update-node-attribute endpoint accepts these
- * shapes and handles JSON serialization to Neo4j.
- *
- * Exported for testing.
- */
-export declare function validateDateAttribute(name: string, val: unknown): {
-    ok: true;
-    value: null | string | DateRangeValue;
-} | {
-    ok: false;
-    error: string;
-};
-export declare function registerUpdateNode(server: McpServer, client: NaumuClient): void;
-export {};

package/dist/tools/update-node.js

@@ -1,152 +0,0 @@
-import { z } from 'zod';
-const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
-/** True iff `s` is `YYYY-MM-DD` AND represents a real calendar day. */
-function isValidIsoDate(s) {
-    if (typeof s !== 'string')
-        return false;
-    if (!ISO_DATE_REGEX.test(s))
-        return false;
-    const [yearStr, monthStr, dayStr] = s.split('-');
-    const year = Number(yearStr);
-    const month = Number(monthStr);
-    const day = Number(dayStr);
-    const date = new Date(Date.UTC(year, month - 1, day));
-    if (Number.isNaN(date.getTime()))
-        return false;
-    return (date.getUTCFullYear() === year &&
-        date.getUTCMonth() === month - 1 &&
-        date.getUTCDate() === day);
-}
-/** True iff `value` is `{ start }` with optional `end >= start`, all valid ISO dates. */
-function isValidDateRange(value) {
-    if (value === null || typeof value !== 'object')
-        return false;
-    const candidate = value;
-    if (!isValidIsoDate(candidate.start))
-        return false;
-    if (candidate.end !== undefined) {
-        if (!isValidIsoDate(candidate.end))
-            return false;
-        // Lexicographic comparison works for YYYY-MM-DD.
-        if (candidate.end < candidate.start)
-            return false;
-    }
-    return true;
-}
-/** Build a map of lowercase attribute name → valid values for a given node type. */
-function getAttributeMap(schema, nodeType) {
-    const map = new Map();
-    const nodeDef = schema.nodes.find((n) => n.type === nodeType);
-    if (nodeDef?.attributes) {
-        for (const attr of nodeDef.attributes) {
-            map.set(attr.name.toLowerCase(), attr);
-        }
-    }
-    return map;
-}
-/**
- * Validate an incoming date-attribute payload. Returns either the value to send
- * to the backend (null, ISO string, or { start, end? } object) OR an error
- * message string. The backend's update-node-attribute endpoint accepts these
- * shapes and handles JSON serialization to Neo4j.
- *
- * Exported for testing.
- */
-export function validateDateAttribute(name, val) {
-    const rejectionMessage = `Date attribute "${name}" expects null, an ISO date string (YYYY-MM-DD), or { start, end? } with ISO dates.`;
-    if (val === null)
-        return { ok: true, value: null };
-    if (typeof val === 'string') {
-        if (isValidIsoDate(val))
-            return { ok: true, value: val };
-        return { ok: false, error: rejectionMessage };
-    }
-    if (typeof val === 'object' && val !== null) {
-        if (isValidDateRange(val)) {
-            const range = val;
-            // Normalize: drop end when it equals start (single-day).
-            const normalized = range.end === undefined || range.end === range.start
-                ? { start: range.start }
-                : { start: range.start, end: range.end };
-            return { ok: true, value: normalized };
-        }
-        return { ok: false, error: rejectionMessage };
-    }
-    return { ok: false, error: rejectionMessage };
-}
-export function registerUpdateNode(server, client) {
-    server.registerTool('naumu_update_node', {
-        title: 'Update Node',
-        description: 'Update properties of an existing node. Only the provided fields will be changed. Good for simple attribute changes like setting a status, priority, or due date. For content or structural changes, consider `naumu_ask` instead — it understands the full graph context and can propagate updates to related nodes. Attribute keys AND values must match the schema for the node type. Use naumu_get_schema to check valid attribute names, types, and values before updating. Date attributes accept either null (to clear), an ISO date string "YYYY-MM-DD" (single day), or { start: "YYYY-MM-DD", end?: "YYYY-MM-DD" } (inclusive range). Example: { "due_date": { "start": "2026-05-21", "end": "2026-05-23" } } or { "due_date": "2026-05-21" } or { "due_date": null }. Select attributes accept the value label as a string.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            nodeId: z.string().describe('The node ID to update'),
-            label: z.string().optional().describe('New display name'),
-            type: z.string().optional().describe('New node type'),
-            content: z.string().optional().describe('New content / description'),
-            attributes: z
-                .record(z.string(), z.unknown())
-                .optional()
-                .describe('Schema-defined attributes to set. Examples: {"Status": "In Progress"}, {"due_date": {"start": "2026-05-21", "end": "2026-05-23"}}, {"due_date": "2026-05-21"}, {"due_date": null}.'),
-        }),
-    }, async ({ graphId, nodeId, label, type, content, attributes }) => {
-        const body = {};
-        if (label !== undefined)
-            body.label = label;
-        if (type !== undefined)
-            body.type = type;
-        if (content !== undefined)
-            body.content = content;
-        if (attributes && Object.keys(attributes).length > 0) {
-            // Fetch the node to get its type, then validate attributes against schema
-            const node = (await client.get(`/api/graphs/${graphId}/nodes/${nodeId}`));
-            const nodeType = (type ?? node.type);
-            const schemaRes = (await client.get(`/api/graphs/${graphId}/schema`));
-            const schema = JSON.parse(schemaRes.definition);
-            const attrMap = getAttributeMap(schema, nodeType);
-            const errors = [];
-            for (const [key, val] of Object.entries(attributes)) {
-                const normalized = key.toLowerCase();
-                const schemaDef = attrMap.get(normalized);
-                if (!schemaDef) {
-                    const validNames = [...attrMap.values()].map((a) => a.name);
-                    errors.push(`Unknown attribute "${key}" for type "${nodeType}". Valid attributes: ${validNames.length > 0 ? validNames.join(', ') : 'none'}.`);
-                    continue;
-                }
-                // Date type — validate shape, pass through raw to backend (it serializes).
-                if (schemaDef.type === 'date') {
-                    const result = validateDateAttribute(schemaDef.name, val);
-                    if (!result.ok) {
-                        errors.push(result.error);
-                        continue;
-                    }
-                    body[normalized] = result.value;
-                    continue;
-                }
-                // Enum types — validate value against allowed labels.
-                const validValues = schemaDef.values.map((v) => v.label);
-                if (typeof val === 'string' && validValues.length > 0 && !validValues.includes(val)) {
-                    errors.push(`Invalid value "${val}" for attribute "${schemaDef.name}" on type "${nodeType}". Valid values: ${validValues.join(', ')}.`);
-                    continue;
-                }
-                body[normalized] = val;
-            }
-            if (errors.length > 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Attribute validation failed:\n${errors.join('\n')}\n\nUse naumu_get_schema to check valid attributes and values for this node type.`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        const data = await client.patch(`/api/graphs/${graphId}/nodes/${nodeId}`, body);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=update-node.js.map

package/dist/tools/update-node.js.map

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

package/dist/tools/update-schema.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerUpdateSchema(server: McpServer, client: NaumuClient): void;

package/dist/tools/update-schema.js

@@ -1,60 +0,0 @@
-import { z } from 'zod';
-const ConnectionSchema = z.object({
-    relation: z.string().describe('UPPER_SNAKE_CASE relation name (e.g. WORKS_AT, BUILT_BY, BELONGS_TO)'),
-    target_node: z.string().optional().describe('Target type name. Omit when polymorphic=true.'),
-    polymorphic: z.boolean().optional().describe('Set true when this relation can target multiple types.'),
-});
-const AttributeValueSchema = z.object({
-    label: z.string().describe('Display label for this enum value'),
-    color: z.string().optional().describe('Optional hex color (e.g. "#ff5722")'),
-    description: z
-        .string()
-        .optional()
-        .describe('Short note distinguishing this value from sibling values (e.g. "closed-won — deal signed and revenue committed"). Encouraged when the label alone is ambiguous.'),
-});
-const AttributeSchema = z.object({
-    name: z.string().describe('Attribute key (e.g. "stage", "status", "category")'),
-    type: z.enum(['select', 'multiselect', 'string', 'number', 'date']).optional().describe('Attribute type. Defaults to select if omitted.'),
-    values: z.array(AttributeValueSchema).describe('Allowed enum values for select/multiselect; pass [] for string/number/date.'),
-    description: z
-        .string()
-        .optional()
-        .describe('Short note explaining what this attribute captures and how it differs from similarly-named attributes elsewhere in the schema. Strongly encouraged.'),
-});
-const NodeTypeSchema = z.object({
-    type: z.string().describe('Type name in PascalCase (e.g. Company, Person, Feature, Document)'),
-    connections: z.object({
-        parent: ConnectionSchema.optional().describe('Optional parent relation (this type nests under another via this connection).'),
-        required: z.array(ConnectionSchema).default([]).describe('Required outgoing connections to other types.'),
-        suggested: z.array(ConnectionSchema).default([]).describe('Suggested-but-optional outgoing connections.'),
-    }),
-    attributes: z.array(AttributeSchema).optional().describe('Type-level attributes for instances of this type.'),
-    defaultVisibility: z.enum(['restricted', 'internal', 'open']).optional(),
-    color: z.string().optional().describe('Optional hex color for instances of this type.'),
-    description: z
-        .string()
-        .optional()
-        .describe('Short one-sentence description of what this type represents AND how it differs from semantically similar types (e.g. "External entity delivering services on contract — distinct from Organization which is any legal entity"). Strongly encouraged on every type. Future agents rely on this when classifying a new node into one of several similar-sounding types.'),
-});
-const SchemaDefinitionSchema = z.object({
-    description: z.string().optional().describe('Schema-level description / domain summary.'),
-    nodes: z.array(NodeTypeSchema).describe('All node types in the schema.'),
-});
-export function registerUpdateSchema(server, client) {
-    server.registerTool('naumu_update_schema', {
-        title: 'Update Graph Schema',
-        description: 'Replace the graph schema with a new full definition. STRUCTURAL RULES (load-bearing): (1) HIERARCHICAL with a single root — exactly ONE type has no parent; every other type MUST declare a parent. (2) Each parent / required / suggested connection is XOR: ONE concrete target_node OR polymorphic=true — never both, never a list of multiple targets. (3) DEFAULT TO CONCRETE target_node. Polymorphic is the ESCAPE HATCH — reserve for genuinely cross-cutting concepts like Comment or Tag (entities that validly attach to many distinct types). If you find yourself making most parents polymorphic, you are avoiding the design work — pick concrete relationships instead. If you can\'t pick a concrete parent, you may be missing a type — add the missing type first. (4) Same-type nesting is implicit: a node can be placed under another of its same type using the existing parent relation — never add a self-relation just to enable nesting. (5) Always provide `description` on every node type, attribute, and select value — one short, contrastive sentence (what it IS and what it is NOT vs sibling types/attrs/values). This is the single strongest disambiguation signal for future agents classifying nodes. Use to bootstrap an empty graph (cold-start) or fully replace mid-build (call naumu_get_schema first, send the FULL new schema — anything you omit is removed). Conventions: type names PascalCase (Company, Person, Feature), relation names UPPER_SNAKE_CASE (WORKS_AT, BELONGS_TO). Bias toward general types — refine via attributes or nested children, not type proliferation.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            schema: SchemaDefinitionSchema,
-        }),
-    }, async ({ graphId, schema }) => {
-        const data = await client.post(`/api/graphs/${graphId}/schema`, {
-            definition: schema,
-        });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=update-schema.js.map

package/dist/tools/update-schema.js.map

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

package/dist/tools/whoami.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerWhoami(server: McpServer, client: NaumuClient): void;