@nestr/mcp 0.1.73 → 0.1.89

package/build/tools/index.d.ts

@@ -5,6 +5,13 @@
 import { z } from "zod";
 import { type NestrClient } from "../api/client.js";
 import type { DiagnoseSnapshot } from "../util/diagnose.js";
+export declare const PUBLIC_TOOL_NAMES: ReadonlySet<string>;
+export declare const PUBLIC_GUEST_ME: {
+    readonly authMode: "public";
+    readonly user: null;
+    readonly mode: "guest";
+    readonly hint: "Guest mode: product help only. Add AI credit / sign in for workspace tools.";
+};
 type CompletableSource = "inbox" | "daily-plan" | "children" | "projects" | "search";
 export declare function completableResponse(data: unknown, source: CompletableSource, title: string): {
     title: string;
@@ -20,7 +27,33 @@ export declare function compactResponse<T>(data: T[] | {
     meta?: unknown;
     data: Partial<T>[];
 } | T;
+/**
+ * Single endpoint object the API returns inside hint.endpoints.
+ * `body_example` is intentionally snake_case — it's a passthrough from the API.
+ */
+export interface ApiHintEndpoint {
+    purpose: string;
+    method: string;
+    path: string;
+    body_example?: Record<string, unknown>;
+}
+/**
+ * Per-endpoint MCP-tool guidance produced by translateEndpoint.
+ * Field names follow this codebase's camelCase convention (e.g. `toolCall`).
+ */
+export interface EnrichedToolCall {
+    tool: string;
+    purpose: string;
+    parametersExample: Record<string, unknown>;
+    notes?: string;
+}
+/**
+ * Translate one API hint endpoint into an MCP tool-call suggestion.
+ * Returns null for routes we don't have a mapping for — never guesses a tool.
+ */
+export declare function translateEndpoint(endpoint: ApiHintEndpoint): EnrichedToolCall | null;
 export declare function enrichHints<T>(data: T): T;
+export declare function addNestUrls<T>(data: T): T;
 export declare const schemas: {
     listWorkspaces: z.ZodObject<{
         search: z.ZodOptional<z.ZodString>;
@@ -208,22 +241,28 @@ export declare const schemas: {
     addComment: z.ZodObject<{
         nestId: z.ZodString;
         body: z.ZodString;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         nestId: string;
         body: string;
+        labels?: string[] | undefined;
     }, {
         nestId: string;
         body: string;
+        labels?: string[] | undefined;
     }>;
     updateComment: z.ZodObject<{
         commentId: z.ZodString;
         body: z.ZodString;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         body: string;
         commentId: string;
+        labels?: string[] | undefined;
     }, {
         body: string;
         commentId: string;
+        labels?: string[] | undefined;
     }>;
     deleteComment: z.ZodObject<{
         commentId: z.ZodString;
@@ -353,13 +392,13 @@ export declare const schemas: {
     }>;
     getComments: z.ZodObject<{
         nestId: z.ZodString;
-        depth: z.ZodOptional<z.ZodNumber>;
+        depth: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"all">]>>;
     }, "strip", z.ZodTypeAny, {
         nestId: string;
-        depth?: number | undefined;
+        depth?: number | "all" | undefined;
     }, {
         nestId: string;
-        depth?: number | undefined;
+        depth?: number | "all" | undefined;
     }>;
     getCircle: z.ZodObject<{
         workspaceId: z.ZodString;
@@ -699,7 +738,7 @@ export declare const schemas: {
         nestId: string;
         tensionId: string;
     }>;
-    addTensionPart: z.ZodObject<{
+    addTensionPart: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
         nestId: z.ZodString;
         tensionId: z.ZodString;
         _id: z.ZodOptional<z.ZodString>;
@@ -712,6 +751,8 @@ export declare const schemas: {
         due: z.ZodOptional<z.ZodString>;
         accountabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
         domains: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+        roleId: z.ZodOptional<z.ZodString>;
+        removeNest: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         nestId: string;
         tensionId: string;
@@ -725,6 +766,38 @@ export declare const schemas: {
         users?: string[] | undefined;
         accountabilities?: string[] | undefined;
         domains?: string[] | undefined;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: unknown;
+        due?: string | undefined;
+        users?: unknown;
+        accountabilities?: unknown;
+        domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }>, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: string[] | undefined;
+        due?: string | undefined;
+        users?: string[] | undefined;
+        accountabilities?: string[] | undefined;
+        domains?: string[] | undefined;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
     }, {
         nestId: string;
         tensionId: string;
@@ -738,6 +811,68 @@ export declare const schemas: {
         users?: unknown;
         accountabilities?: unknown;
         domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }>, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: string[] | undefined;
+        due?: string | undefined;
+        users?: string[] | undefined;
+        accountabilities?: string[] | undefined;
+        domains?: string[] | undefined;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: unknown;
+        due?: string | undefined;
+        users?: unknown;
+        accountabilities?: unknown;
+        domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }>, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: string[] | undefined;
+        due?: string | undefined;
+        users?: string[] | undefined;
+        accountabilities?: string[] | undefined;
+        domains?: string[] | undefined;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
+    }, {
+        nestId: string;
+        tensionId: string;
+        _id?: string | undefined;
+        title?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        parentId?: string | undefined;
+        labels?: unknown;
+        due?: string | undefined;
+        users?: unknown;
+        accountabilities?: unknown;
+        domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
     }>;
     modifyTensionPart: z.ZodObject<{
         nestId: z.ZodString;
@@ -940,12 +1075,36 @@ export declare const schemas: {
         relation: string;
         targetId: string;
     }>;
-    help: z.ZodObject<{
-        topic: z.ZodString;
+    help: z.ZodEffects<z.ZodObject<{
+        topic: z.ZodOptional<z.ZodString>;
+        search: z.ZodOptional<z.ZodString>;
+        includeImages: z.ZodOptional<z.ZodBoolean>;
+        imageIndexes: z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>, number[] | undefined, unknown>;
+        maxImages: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
     }, "strip", z.ZodTypeAny, {
-        topic: string;
+        search?: string | undefined;
+        topic?: string | undefined;
+        includeImages?: boolean | undefined;
+        imageIndexes?: number[] | undefined;
+        maxImages?: number | undefined;
+    }, {
+        search?: string | undefined;
+        topic?: string | undefined;
+        includeImages?: boolean | undefined;
+        imageIndexes?: unknown;
+        maxImages?: unknown;
+    }>, {
+        search?: string | undefined;
+        topic?: string | undefined;
+        includeImages?: boolean | undefined;
+        imageIndexes?: number[] | undefined;
+        maxImages?: number | undefined;
     }, {
-        topic: string;
+        search?: string | undefined;
+        topic?: string | undefined;
+        includeImages?: boolean | undefined;
+        imageIndexes?: unknown;
+        maxImages?: unknown;
     }>;
     diagnose: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 };
@@ -963,7 +1122,27 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
-            search?: undefined;
+            search: {
+                type: string;
+                description: string;
+            };
+            includeImages: {
+                type: string;
+                description: string;
+            };
+            imageIndexes: {
+                type: string;
+                items: {
+                    type: string;
+                    minimum: number;
+                };
+                description: string;
+            };
+            maxImages: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1020,6 +1199,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1027,7 +1208,7 @@ export declare const toolDefinitions: ({
             direction?: undefined;
             targetId?: undefined;
         };
-        required: string[];
+        required?: undefined;
     };
 } | {
     annotations: {
@@ -1041,6 +1222,9 @@ export declare const toolDefinitions: ({
         properties: {
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1097,6 +1281,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1133,6 +1319,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1186,6 +1375,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1215,6 +1406,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -1269,6 +1463,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1326,6 +1522,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1375,6 +1574,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1420,6 +1621,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -1470,6 +1674,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1507,6 +1713,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -1559,6 +1768,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1604,6 +1815,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1654,6 +1868,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1727,6 +1943,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1773,6 +1992,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1862,6 +2083,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1904,6 +2128,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1929,6 +2155,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1984,6 +2213,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2011,8 +2242,18 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2030,7 +2271,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -2067,6 +2307,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2094,8 +2336,18 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2114,7 +2366,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -2150,6 +2401,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2175,6 +2428,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2230,6 +2486,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2267,6 +2525,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2319,6 +2580,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2360,6 +2623,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2411,6 +2677,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2452,6 +2720,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2503,6 +2774,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2532,6 +2805,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2586,6 +2862,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2622,6 +2900,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             stripDescription?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -2675,6 +2956,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2716,6 +2999,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2767,6 +3053,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2796,11 +3084,20 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             depth: {
-                type: string;
+                oneOf: ({
+                    type: string;
+                    enum?: undefined;
+                } | {
+                    type: string;
+                    enum: string[];
+                })[];
                 description: string;
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2855,6 +3152,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2888,6 +3187,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -2941,6 +3243,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2970,6 +3274,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3024,6 +3331,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3061,6 +3370,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3113,6 +3425,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3142,6 +3456,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3196,6 +3513,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3237,6 +3556,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             title?: undefined;
@@ -3288,6 +3610,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3313,6 +3637,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3368,6 +3695,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3397,6 +3726,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3451,6 +3783,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3485,6 +3819,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3539,6 +3876,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3568,6 +3907,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3622,6 +3964,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3663,6 +4007,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3714,6 +4061,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3742,6 +4091,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3797,6 +4149,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3831,6 +4185,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3884,6 +4241,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3921,6 +4280,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3973,6 +4335,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4005,6 +4369,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4059,6 +4426,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4084,6 +4453,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -4139,6 +4511,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4173,6 +4547,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4227,6 +4604,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4252,6 +4631,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4307,6 +4689,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4332,6 +4716,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4387,6 +4774,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4429,6 +4818,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
@@ -4480,6 +4872,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4521,6 +4915,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4572,6 +4969,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4601,6 +5000,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4655,6 +5057,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4691,6 +5095,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
@@ -4744,6 +5151,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             tensionId?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4789,6 +5198,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4839,6 +5251,8 @@ export declare const toolDefinitions: ({
             group?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4918,8 +5332,19 @@ export declare const toolDefinitions: ({
                 };
                 description: string;
             };
+            roleId: {
+                type: string;
+                description: string;
+            };
+            removeNest: {
+                type: string;
+                description: string;
+            };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5045,6 +5470,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5090,6 +5518,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5122,6 +5552,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5176,6 +5609,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5204,6 +5639,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5258,6 +5696,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5297,6 +5737,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5349,6 +5792,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5385,6 +5830,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5438,6 +5886,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5469,6 +5919,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5523,6 +5976,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5555,6 +6010,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5609,6 +6067,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             relation?: undefined;
@@ -5650,6 +6110,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
             title?: undefined;
@@ -5703,6 +6166,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5734,6 +6199,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5789,6 +6257,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5801,6 +6271,10 @@ export type ToolResult = {
     content: Array<{
         type: "text";
         text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
     }>;
     isError?: boolean;
 };
@@ -5813,6 +6287,12 @@ export declare function unescapeRichTextFields(args: Record<string, unknown>): R
  */
 export interface ToolCallContext {
     getDiagnose?: () => DiagnoseSnapshot;
+    /**
+     * When true, this call came in on the PUBLIC (unauthenticated) MCP surface.
+     * Only PUBLIC_TOOL_NAMES are permitted, and nestr_get_me returns a guest
+     * payload without contacting the Nestr API. Any other tool is refused.
+     */
+    isPublic?: boolean;
 }
 export declare function handleToolCall(client: NestrClient, name: string, args: Record<string, unknown>, context?: ToolCallContext): Promise<ToolResult>;
 export {};