@nestr/mcp 0.1.73 → 0.1.90

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,18 +27,47 @@ 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>;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         search?: string | undefined;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }, {
         search?: string | undefined;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }>;
@@ -70,18 +106,21 @@ export declare const schemas: {
     search: z.ZodObject<{
         workspaceId: z.ZodString;
         query: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
         _listTitle: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         workspaceId: string;
         query: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         _listTitle?: string | undefined;
     }, {
         workspaceId: string;
         query: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         _listTitle?: string | undefined;
@@ -101,18 +140,21 @@ export declare const schemas: {
     }>;
     getNestChildren: z.ZodObject<{
         nestId: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
         hints: z.ZodOptional<z.ZodBoolean>;
         _listTitle: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         nestId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         hints?: boolean | undefined;
         _listTitle?: string | undefined;
     }, {
         nestId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         hints?: boolean | undefined;
@@ -208,22 +250,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;
@@ -234,43 +282,52 @@ export declare const schemas: {
     }>;
     listCircles: z.ZodObject<{
         workspaceId: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }>;
     getCircleRoles: z.ZodObject<{
         workspaceId: z.ZodString;
         circleId: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         workspaceId: string;
         circleId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }, {
         workspaceId: string;
         circleId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }>;
     listRoles: z.ZodObject<{
         workspaceId: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
     }>;
@@ -337,29 +394,32 @@ export declare const schemas: {
     }>;
     getProjects: z.ZodObject<{
         workspaceId: z.ZodString;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         page: z.ZodOptional<z.ZodNumber>;
         _listTitle: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         _listTitle?: string | undefined;
     }, {
         workspaceId: string;
+        sort?: string | undefined;
         limit?: number | undefined;
         page?: number | undefined;
         _listTitle?: string | undefined;
     }>;
     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;
@@ -644,17 +704,23 @@ export declare const schemas: {
     listTensions: z.ZodObject<{
         nestId: z.ZodString;
         search: z.ZodOptional<z.ZodString>;
+        sort: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
+        page: z.ZodOptional<z.ZodNumber>;
         order: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         nestId: string;
         search?: string | undefined;
+        sort?: string | undefined;
         limit?: number | undefined;
+        page?: number | undefined;
         order?: string | undefined;
     }, {
         nestId: string;
         search?: string | undefined;
+        sort?: string | undefined;
         limit?: number | undefined;
+        page?: number | undefined;
         order?: string | undefined;
     }>;
     updateTension: z.ZodObject<{
@@ -699,7 +765,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 +778,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 +793,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;
@@ -738,6 +898,8 @@ export declare const schemas: {
         users?: unknown;
         accountabilities?: unknown;
         domains?: unknown;
+        roleId?: string | undefined;
+        removeNest?: boolean | undefined;
     }>;
     modifyTensionPart: z.ZodObject<{
         nestId: z.ZodString;
@@ -940,12 +1102,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;
     }, {
-        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, {}, {}>;
 };
@@ -963,7 +1149,28 @@ 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;
+            };
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1018,8 +1225,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1027,7 +1235,7 @@ export declare const toolDefinitions: ({
             direction?: undefined;
             targetId?: undefined;
         };
-        required: string[];
+        required?: undefined;
     };
 } | {
     annotations: {
@@ -1041,6 +1249,10 @@ export declare const toolDefinitions: ({
         properties: {
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1095,8 +1307,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1120,6 +1333,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -1133,6 +1350,9 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1184,8 +1404,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1215,6 +1436,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -1267,8 +1492,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1326,6 +1552,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1373,8 +1603,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1402,6 +1633,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -1420,6 +1655,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -1468,8 +1706,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1507,6 +1746,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -1557,8 +1800,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1582,6 +1826,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -1604,6 +1852,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             workspaceId?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -1652,8 +1903,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1727,6 +1979,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1771,8 +2027,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1862,6 +2119,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1902,8 +2163,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -1929,6 +2191,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -1982,8 +2248,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2011,8 +2278,19 @@ 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;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2030,7 +2308,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -2065,8 +2342,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2094,8 +2372,19 @@ 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;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2114,7 +2403,6 @@ export declare const toolDefinitions: ({
             hints?: undefined;
             parentId?: undefined;
             description?: undefined;
-            labels?: undefined;
             fields?: undefined;
             users?: undefined;
             accountabilities?: undefined;
@@ -2148,8 +2436,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2175,6 +2464,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2228,8 +2521,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2253,6 +2547,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -2267,6 +2565,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2317,8 +2618,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2346,6 +2648,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -2360,6 +2666,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2409,8 +2718,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2452,6 +2762,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2501,8 +2815,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2532,6 +2847,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2584,8 +2903,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2622,6 +2942,10 @@ export declare const toolDefinitions: ({
                 description: string;
             };
             topic?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             stripDescription?: undefined;
             title?: undefined;
             purpose?: undefined;
@@ -2673,8 +2997,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2698,6 +3023,10 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
@@ -2716,6 +3045,9 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             title?: undefined;
             purpose?: undefined;
             type?: undefined;
@@ -2765,8 +3097,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2796,11 +3129,21 @@ 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;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -2853,8 +3196,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2888,6 +3232,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             title?: undefined;
@@ -2939,8 +3287,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -2970,6 +3319,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3022,8 +3375,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3061,6 +3415,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3111,8 +3469,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3142,6 +3501,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3194,8 +3557,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3237,6 +3601,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             title?: undefined;
@@ -3286,8 +3654,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3313,6 +3682,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3366,8 +3739,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3397,6 +3771,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3449,8 +3827,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3485,6 +3864,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3537,8 +3920,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3568,6 +3952,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -3620,8 +4008,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3663,6 +4052,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3712,8 +4105,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3742,6 +4136,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3795,8 +4193,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3831,6 +4230,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3882,8 +4285,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -3921,6 +4325,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -3971,8 +4379,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4005,6 +4414,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4057,8 +4470,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4084,6 +4498,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             workspaceId?: undefined;
@@ -4137,8 +4555,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4173,6 +4592,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4225,8 +4648,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4252,6 +4676,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4305,8 +4733,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4332,6 +4761,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4385,8 +4818,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4429,6 +4863,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             page?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
@@ -4478,8 +4916,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4521,6 +4960,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4570,8 +5013,9 @@ export declare const toolDefinitions: ({
             showRead?: undefined;
             group?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4601,6 +5045,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4653,8 +5101,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4682,16 +5131,22 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sort: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description: string;
             };
-            order: {
+            page: {
                 type: string;
                 description: string;
             };
             topic?: undefined;
-            page?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
             title?: undefined;
@@ -4744,6 +5199,8 @@ export declare const toolDefinitions: ({
             needs?: undefined;
             tensionId?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4789,6 +5246,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4837,8 +5298,9 @@ export declare const toolDefinitions: ({
             skip?: undefined;
             showRead?: undefined;
             group?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -4918,8 +5380,20 @@ 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;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -4963,7 +5437,6 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5045,6 +5518,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5088,8 +5565,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5122,6 +5600,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5174,8 +5656,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5204,6 +5687,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5256,8 +5743,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5297,6 +5785,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5347,8 +5839,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             childId?: undefined;
             status?: undefined;
             relation?: undefined;
@@ -5385,6 +5878,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5436,8 +5933,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5469,6 +5967,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5521,8 +6023,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             status?: undefined;
             relation?: undefined;
             direction?: undefined;
@@ -5555,6 +6058,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5607,8 +6114,9 @@ export declare const toolDefinitions: ({
             group?: undefined;
             feeling?: undefined;
             needs?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             relation?: undefined;
@@ -5650,6 +6158,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             stripDescription?: undefined;
             workspaceId?: undefined;
             title?: undefined;
@@ -5701,8 +6213,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5734,6 +6247,10 @@ export declare const toolDefinitions: ({
             };
             topic?: undefined;
             search?: undefined;
+            includeImages?: undefined;
+            imageIndexes?: undefined;
+            maxImages?: undefined;
+            sort?: undefined;
             limit?: undefined;
             page?: undefined;
             stripDescription?: undefined;
@@ -5787,8 +6304,9 @@ export declare const toolDefinitions: ({
             feeling?: undefined;
             needs?: undefined;
             tensionId?: undefined;
-            order?: undefined;
             _id?: undefined;
+            roleId?: undefined;
+            removeNest?: undefined;
             partId?: undefined;
             childId?: undefined;
             status?: undefined;
@@ -5801,11 +6319,31 @@ 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>;
+/**
+ * Extract sort:/sort-order:/limit: directives from a search query string.
+ *
+ * The REST API only honors sorting and limits via the `sort`/`limit` query
+ * params — these operators inside the search string are dropped from free-text
+ * matching and otherwise ignored. Translating them here keeps the documented
+ * search syntax (see nestr_help('search')) working. The query string itself is
+ * sent unmodified: the server strips operator terms from text matching anyway.
+ *
+ * First occurrence wins for each directive, matching the server-side parsing
+ * of these operators elsewhere in Nestr.
+ */
+export declare function extractSearchDirectives(query: string): {
+    sort?: string;
+    limit?: number;
+};
 /**
  * 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
@@ -5813,6 +6351,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 {};