@rozenite/tanstack-query-plugin 2.4.0 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @rozenite/tanstack-query-plugin
 
+## 2.5.0
+
+### Minor Changes
+
+- [#541](https://github.com/callstackincubator/rozenite/pull/541) [`56cdf09`](https://github.com/callstackincubator/rozenite/commit/56cdf098c5b3ba2bfc8c4461b1631030c9b40e7d) Thanks [@V3RON](https://github.com/V3RON)! - `list-queries` and `list-mutations` now page with the shared agent cursor,
+  keyed by `queryHash` and `mutationId`. A query or mutation added while an
+  agent pages no longer invalidates its cursor, and a cursor whose row was
+  removed answers `reset: true` instead of an error. An invalid `limit` is now
+  an error instead of quietly falling back to 20.
+
+  Default changes, each reachable through an argument:
+
+  - `list-queries` default columns: `queryHash,queryKey,status,fetchStatus,hasError`
+    → `queryHash,status,fetchStatus,hasError` (`queryHash` already spells out
+    the key; `--fields queryKey` brings it back).
+  - Pages printed by the CLI: the full cache summary → `total` only. The SDK
+    result still carries the summary, and `get-cache-summary` returns it.
+  - `get-query-details` / `get-mutation-details` values: unbounded → 4 levels
+    deep, 512 characters per string and 100 items per array or object, with
+    cuts marked `[object(N keys)]`, `[array(N)]`, `[+N chars]`, a last
+    `"[+N items]"` array item or a last `"[+N keys]": true` object entry, and
+    `truncated: true`. Raise them with `maxDepth` / `maxValueLength` /
+    `maxItems`, or read one sub-tree with `path` (for example `data.items.0`).
+
+### Patch Changes
+
+- [#560](https://github.com/callstackincubator/rozenite/pull/560) [`a7985fa`](https://github.com/callstackincubator/rozenite/commit/a7985fa7876500ed5dd47bb3e61a97c75e0cfb58) Thanks [@V3RON](https://github.com/V3RON)! - The published packages no longer include development fixtures, tests and build
+  configuration (such as `rozenite.config.ts`, `__tests__` and `tsconfig.json`),
+  which makes installs smaller: `@rozenite/expo-atlas-plugin` alone drops from
+  about 6 MB to 90 KB. Every package now lists its `CHANGELOG.md`, so changelogs
+  ship. Plugins generated by `rozenite generate` get the same treatment: they
+  publish only their built output, without `rozenite.config.ts`, sources, tests
+  or build configuration.
+
+- [#560](https://github.com/callstackincubator/rozenite/pull/560) [`a7985fa`](https://github.com/callstackincubator/rozenite/commit/a7985fa7876500ed5dd47bb3e61a97c75e0cfb58) Thanks [@V3RON](https://github.com/V3RON)! - Fix dev-mode bundles (Re.Pack, webpack, Rspack and Vite) failing to resolve
+  `@rozenite/agent-bridge`, `@rozenite/agent-shared` and the other packages
+  that publish an `exports` map: it carried a `development` condition pointing at
+  TypeScript source that was not in the package. The published packages no
+  longer have that condition, so these tools pick the built output in every mode.
+
+  `rozenite build` also stops adding a `development` condition to a plugin's
+  `./sdk` export and removes the `./sdk.ts` one that earlier versions wrote; a
+  `development` condition you wrote yourself (any other value) is kept. If your
+  `package.json` has a `publishConfig.exports`, `rozenite build` now keeps its
+  managed entries (`.`, `./sdk`, `./metro`) in step with `exports`.
+
+- Updated dependencies [[`2a72f21`](https://github.com/callstackincubator/rozenite/commit/2a72f2115eb6eda0b806fa4fcdaf5427f8b2d2c9), [`fb29800`](https://github.com/callstackincubator/rozenite/commit/fb298007eea021f23863b1b6a9534cb62d5260bf), [`f59e90b`](https://github.com/callstackincubator/rozenite/commit/f59e90b8cb63cfbe045c1768bb482424a8650cb5), [`a7985fa`](https://github.com/callstackincubator/rozenite/commit/a7985fa7876500ed5dd47bb3e61a97c75e0cfb58), [`a7985fa`](https://github.com/callstackincubator/rozenite/commit/a7985fa7876500ed5dd47bb3e61a97c75e0cfb58)]:
+  - @rozenite/agent-shared@2.5.0
+  - @rozenite/agent-bridge@2.5.0
+  - @rozenite/plugin-bridge@2.5.0
+
 ## 2.4.0
 
 ### Patch Changes

package/dist/react-native/cjs/src/react-native/agent/tanstack-query-agent.js

@@ -2,10 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTanStackQueryAgentController = exports.buildTanStackQueryCacheSummary = exports.TANSTACK_QUERY_AGENT_TOOLS = exports.clearMutationCacheTool = exports.getMutationDetailsTool = exports.listMutationsTool = exports.clearQueryCacheTool = exports.removeQueryTool = exports.resetQueryTool = exports.invalidateQueryTool = exports.setQueryErrorTool = exports.setQueryLoadingTool = exports.refetchQueryTool = exports.getQueryDetailsTool = exports.listQueriesTool = exports.setOnlineStatusTool = exports.getOnlineStatusTool = exports.getCacheSummaryTool = exports.serializeForAgent = void 0;
 const react_query_1 = require("@tanstack/react-query");
+const agent_shared_1 = require("@rozenite/agent-shared");
 const devtools_actions_1 = require("../devtools-actions");
 const agent_tools_1 = require("../../shared/agent-tools");
-const DEFAULT_PAGE_LIMIT = 20;
-const MAX_PAGE_LIMIT = 100;
 const isPlainObject = (value) => {
     return !!value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype;
 };
@@ -62,47 +61,6 @@ const serializeForAgent = (value, seen = new WeakSet()) => {
     return String(value);
 };
 exports.serializeForAgent = serializeForAgent;
-const sanitizeLimit = (limit) => {
-    if (typeof limit !== 'number' ||
-        !Number.isFinite(limit) ||
-        !Number.isInteger(limit) ||
-        limit < 1) {
-        return DEFAULT_PAGE_LIMIT;
-    }
-    return Math.min(limit, MAX_PAGE_LIMIT);
-};
-const encodeCursor = (kind, generation, offset) => {
-    return `${kind}:${generation}:${offset}`;
-};
-const decodeCursor = (cursor, kind, generation) => {
-    const [cursorKind, rawGeneration, rawOffset] = cursor.split(':', 3);
-    if (cursorKind !== kind || !rawGeneration || !rawOffset) {
-        throw new Error('Cursor does not match the requested listing. Run the command again.');
-    }
-    const cursorGeneration = Number(rawGeneration);
-    const offset = Number(rawOffset);
-    if (!Number.isInteger(cursorGeneration) || cursorGeneration !== generation) {
-        throw new Error('Cursor does not match the requested listing. Run the command again.');
-    }
-    if (!Number.isInteger(offset) || offset < 0) {
-        throw new Error('Cursor is invalid. Run the command again.');
-    }
-    return offset;
-};
-const paginate = (rows, kind, generation, input) => {
-    const limit = sanitizeLimit(input.limit);
-    const startIndex = input.cursor ? decodeCursor(input.cursor, kind, generation) : 0;
-    const endIndex = Math.min(startIndex + limit, rows.length);
-    const hasMore = endIndex < rows.length;
-    return {
-        items: rows.slice(startIndex, endIndex),
-        page: {
-            limit,
-            hasMore,
-            ...(hasMore ? { nextCursor: encodeCursor(kind, generation, endIndex) } : {}),
-        },
-    };
-};
 exports.getCacheSummaryTool = agent_tools_1.tanstackQueryToolDefinitions.getCacheSummary;
 exports.getOnlineStatusTool = agent_tools_1.tanstackQueryToolDefinitions.getOnlineStatus;
 exports.setOnlineStatusTool = agent_tools_1.tanstackQueryToolDefinitions.setOnlineStatus;
@@ -198,6 +156,40 @@ const getMutationSummary = (mutation) => {
         hasError: mutation.state.error != null,
     };
 };
+/**
+ * Applies `path`, `maxDepth`, `maxValueLength` and `maxItems` to the named value fields
+ * of a details result. `path` must start with one of `fields`.
+ */
+const createValueBounder = (fields, args) => {
+    const bounds = (0, agent_shared_1.normalizeBoundedValueArgs)(args);
+    const pathField = bounds.path?.[0];
+    if (bounds.path && !fields.includes(pathField)) {
+        throw new Error(`"path" must start with ${fields.map((field) => `"${field}"`).join(', ')}.`);
+    }
+    let truncated = false;
+    return {
+        bound(field, value) {
+            const selected = bounds.path && pathField === field
+                ? (0, agent_shared_1.selectValuePath)(value, bounds.path.slice(1), [field])
+                : value;
+            const result = (0, agent_shared_1.boundValue)(selected, {
+                maxDepth: bounds.maxDepth,
+                maxValueLength: bounds.maxValueLength,
+                maxItems: bounds.maxItems,
+            });
+            truncated = truncated || result.truncated;
+            return result.value;
+        },
+        finish() {
+            return {
+                ...(bounds.path ? { path: bounds.path.join('.') } : {}),
+                truncated,
+            };
+        },
+    };
+};
+const QUERY_VALUE_FIELDS = ['data', 'error'];
+const MUTATION_VALUE_FIELDS = ['variables', 'data', 'error', 'context', 'failureReason'];
 const resolveQuery = (queryClient, queryHash) => {
     const query = queryClient.getQueryCache().get(queryHash);
     if (!query) {
@@ -250,21 +242,7 @@ const buildTanStackQueryCacheSummary = (queryClient) => {
 };
 exports.buildTanStackQueryCacheSummary = buildTanStackQueryCacheSummary;
 const createTanStackQueryAgentController = (queryClient) => {
-    const cursorState = {
-        queriesGeneration: 0,
-        mutationsGeneration: 0,
-    };
     return {
-        handleQueryCacheEvent(event) {
-            if (event.type === 'added' || event.type === 'removed') {
-                cursorState.queriesGeneration += 1;
-            }
-        },
-        handleMutationCacheEvent(event) {
-            if (event.type === 'added' || event.type === 'removed') {
-                cursorState.mutationsGeneration += 1;
-            }
-        },
         getCacheSummary() {
             return (0, exports.buildTanStackQueryCacheSummary)(queryClient);
         },
@@ -284,22 +262,29 @@ const createTanStackQueryAgentController = (queryClient) => {
             return {
                 ...(0, exports.buildTanStackQueryCacheSummary)(queryClient),
                 total: queries.length,
-                ...paginate(queries.map(getQuerySummary), 'queries', cursorState.queriesGeneration, input),
+                ...(0, agent_shared_1.paginateArray)(queries.map(getQuerySummary), {
+                    keyOf: (row) => row.queryHash,
+                    limit: input.limit,
+                    cursor: input.cursor,
+                    scope: 'queries',
+                }),
             };
         },
-        getQueryDetails({ queryHash }) {
+        getQueryDetails({ queryHash, ...boundArgs }) {
+            const bounder = createValueBounder(QUERY_VALUE_FIELDS, boundArgs);
             const query = resolveQuery(queryClient, queryHash);
             return {
                 summary: (0, exports.buildTanStackQueryCacheSummary)(queryClient),
                 query: {
                     ...getQuerySummary(query),
-                    data: (0, exports.serializeForAgent)(query.state.data),
-                    error: (0, exports.serializeForAgent)(query.state.error),
+                    data: bounder.bound('data', (0, exports.serializeForAgent)(query.state.data)),
+                    error: bounder.bound('error', (0, exports.serializeForAgent)(query.state.error)),
                     observers: query.observers.map((observer) => ({
                         queryHash: query.queryHash,
                         options: pickObserverOptionsSummary(observer.options),
                     })),
                 },
+                ...bounder.finish(),
             };
         },
         async refetchQuery({ queryHash }) {
@@ -348,22 +333,29 @@ const createTanStackQueryAgentController = (queryClient) => {
             return {
                 ...(0, exports.buildTanStackQueryCacheSummary)(queryClient),
                 total: mutations.length,
-                ...paginate(mutations.map(getMutationSummary), 'mutations', cursorState.mutationsGeneration, input),
+                ...(0, agent_shared_1.paginateArray)(mutations.map(getMutationSummary), {
+                    keyOf: (row) => row.mutationId,
+                    limit: input.limit,
+                    cursor: input.cursor,
+                    scope: 'mutations',
+                }),
             };
         },
-        getMutationDetails({ mutationId }) {
+        getMutationDetails({ mutationId, ...boundArgs }) {
+            const bounder = createValueBounder(MUTATION_VALUE_FIELDS, boundArgs);
             const mutation = resolveMutation(queryClient, mutationId);
             return {
                 summary: (0, exports.buildTanStackQueryCacheSummary)(queryClient),
                 mutation: {
                     ...getMutationSummary(mutation),
-                    variables: (0, exports.serializeForAgent)(mutation.state.variables),
-                    data: (0, exports.serializeForAgent)(mutation.state.data),
-                    error: (0, exports.serializeForAgent)(mutation.state.error),
-                    context: (0, exports.serializeForAgent)(mutation.state.context),
-                    failureReason: (0, exports.serializeForAgent)(mutation.state.failureReason),
+                    variables: bounder.bound('variables', (0, exports.serializeForAgent)(mutation.state.variables)),
+                    data: bounder.bound('data', (0, exports.serializeForAgent)(mutation.state.data)),
+                    error: bounder.bound('error', (0, exports.serializeForAgent)(mutation.state.error)),
+                    context: bounder.bound('context', (0, exports.serializeForAgent)(mutation.state.context)),
+                    failureReason: bounder.bound('failureReason', (0, exports.serializeForAgent)(mutation.state.failureReason)),
                     options: pickMutationOptionsSummary(mutation.options),
                 },
+                ...bounder.finish(),
             };
         },
         async clearMutationCache() {

package/dist/react-native/cjs/src/react-native/agent/useTanStackQueryAgentTools.js

@@ -7,18 +7,6 @@ const tanstack_query_agent_1 = require("./tanstack-query-agent");
 const agent_tools_1 = require("../../shared/agent-tools");
 const useTanStackQueryAgentTools = (queryClient) => {
     const controller = (0, react_1.useMemo)(() => (0, tanstack_query_agent_1.createTanStackQueryAgentController)(queryClient), [queryClient]);
-    (0, react_1.useEffect)(() => {
-        const unsubscribeQueryCache = queryClient
-            .getQueryCache()
-            .subscribe((event) => controller.handleQueryCacheEvent(event));
-        const unsubscribeMutationCache = queryClient
-            .getMutationCache()
-            .subscribe((event) => controller.handleMutationCacheEvent(event));
-        return () => {
-            unsubscribeQueryCache();
-            unsubscribeMutationCache();
-        };
-    }, [controller, queryClient]);
     (0, agent_bridge_1.useRozenitePluginAgentTool)({
         pluginId: agent_tools_1.TANSTACK_QUERY_AGENT_PLUGIN_ID,
         tool: agent_tools_1.tanstackQueryToolDefinitions.getCacheSummary,

package/dist/react-native/cjs/src/shared/agent-tools.js

@@ -22,7 +22,21 @@ const paginationProperties = {
     },
     cursor: {
         type: 'string',
-        description: 'Opaque pagination cursor from a previous list call.',
+        description: 'Opaque cursor from a previous page; the next page starts after the last row returned.',
+    },
+};
+const boundedValueProperties = {
+    maxDepth: {
+        type: 'integer',
+        description: 'Levels of nesting expanded below each returned value. Deeper objects and arrays collapse to "[object(N keys)]" / "[array(N)]". Defaults to 4, max 64.',
+    },
+    maxValueLength: {
+        type: 'integer',
+        description: 'Truncate string values longer than this, marking the cut with "[+N chars]". Defaults to 512.',
+    },
+    maxItems: {
+        type: 'integer',
+        description: 'Most array items or object keys returned per level; the rest are marked with a last "[+N items]" item or "[+N keys]" key. Defaults to 100, max 10000.',
     },
 };
 const emptyInputSchema = {
@@ -75,15 +89,23 @@ exports.tanstackQueryToolDefinitions = {
                 'hasData',
                 'hasError',
             ],
-            defaultFields: ['queryHash', 'queryKey', 'status', 'fetchStatus', 'hasError'],
+            defaultFields: ['queryHash', 'status', 'fetchStatus', 'hasError'],
+            meta: ['total'],
         },
     }),
     getQueryDetails: (0, agent_shared_1.defineAgentToolContract)({
         name: 'get-query-details',
-        description: 'Return a JSON-safe TanStack Query query snapshot and observer summary.',
+        description: 'Return a JSON-safe TanStack Query query snapshot and observer summary. data and error are cut to maxDepth levels, maxValueLength characters per string and maxItems entries per array or object; use path to read a deeper sub-tree.',
         inputSchema: {
             type: 'object',
-            properties: queryActionProperties,
+            properties: {
+                ...queryActionProperties,
+                path: {
+                    type: 'string',
+                    description: 'Dot path starting with "data" or "error" selecting the sub-tree to return, for example "data.items.0".',
+                },
+                ...boundedValueProperties,
+            },
             required: ['queryHash'],
         },
     }),
@@ -178,14 +200,22 @@ exports.tanstackQueryToolDefinitions = {
                 'hasError',
             ],
             defaultFields: ['mutationId', 'mutationKey', 'status', 'hasError'],
+            meta: ['total'],
         },
     }),
     getMutationDetails: (0, agent_shared_1.defineAgentToolContract)({
         name: 'get-mutation-details',
-        description: 'Return a JSON-safe TanStack Query mutation snapshot for a mutationId.',
+        description: 'Return a JSON-safe TanStack Query mutation snapshot for a mutationId. variables, data, error, context and failureReason are cut to maxDepth levels, maxValueLength characters per string and maxItems entries per array or object; use path to read a deeper sub-tree.',
         inputSchema: {
             type: 'object',
-            properties: mutationActionProperties,
+            properties: {
+                ...mutationActionProperties,
+                path: {
+                    type: 'string',
+                    description: 'Dot path starting with "variables", "data", "error", "context" or "failureReason" selecting the sub-tree to return, for example "variables.id".',
+                },
+                ...boundedValueProperties,
+            },
             required: ['mutationId'],
         },
     }),

package/dist/react-native/src/react-native/agent/tanstack-query-agent.d.ts

@@ -1,11 +1,12 @@
-import type { MutationCacheNotifyEvent, QueryCacheNotifyEvent, QueryClient } from '@tanstack/react-query';
+import type { QueryClient } from '@tanstack/react-query';
+import { type BoundedValueArgs } from '@rozenite/agent-shared';
 import { type TanStackQueryAgentMutationIdInput as MutationIdInput, type TanStackQueryAgentOnlineStatusInput as OnlineStatusInput, type TanStackQueryAgentPaginationInput as PaginationInput, type TanStackQueryAgentQueryHashInput as QueryHashInput, type TanStackQueryAgentQueryToggleInput as QueryToggleInput, type TanStackQueryAgentSafeValue as AgentSafeValue, type TanStackQueryMutationOptionsSummary, type TanStackQueryObserverOptionsSummary } from '../../shared/agent-tools';
 export declare const serializeForAgent: (value: unknown, seen?: WeakSet<object>) => AgentSafeValue;
 export declare const getCacheSummaryTool: import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryCacheSummary>;
 export declare const getOnlineStatusTool: import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryGetOnlineStatusResult>;
 export declare const setOnlineStatusTool: import("@rozenite/agent-shared").AgentToolContract<OnlineStatusInput, import("../../shared/agent-tools").TanStackQuerySetOnlineStatusResult>;
 export declare const listQueriesTool: import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListQueriesResult>;
-export declare const getQueryDetailsTool: import("@rozenite/agent-shared").AgentToolContract<QueryHashInput, import("../../shared/agent-tools").TanStackQueryGetQueryDetailsResult>;
+export declare const getQueryDetailsTool: import("@rozenite/agent-shared").AgentToolContract<import("../../shared/agent-tools").TanStackQueryGetQueryDetailsArgs, import("../../shared/agent-tools").TanStackQueryGetQueryDetailsResult>;
 export declare const refetchQueryTool: import("@rozenite/agent-shared").AgentToolContract<QueryHashInput, {
     applied: boolean;
     action: "CLEAR_QUERY_CACHE";
@@ -707,7 +708,7 @@ export declare const clearQueryCacheTool: import("@rozenite/agent-shared").Agent
     mutationCountAfter?: undefined;
 }>;
 export declare const listMutationsTool: import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListMutationsResult>;
-export declare const getMutationDetailsTool: import("@rozenite/agent-shared").AgentToolContract<MutationIdInput, import("../../shared/agent-tools").TanStackQueryGetMutationDetailsResult>;
+export declare const getMutationDetailsTool: import("@rozenite/agent-shared").AgentToolContract<import("../../shared/agent-tools").TanStackQueryGetMutationDetailsArgs, import("../../shared/agent-tools").TanStackQueryGetMutationDetailsResult>;
 export declare const clearMutationCacheTool: import("@rozenite/agent-shared").AgentToolContract<undefined, {
     applied: boolean;
     action: "CLEAR_QUERY_CACHE";
@@ -808,7 +809,7 @@ export declare const clearMutationCacheTool: import("@rozenite/agent-shared").Ag
     mutationCountBefore?: undefined;
     mutationCountAfter?: undefined;
 }>;
-export declare const TANSTACK_QUERY_AGENT_TOOLS: (import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryCacheSummary> | import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryGetOnlineStatusResult> | import("@rozenite/agent-shared").AgentToolContract<OnlineStatusInput, import("../../shared/agent-tools").TanStackQuerySetOnlineStatusResult> | import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListQueriesResult> | import("@rozenite/agent-shared").AgentToolContract<QueryHashInput, import("../../shared/agent-tools").TanStackQueryGetQueryDetailsResult> | import("@rozenite/agent-shared").AgentToolContract<QueryHashInput, {
+export declare const TANSTACK_QUERY_AGENT_TOOLS: (import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryCacheSummary> | import("@rozenite/agent-shared").AgentToolContract<undefined, import("../../shared/agent-tools").TanStackQueryGetOnlineStatusResult> | import("@rozenite/agent-shared").AgentToolContract<OnlineStatusInput, import("../../shared/agent-tools").TanStackQuerySetOnlineStatusResult> | import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListQueriesResult> | import("@rozenite/agent-shared").AgentToolContract<import("../../shared/agent-tools").TanStackQueryGetQueryDetailsArgs, import("../../shared/agent-tools").TanStackQueryGetQueryDetailsResult> | import("@rozenite/agent-shared").AgentToolContract<QueryHashInput, {
     applied: boolean;
     action: "CLEAR_QUERY_CACHE";
     cleared: boolean;
@@ -1105,7 +1106,7 @@ export declare const TANSTACK_QUERY_AGENT_TOOLS: (import("@rozenite/agent-shared
     queryCountAfter?: undefined;
     mutationCountBefore?: undefined;
     mutationCountAfter?: undefined;
-}> | import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListMutationsResult> | import("@rozenite/agent-shared").AgentToolContract<MutationIdInput, import("../../shared/agent-tools").TanStackQueryGetMutationDetailsResult>)[];
+}> | import("@rozenite/agent-shared").AgentToolContract<PaginationInput, import("../../shared/agent-tools").TanStackQueryListMutationsResult> | import("@rozenite/agent-shared").AgentToolContract<import("../../shared/agent-tools").TanStackQueryGetMutationDetailsArgs, import("../../shared/agent-tools").TanStackQueryGetMutationDetailsResult>)[];
 export declare const buildTanStackQueryCacheSummary: (queryClient: QueryClient) => {
     online: boolean;
     queries: {
@@ -1126,8 +1127,6 @@ export declare const buildTanStackQueryCacheSummary: (queryClient: QueryClient)
     };
 };
 export declare const createTanStackQueryAgentController: (queryClient: QueryClient) => {
-    handleQueryCacheEvent(event: QueryCacheNotifyEvent): void;
-    handleMutationCacheEvent(event: MutationCacheNotifyEvent): void;
     getCacheSummary(): {
         online: boolean;
         queries: {
@@ -1166,11 +1165,8 @@ export declare const createTanStackQueryAgentController: (queryClient: QueryClie
             hasData: boolean;
             hasError: boolean;
         }[];
-        page: {
-            nextCursor?: string | undefined;
-            limit: number;
-            hasMore: boolean;
-        };
+        page: import("@rozenite/agent-shared").PageEnvelope;
+        meta?: unknown;
         total: number;
         online: boolean;
         queries: {
@@ -1190,7 +1186,9 @@ export declare const createTanStackQueryAgentController: (queryClient: QueryClie
             paused: number;
         };
     };
-    getQueryDetails({ queryHash }: QueryHashInput): {
+    getQueryDetails({ queryHash, ...boundArgs }: QueryHashInput & BoundedValueArgs): {
+        truncated: boolean;
+        path?: string | undefined;
         summary: {
             online: boolean;
             queries: {
@@ -1940,11 +1938,8 @@ export declare const createTanStackQueryAgentController: (queryClient: QueryClie
             hasData: boolean;
             hasError: boolean;
         }[];
-        page: {
-            nextCursor?: string | undefined;
-            limit: number;
-            hasMore: boolean;
-        };
+        page: import("@rozenite/agent-shared").PageEnvelope;
+        meta?: unknown;
         total: number;
         online: boolean;
         queries: {
@@ -1964,7 +1959,9 @@ export declare const createTanStackQueryAgentController: (queryClient: QueryClie
             paused: number;
         };
     };
-    getMutationDetails({ mutationId }: MutationIdInput): {
+    getMutationDetails({ mutationId, ...boundArgs }: MutationIdInput & BoundedValueArgs): {
+        truncated: boolean;
+        path?: string | undefined;
         summary: {
             online: boolean;
             queries: {

package/dist/react-native/src/react-native/agent/tanstack-query-agent.js

@@ -1,8 +1,7 @@
 import { onlineManager } from '@tanstack/react-query';
+import { boundValue, normalizeBoundedValueArgs, paginateArray, selectValuePath, } from '@rozenite/agent-shared';
 import { applyTanStackQueryDevtoolsAction } from '../devtools-actions';
 import { tanstackQueryToolDefinitions, } from '../../shared/agent-tools';
-const DEFAULT_PAGE_LIMIT = 20;
-const MAX_PAGE_LIMIT = 100;
 const isPlainObject = (value) => {
     return !!value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype;
 };
@@ -58,47 +57,6 @@ export const serializeForAgent = (value, seen = new WeakSet()) => {
     }
     return String(value);
 };
-const sanitizeLimit = (limit) => {
-    if (typeof limit !== 'number' ||
-        !Number.isFinite(limit) ||
-        !Number.isInteger(limit) ||
-        limit < 1) {
-        return DEFAULT_PAGE_LIMIT;
-    }
-    return Math.min(limit, MAX_PAGE_LIMIT);
-};
-const encodeCursor = (kind, generation, offset) => {
-    return `${kind}:${generation}:${offset}`;
-};
-const decodeCursor = (cursor, kind, generation) => {
-    const [cursorKind, rawGeneration, rawOffset] = cursor.split(':', 3);
-    if (cursorKind !== kind || !rawGeneration || !rawOffset) {
-        throw new Error('Cursor does not match the requested listing. Run the command again.');
-    }
-    const cursorGeneration = Number(rawGeneration);
-    const offset = Number(rawOffset);
-    if (!Number.isInteger(cursorGeneration) || cursorGeneration !== generation) {
-        throw new Error('Cursor does not match the requested listing. Run the command again.');
-    }
-    if (!Number.isInteger(offset) || offset < 0) {
-        throw new Error('Cursor is invalid. Run the command again.');
-    }
-    return offset;
-};
-const paginate = (rows, kind, generation, input) => {
-    const limit = sanitizeLimit(input.limit);
-    const startIndex = input.cursor ? decodeCursor(input.cursor, kind, generation) : 0;
-    const endIndex = Math.min(startIndex + limit, rows.length);
-    const hasMore = endIndex < rows.length;
-    return {
-        items: rows.slice(startIndex, endIndex),
-        page: {
-            limit,
-            hasMore,
-            ...(hasMore ? { nextCursor: encodeCursor(kind, generation, endIndex) } : {}),
-        },
-    };
-};
 export const getCacheSummaryTool = tanstackQueryToolDefinitions.getCacheSummary;
 export const getOnlineStatusTool = tanstackQueryToolDefinitions.getOnlineStatus;
 export const setOnlineStatusTool = tanstackQueryToolDefinitions.setOnlineStatus;
@@ -194,6 +152,40 @@ const getMutationSummary = (mutation) => {
         hasError: mutation.state.error != null,
     };
 };
+/**
+ * Applies `path`, `maxDepth`, `maxValueLength` and `maxItems` to the named value fields
+ * of a details result. `path` must start with one of `fields`.
+ */
+const createValueBounder = (fields, args) => {
+    const bounds = normalizeBoundedValueArgs(args);
+    const pathField = bounds.path?.[0];
+    if (bounds.path && !fields.includes(pathField)) {
+        throw new Error(`"path" must start with ${fields.map((field) => `"${field}"`).join(', ')}.`);
+    }
+    let truncated = false;
+    return {
+        bound(field, value) {
+            const selected = bounds.path && pathField === field
+                ? selectValuePath(value, bounds.path.slice(1), [field])
+                : value;
+            const result = boundValue(selected, {
+                maxDepth: bounds.maxDepth,
+                maxValueLength: bounds.maxValueLength,
+                maxItems: bounds.maxItems,
+            });
+            truncated = truncated || result.truncated;
+            return result.value;
+        },
+        finish() {
+            return {
+                ...(bounds.path ? { path: bounds.path.join('.') } : {}),
+                truncated,
+            };
+        },
+    };
+};
+const QUERY_VALUE_FIELDS = ['data', 'error'];
+const MUTATION_VALUE_FIELDS = ['variables', 'data', 'error', 'context', 'failureReason'];
 const resolveQuery = (queryClient, queryHash) => {
     const query = queryClient.getQueryCache().get(queryHash);
     if (!query) {
@@ -245,21 +237,7 @@ export const buildTanStackQueryCacheSummary = (queryClient) => {
     };
 };
 export const createTanStackQueryAgentController = (queryClient) => {
-    const cursorState = {
-        queriesGeneration: 0,
-        mutationsGeneration: 0,
-    };
     return {
-        handleQueryCacheEvent(event) {
-            if (event.type === 'added' || event.type === 'removed') {
-                cursorState.queriesGeneration += 1;
-            }
-        },
-        handleMutationCacheEvent(event) {
-            if (event.type === 'added' || event.type === 'removed') {
-                cursorState.mutationsGeneration += 1;
-            }
-        },
         getCacheSummary() {
             return buildTanStackQueryCacheSummary(queryClient);
         },
@@ -279,22 +257,29 @@ export const createTanStackQueryAgentController = (queryClient) => {
             return {
                 ...buildTanStackQueryCacheSummary(queryClient),
                 total: queries.length,
-                ...paginate(queries.map(getQuerySummary), 'queries', cursorState.queriesGeneration, input),
+                ...paginateArray(queries.map(getQuerySummary), {
+                    keyOf: (row) => row.queryHash,
+                    limit: input.limit,
+                    cursor: input.cursor,
+                    scope: 'queries',
+                }),
             };
         },
-        getQueryDetails({ queryHash }) {
+        getQueryDetails({ queryHash, ...boundArgs }) {
+            const bounder = createValueBounder(QUERY_VALUE_FIELDS, boundArgs);
             const query = resolveQuery(queryClient, queryHash);
             return {
                 summary: buildTanStackQueryCacheSummary(queryClient),
                 query: {
                     ...getQuerySummary(query),
-                    data: serializeForAgent(query.state.data),
-                    error: serializeForAgent(query.state.error),
+                    data: bounder.bound('data', serializeForAgent(query.state.data)),
+                    error: bounder.bound('error', serializeForAgent(query.state.error)),
                     observers: query.observers.map((observer) => ({
                         queryHash: query.queryHash,
                         options: pickObserverOptionsSummary(observer.options),
                     })),
                 },
+                ...bounder.finish(),
             };
         },
         async refetchQuery({ queryHash }) {
@@ -343,22 +328,29 @@ export const createTanStackQueryAgentController = (queryClient) => {
             return {
                 ...buildTanStackQueryCacheSummary(queryClient),
                 total: mutations.length,
-                ...paginate(mutations.map(getMutationSummary), 'mutations', cursorState.mutationsGeneration, input),
+                ...paginateArray(mutations.map(getMutationSummary), {
+                    keyOf: (row) => row.mutationId,
+                    limit: input.limit,
+                    cursor: input.cursor,
+                    scope: 'mutations',
+                }),
             };
         },
-        getMutationDetails({ mutationId }) {
+        getMutationDetails({ mutationId, ...boundArgs }) {
+            const bounder = createValueBounder(MUTATION_VALUE_FIELDS, boundArgs);
             const mutation = resolveMutation(queryClient, mutationId);
             return {
                 summary: buildTanStackQueryCacheSummary(queryClient),
                 mutation: {
                     ...getMutationSummary(mutation),
-                    variables: serializeForAgent(mutation.state.variables),
-                    data: serializeForAgent(mutation.state.data),
-                    error: serializeForAgent(mutation.state.error),
-                    context: serializeForAgent(mutation.state.context),
-                    failureReason: serializeForAgent(mutation.state.failureReason),
+                    variables: bounder.bound('variables', serializeForAgent(mutation.state.variables)),
+                    data: bounder.bound('data', serializeForAgent(mutation.state.data)),
+                    error: bounder.bound('error', serializeForAgent(mutation.state.error)),
+                    context: bounder.bound('context', serializeForAgent(mutation.state.context)),
+                    failureReason: bounder.bound('failureReason', serializeForAgent(mutation.state.failureReason)),
                     options: pickMutationOptionsSummary(mutation.options),
                 },
+                ...bounder.finish(),
             };
         },
         async clearMutationCache() {