@nestr/mcp 0.1.72 → 0.1.89

package/build/tools/index.d.ts

@@ -4,6 +4,14 @@
  */
 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;
@@ -19,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>;
@@ -207,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;
@@ -352,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;
@@ -698,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>;
@@ -711,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;
@@ -724,6 +766,98 @@ 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;
+        _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;
+    }>, {
+        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;
@@ -737,6 +871,8 @@ export declare const schemas: {
         users?: unknown;
         accountabilities?: unknown;
         domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
     }>;
     modifyTensionPart: z.ZodObject<{
         nestId: z.ZodString;
@@ -939,13 +1075,38 @@ 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;
     }, {
-        topic: string;
+        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;
+    }, {
+        search?: string | undefined;
+        topic?: string | undefined;
+        includeImages?: boolean | undefined;
+        imageIndexes?: unknown;
+        maxImages?: unknown;
     }>;
+    diagnose: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 };
 export declare const toolDefinitions: ({
     annotations: {
@@ -961,7 +1122,109 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            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;
+            workspaceId?: undefined;
+            title?: undefined;
+            purpose?: undefined;
+            type?: undefined;
+            governance?: undefined;
+            plan?: undefined;
+            apps?: undefined;
+            layout?: undefined;
+            query?: undefined;
+            _listTitle?: undefined;
+            nestId?: undefined;
+            fieldsMetaData?: undefined;
+            hints?: undefined;
+            parentId?: undefined;
+            description?: undefined;
+            labels?: undefined;
+            fields?: undefined;
+            users?: undefined;
+            accountabilities?: undefined;
+            domains?: undefined;
+            data?: undefined;
+            due?: undefined;
+            completed?: undefined;
+            body?: undefined;
+            commentId?: undefined;
+            circleId?: undefined;
+            includeSubCircles?: undefined;
+            userId?: undefined;
+            endDate?: undefined;
+            metricId?: undefined;
+            depth?: undefined;
+            username?: undefined;
+            fullName?: undefined;
+            language?: undefined;
+            labelId?: undefined;
+            from?: undefined;
+            to?: undefined;
+            completedAfter?: undefined;
+            nestIds?: undefined;
+            position?: undefined;
+            relatedNestId?: undefined;
+            color?: undefined;
+            icon?: undefined;
+            fullWorkspaces?: undefined;
+            context?: undefined;
+            skip?: undefined;
+            showRead?: undefined;
+            group?: undefined;
+            feeling?: undefined;
+            needs?: undefined;
+            tensionId?: undefined;
+            order?: undefined;
+            _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
+            partId?: undefined;
+            childId?: undefined;
+            status?: undefined;
+            relation?: undefined;
+            direction?: undefined;
+            targetId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+    };
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1018,6 +1281,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1025,7 +1290,7 @@ export declare const toolDefinitions: ({
             direction?: undefined;
             targetId?: undefined;
         };
-        required: string[];
+        required?: undefined;
     };
 } | {
     annotations: {
@@ -1054,6 +1319,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1107,6 +1375,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1136,6 +1406,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -1190,6 +1463,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1247,6 +1522,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1296,6 +1574,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1341,6 +1621,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -1391,6 +1674,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1428,6 +1713,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -1480,6 +1768,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1525,6 +1815,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1575,6 +1868,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1648,6 +1943,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1694,6 +1992,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1783,6 +2083,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1825,6 +2128,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1850,6 +2155,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1905,6 +2213,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1932,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;
@@ -1951,7 +2271,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -1988,6 +2307,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2015,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;
@@ -2035,7 +2366,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -2071,6 +2401,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2096,6 +2428,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2151,6 +2486,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2188,6 +2525,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2240,6 +2580,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2281,6 +2623,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2332,6 +2677,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2373,6 +2720,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2424,6 +2774,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2453,6 +2805,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2507,6 +2862,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2543,6 +2900,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             stripDescription?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -2596,6 +2956,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2637,6 +2999,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2688,6 +3053,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2717,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;
@@ -2776,6 +3152,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2809,6 +3187,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -2862,6 +3243,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2891,6 +3274,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2945,6 +3331,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2982,6 +3370,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3034,6 +3425,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3063,6 +3456,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3117,6 +3513,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3158,6 +3556,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             title?: undefined;
@@ -3209,6 +3610,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3234,6 +3637,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3289,6 +3695,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3318,6 +3726,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3372,6 +3783,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3406,6 +3819,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3460,6 +3876,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3489,6 +3907,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3543,6 +3964,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3584,6 +4007,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3635,6 +4061,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3663,6 +4091,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3718,6 +4149,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3752,6 +4185,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3805,6 +4241,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3814,83 +4252,6 @@ export declare const toolDefinitions: ({
         };
         required: string[];
     };
-} | {
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-    };
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            topic?: undefined;
-            search?: undefined;
-            limit?: undefined;
-            page?: undefined;
-            stripDescription?: undefined;
-            workspaceId?: undefined;
-            title?: undefined;
-            purpose?: undefined;
-            type?: undefined;
-            governance?: undefined;
-            plan?: undefined;
-            apps?: undefined;
-            layout?: undefined;
-            query?: undefined;
-            _listTitle?: undefined;
-            nestId?: undefined;
-            fieldsMetaData?: undefined;
-            hints?: undefined;
-            parentId?: undefined;
-            description?: undefined;
-            labels?: undefined;
-            fields?: undefined;
-            users?: undefined;
-            accountabilities?: undefined;
-            domains?: undefined;
-            data?: undefined;
-            due?: undefined;
-            completed?: undefined;
-            body?: undefined;
-            commentId?: undefined;
-            circleId?: undefined;
-            includeSubCircles?: undefined;
-            userId?: undefined;
-            endDate?: undefined;
-            metricId?: undefined;
-            depth?: undefined;
-            username?: undefined;
-            fullName?: undefined;
-            language?: undefined;
-            labelId?: undefined;
-            from?: undefined;
-            to?: undefined;
-            completedAfter?: undefined;
-            nestIds?: undefined;
-            position?: undefined;
-            relatedNestId?: undefined;
-            color?: undefined;
-            icon?: undefined;
-            fullWorkspaces?: undefined;
-            context?: undefined;
-            skip?: undefined;
-            showRead?: undefined;
-            group?: undefined;
-            feeling?: undefined;
-            needs?: undefined;
-            tensionId?: undefined;
-            order?: undefined;
-            _id?: undefined;
-            partId?: undefined;
-            childId?: undefined;
-            status?: undefined;
-            relation?: undefined;
-            direction?: undefined;
-            targetId?: undefined;
-        };
-        required?: undefined;
-    };
 } | {
     annotations: {
         readOnlyHint: boolean;
@@ -3919,6 +4280,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3971,6 +4335,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4003,6 +4369,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4057,6 +4426,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4082,6 +4453,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -4137,6 +4511,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4171,6 +4547,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4225,6 +4604,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4250,6 +4631,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4305,6 +4689,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4330,6 +4716,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4385,6 +4774,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4427,6 +4818,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
@@ -4478,6 +4872,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4519,6 +4915,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4570,6 +4969,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4599,6 +5000,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4653,6 +5057,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4689,6 +5095,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
@@ -4742,6 +5151,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             tensionId?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4787,6 +5198,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4837,6 +5251,8 @@ export declare const toolDefinitions: ({
             group?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4916,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;
@@ -5043,6 +5470,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5088,6 +5518,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5120,6 +5552,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5174,6 +5609,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5202,6 +5639,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5256,6 +5696,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5295,6 +5737,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5347,6 +5792,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5383,6 +5830,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5436,6 +5886,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5467,6 +5919,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5521,6 +5976,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5553,6 +6010,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5607,6 +6067,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             relation?: undefined;
@@ -5648,6 +6110,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
             title?: undefined;
@@ -5701,6 +6166,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5732,6 +6199,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5787,6 +6257,8 @@ export declare const toolDefinitions: ({
             tensionId?: undefined;
             order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5799,11 +6271,29 @@ export type ToolResult = {
     content: Array<{
         type: "text";
         text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
     }>;
     isError?: boolean;
 };
 export declare function stripDescriptionFields(data: unknown): unknown;
 export declare function unescapeRichTextFields(args: Record<string, unknown>): Record<string, unknown>;
-export declare function handleToolCall(client: NestrClient, name: string, args: Record<string, unknown>): Promise<ToolResult>;
+/**
+ * Per-tool-call context. Carries session-level info that diagnose-style
+ * tools need but ordinary tools don't. Optional so tests/callers that don't
+ * have a session (CLI, stdio mode) can still call handleToolCall.
+ */
+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 {};
 //# sourceMappingURL=index.d.ts.map