@rozenite/tanstack-query-plugin 1.12.0 → 2.0.0

package/dist/sdk/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@rozenite/agent-shared"),a="@rozenite/tanstack-query-plugin",t={queryHash:{type:"string",description:"TanStack Query queryHash identifying the query."}},o={mutationId:{type:"number",description:"TanStack Query mutationId identifying the mutation."}},r={limit:{type:"number",description:"Maximum number of items to return. Defaults to 20. Maximum 100."},cursor:{type:"string",description:"Opaque pagination cursor from a previous list call."}},n={type:"object",properties:{}},i={getCacheSummary:e.defineAgentToolContract({name:"get-cache-summary",description:"Return aggregate TanStack Query cache health and count information.",inputSchema:n}),getOnlineStatus:e.defineAgentToolContract({name:"get-online-status",description:"Return the current TanStack Query onlineManager status.",inputSchema:n}),setOnlineStatus:e.defineAgentToolContract({name:"set-online-status",description:"Set the TanStack Query onlineManager status for testing offline/online behavior.",inputSchema:{type:"object",properties:{online:{type:"boolean",description:"Whether the TanStack Query onlineManager should be online."}},required:["online"]}}),listQueries:e.defineAgentToolContract({name:"list-queries",description:"List TanStack Query query summaries using cursor pagination.",inputSchema:{type:"object",properties:r}}),getQueryDetails:e.defineAgentToolContract({name:"get-query-details",description:"Return a JSON-safe TanStack Query query snapshot and observer summary.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),refetchQuery:e.defineAgentToolContract({name:"refetch-query",description:"Refetch a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),setQueryLoading:e.defineAgentToolContract({name:"set-query-loading",description:"Enable or disable TanStack Query loading-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...t,enabled:{type:"boolean",description:"Whether the loading-state simulation should be enabled."}},required:["queryHash","enabled"]}}),setQueryError:e.defineAgentToolContract({name:"set-query-error",description:"Enable or disable TanStack Query error-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...t,enabled:{type:"boolean",description:"Whether the error-state simulation should be enabled."}},required:["queryHash","enabled"]}}),invalidateQuery:e.defineAgentToolContract({name:"invalidate-query",description:"Invalidate a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),resetQuery:e.defineAgentToolContract({name:"reset-query",description:"Reset a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),removeQuery:e.defineAgentToolContract({name:"remove-query",description:"Remove a TanStack Query query from the cache by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),clearQueryCache:e.defineAgentToolContract({name:"clear-query-cache",description:"Clear the full TanStack Query query cache.",inputSchema:n}),listMutations:e.defineAgentToolContract({name:"list-mutations",description:"List TanStack Query mutation summaries using cursor pagination.",inputSchema:{type:"object",properties:r}}),getMutationDetails:e.defineAgentToolContract({name:"get-mutation-details",description:"Return a JSON-safe TanStack Query mutation snapshot for a mutationId.",inputSchema:{type:"object",properties:o,required:["mutationId"]}}),clearMutationCache:e.defineAgentToolContract({name:"clear-mutation-cache",description:"Clear the full TanStack Query mutation cache.",inputSchema:n})},u=e.defineAgentToolDescriptors(a,i);exports.TANSTACK_QUERY_AGENT_PLUGIN_ID=a;exports.tanstackQueryToolDefinitions=i;exports.tanstackQueryTools=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@rozenite/agent-shared"),n="@rozenite/tanstack-query-plugin",t={queryHash:{type:"string",description:"TanStack Query queryHash identifying the query."}},o={mutationId:{type:"number",description:"TanStack Query mutationId identifying the mutation."}},r={limit:{type:"number",description:"Maximum number of items to return. Defaults to 20. Maximum 100."},cursor:{type:"string",description:"Opaque pagination cursor from a previous list call."}},a={type:"object",properties:{}},i={getCacheSummary:e.defineAgentToolContract({name:"get-cache-summary",description:"Return aggregate TanStack Query cache health and count information.",inputSchema:a}),getOnlineStatus:e.defineAgentToolContract({name:"get-online-status",description:"Return the current TanStack Query onlineManager status.",inputSchema:a}),setOnlineStatus:e.defineAgentToolContract({name:"set-online-status",description:"Set the TanStack Query onlineManager status for testing offline/online behavior.",inputSchema:{type:"object",properties:{online:{type:"boolean",description:"Whether the TanStack Query onlineManager should be online."}},required:["online"]}}),listQueries:e.definePaginatedAgentToolContract({name:"list-queries",description:"List TanStack Query query summaries using cursor pagination.",inputSchema:{type:"object",properties:r},pagination:{kind:"cursor",fields:["queryHash","queryKey","status","fetchStatus","observersCount","isInvalidated","dataUpdatedAt","errorUpdatedAt","hasData","hasError"],defaultFields:["queryHash","queryKey","status","fetchStatus","hasError"]}}),getQueryDetails:e.defineAgentToolContract({name:"get-query-details",description:"Return a JSON-safe TanStack Query query snapshot and observer summary.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),refetchQuery:e.defineAgentToolContract({name:"refetch-query",description:"Refetch a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),setQueryLoading:e.defineAgentToolContract({name:"set-query-loading",description:"Enable or disable TanStack Query loading-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...t,enabled:{type:"boolean",description:"Whether the loading-state simulation should be enabled."}},required:["queryHash","enabled"]}}),setQueryError:e.defineAgentToolContract({name:"set-query-error",description:"Enable or disable TanStack Query error-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...t,enabled:{type:"boolean",description:"Whether the error-state simulation should be enabled."}},required:["queryHash","enabled"]}}),invalidateQuery:e.defineAgentToolContract({name:"invalidate-query",description:"Invalidate a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),resetQuery:e.defineAgentToolContract({name:"reset-query",description:"Reset a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),removeQuery:e.defineAgentToolContract({name:"remove-query",description:"Remove a TanStack Query query from the cache by queryHash.",inputSchema:{type:"object",properties:t,required:["queryHash"]}}),clearQueryCache:e.defineAgentToolContract({name:"clear-query-cache",description:"Clear the full TanStack Query query cache.",inputSchema:a}),listMutations:e.definePaginatedAgentToolContract({name:"list-mutations",description:"List TanStack Query mutation summaries using cursor pagination.",inputSchema:{type:"object",properties:r},pagination:{kind:"cursor",fields:["mutationId","mutationKey","status","isPaused","submittedAt","failureCount","hasData","hasError"],defaultFields:["mutationId","mutationKey","status","hasError"]}}),getMutationDetails:e.defineAgentToolContract({name:"get-mutation-details",description:"Return a JSON-safe TanStack Query mutation snapshot for a mutationId.",inputSchema:{type:"object",properties:o,required:["mutationId"]}}),clearMutationCache:e.defineAgentToolContract({name:"clear-mutation-cache",description:"Clear the full TanStack Query mutation cache.",inputSchema:a})},u=e.defineAgentToolDescriptors(n,i);exports.TANSTACK_QUERY_AGENT_PLUGIN_ID=n;exports.tanstackQueryToolDefinitions=i;exports.tanstackQueryTools=u;

package/dist/sdk/index.js

@@ -1,5 +1,5 @@
-import { defineAgentToolContract as e, defineAgentToolDescriptors as n } from "@rozenite/agent-shared";
-const i = "@rozenite/tanstack-query-plugin", t = {
+import { defineAgentToolContract as e, definePaginatedAgentToolContract as r, defineAgentToolDescriptors as i } from "@rozenite/agent-shared";
+const u = "@rozenite/tanstack-query-plugin", t = {
   queryHash: {
     type: "string",
     description: "TanStack Query queryHash identifying the query."
@@ -9,7 +9,7 @@ const i = "@rozenite/tanstack-query-plugin", t = {
     type: "number",
     description: "TanStack Query mutationId identifying the mutation."
   }
-}, a = {
+}, n = {
   limit: {
     type: "number",
     description: "Maximum number of items to return. Defaults to 20. Maximum 100."
@@ -18,19 +18,19 @@ const i = "@rozenite/tanstack-query-plugin", t = {
     type: "string",
     description: "Opaque pagination cursor from a previous list call."
   }
-}, r = {
+}, a = {
   type: "object",
   properties: {}
-}, u = {
+}, s = {
   getCacheSummary: e({
     name: "get-cache-summary",
     description: "Return aggregate TanStack Query cache health and count information.",
-    inputSchema: r
+    inputSchema: a
   }),
   getOnlineStatus: e({
     name: "get-online-status",
     description: "Return the current TanStack Query onlineManager status.",
-    inputSchema: r
+    inputSchema: a
   }),
   setOnlineStatus: e({
     name: "set-online-status",
@@ -46,12 +46,34 @@ const i = "@rozenite/tanstack-query-plugin", t = {
       required: ["online"]
     }
   }),
-  listQueries: e({
+  listQueries: r({
     name: "list-queries",
     description: "List TanStack Query query summaries using cursor pagination.",
     inputSchema: {
       type: "object",
-      properties: a
+      properties: n
+    },
+    pagination: {
+      kind: "cursor",
+      fields: [
+        "queryHash",
+        "queryKey",
+        "status",
+        "fetchStatus",
+        "observersCount",
+        "isInvalidated",
+        "dataUpdatedAt",
+        "errorUpdatedAt",
+        "hasData",
+        "hasError"
+      ],
+      defaultFields: [
+        "queryHash",
+        "queryKey",
+        "status",
+        "fetchStatus",
+        "hasError"
+      ]
     }
   }),
   getQueryDetails: e({
@@ -132,14 +154,28 @@ const i = "@rozenite/tanstack-query-plugin", t = {
   clearQueryCache: e({
     name: "clear-query-cache",
     description: "Clear the full TanStack Query query cache.",
-    inputSchema: r
+    inputSchema: a
   }),
-  listMutations: e({
+  listMutations: r({
     name: "list-mutations",
     description: "List TanStack Query mutation summaries using cursor pagination.",
     inputSchema: {
       type: "object",
-      properties: a
+      properties: n
+    },
+    pagination: {
+      kind: "cursor",
+      fields: [
+        "mutationId",
+        "mutationKey",
+        "status",
+        "isPaused",
+        "submittedAt",
+        "failureCount",
+        "hasData",
+        "hasError"
+      ],
+      defaultFields: ["mutationId", "mutationKey", "status", "hasError"]
     }
   }),
   getMutationDetails: e({
@@ -154,14 +190,14 @@ const i = "@rozenite/tanstack-query-plugin", t = {
   clearMutationCache: e({
     name: "clear-mutation-cache",
     description: "Clear the full TanStack Query mutation cache.",
-    inputSchema: r
+    inputSchema: a
   })
-}, c = n(
-  i,
-  u
+}, y = i(
+  u,
+  s
 );
 export {
-  i as TANSTACK_QUERY_AGENT_PLUGIN_ID,
-  u as tanstackQueryToolDefinitions,
-  c as tanstackQueryTools
+  u as TANSTACK_QUERY_AGENT_PLUGIN_ID,
+  s as tanstackQueryToolDefinitions,
+  y as tanstackQueryTools
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozenite/tanstack-query-plugin",
-  "version": "1.12.0",
+  "version": "2.0.0",
   "description": "TanStack Query for Rozenite.",
   "type": "module",
   "main": "./dist/react-native/index.cjs",
@@ -16,26 +16,22 @@
   },
   "dependencies": {
     "fast-deep-equal": "^3.1.3",
-    "@rozenite/agent-shared": "1.12.0",
-    "@rozenite/agent-bridge": "1.12.0",
-    "@rozenite/plugin-bridge": "1.12.0"
+    "@rozenite/agent-shared": "2.0.0",
+    "@rozenite/agent-bridge": "2.0.0",
+    "@rozenite/plugin-bridge": "2.0.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.0.0",
     "@tanstack/react-query-devtools": "^5.0.0",
-    "@types/react": "~19.2.2",
-    "autoprefixer": "^10.4.21",
-    "postcss": "^8.5.6",
-    "react": "19.2.0",
-    "react-dom": "19.2.0",
-    "react-native": "0.83.1",
+    "@types/react": "~19.2.3",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-native": "0.86.0",
     "react-native-web": "^0.21.2",
-    "tailwindcss": "^3.4.17",
-    "tailwindcss-animate": "^1.0.7",
     "typescript": "~5.9.3",
     "vite": "^7.3.1",
-    "@rozenite/vite-plugin": "1.12.0",
-    "rozenite": "1.12.0"
+    "@rozenite/vite-plugin": "2.0.0",
+    "rozenite": "2.0.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",

package/sdk.ts

@@ -4,10 +4,7 @@ import {
   tanstackQueryToolDefinitions,
 } from './src/shared/agent-tools.js';
 
-export {
-  TANSTACK_QUERY_AGENT_PLUGIN_ID,
-  tanstackQueryToolDefinitions,
-};
+export { TANSTACK_QUERY_AGENT_PLUGIN_ID, tanstackQueryToolDefinitions };
 
 export const tanstackQueryTools = defineAgentToolDescriptors(
   TANSTACK_QUERY_AGENT_PLUGIN_ID,

package/src/react-native/agent/__tests__/tanstack-query-agent.test.ts

@@ -106,10 +106,34 @@ describe('tanstack query agent controller', () => {
       'get-mutation-details',
       'clear-mutation-cache',
     ]);
-    expect(tanstackQueryToolDefinitions.setQueryLoading.inputSchema.required).toEqual([
-      'queryHash',
-      'enabled',
-    ]);
+    expect(
+      tanstackQueryToolDefinitions.setQueryLoading.inputSchema.required,
+    ).toEqual(['queryHash', 'enabled']);
+    expect(tanstackQueryToolDefinitions.listQueries.pagination).toMatchObject({
+      kind: 'cursor',
+      fields: expect.arrayContaining(['queryHash', 'status', 'fetchStatus']),
+    });
+  });
+
+  it('trims listQueries/listMutations defaultFields narrower than the full field set', () => {
+    const listQueriesPagination =
+      tanstackQueryToolDefinitions.listQueries.pagination;
+    const listMutationsPagination =
+      tanstackQueryToolDefinitions.listMutations.pagination;
+
+    expect(listQueriesPagination?.defaultFields?.length).toBeLessThan(
+      listQueriesPagination?.fields.length ?? 0,
+    );
+    for (const field of listQueriesPagination?.defaultFields ?? []) {
+      expect(listQueriesPagination?.fields).toContain(field);
+    }
+
+    expect(listMutationsPagination?.defaultFields?.length).toBeLessThan(
+      listMutationsPagination?.fields.length ?? 0,
+    );
+    for (const field of listMutationsPagination?.defaultFields ?? []) {
+      expect(listMutationsPagination?.fields).toContain(field);
+    }
   });
 
   it('lists queries with cursor pagination and invalidates stale cursors after additions', async () => {

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

@@ -41,7 +41,7 @@ const isPlainObject = (value: unknown): value is Record<string, unknown> => {
 
 export const serializeForAgent = (
   value: unknown,
-  seen = new WeakSet<object>()
+  seen = new WeakSet<object>(),
 ): AgentSafeValue => {
   if (value == null) {
     return null;
@@ -74,7 +74,7 @@ export const serializeForAgent = (
       stack: value.stack ?? null,
       cause: serializeForAgent(
         (value as Error & { cause?: unknown }).cause,
-        seen
+        seen,
       ),
     };
   }
@@ -85,7 +85,7 @@ export const serializeForAgent = (
 
   if (ArrayBuffer.isView(value)) {
     return Array.from(value as unknown as ArrayLike<number>).map((item) =>
-      typeof item === 'number' ? item : Number(item)
+      typeof item === 'number' ? item : Number(item),
     );
   }
 
@@ -131,7 +131,7 @@ const sanitizeLimit = (limit?: number) => {
 const encodeCursor = (
   kind: CursorKind,
   generation: number,
-  offset: number
+  offset: number,
 ): string => {
   return `${kind}:${generation}:${offset}`;
 };
@@ -139,12 +139,12 @@ const encodeCursor = (
 const decodeCursor = (
   cursor: string,
   kind: CursorKind,
-  generation: number
+  generation: number,
 ): number => {
   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.'
+      'Cursor does not match the requested listing. Run the command again.',
     );
   }
 
@@ -153,7 +153,7 @@ const decodeCursor = (
 
   if (!Number.isInteger(cursorGeneration) || cursorGeneration !== generation) {
     throw new Error(
-      'Cursor does not match the requested listing. Run the command again.'
+      'Cursor does not match the requested listing. Run the command again.',
     );
   }
 
@@ -168,7 +168,7 @@ const paginate = <T>(
   rows: T[],
   kind: CursorKind,
   generation: number,
-  input: PaginationInput
+  input: PaginationInput,
 ) => {
   const limit = sanitizeLimit(input.limit);
   const startIndex = input.cursor
@@ -211,7 +211,7 @@ export const TANSTACK_QUERY_AGENT_TOOLS = Object.values(
 );
 
 const pickObserverOptionsSummary = (
-  options: Record<string, unknown> | undefined
+  options: Record<string, unknown> | undefined,
 ): TanStackQueryObserverOptionsSummary | null => {
   if (!options) {
     return null;
@@ -238,7 +238,7 @@ const pickObserverOptionsSummary = (
 };
 
 const pickMutationOptionsSummary = (
-  options: MutationObserverOptions<unknown, Error, unknown, unknown>
+  options: MutationObserverOptions<unknown, Error, unknown, unknown>,
 ): TanStackQueryMutationOptionsSummary => {
   return {
     mutationKey: serializeForAgent(options.mutationKey),
@@ -270,11 +270,10 @@ const compareQueries = (a: Query, b: Query) => {
 
 const compareMutations = (
   a: Mutation<unknown, Error, unknown, unknown>,
-  b: Mutation<unknown, Error, unknown, unknown>
+  b: Mutation<unknown, Error, unknown, unknown>,
 ) => {
   return (
-    b.state.submittedAt - a.state.submittedAt ||
-    b.mutationId - a.mutationId
+    b.state.submittedAt - a.state.submittedAt || b.mutationId - a.mutationId
   );
 };
 
@@ -294,13 +293,13 @@ const getQuerySummary = (query: Query) => {
 };
 
 const getMutationStatus = (
-  state: MutationState<unknown, Error, unknown, unknown>
+  state: MutationState<unknown, Error, unknown, unknown>,
 ) => {
   return state.status;
 };
 
 const getMutationSummary = (
-  mutation: Mutation<unknown, Error, unknown, unknown>
+  mutation: Mutation<unknown, Error, unknown, unknown>,
 ) => {
   return {
     mutationId: mutation.mutationId,
@@ -323,7 +322,7 @@ const resolveQuery = (queryClient: QueryClient, queryHash: string) => {
       .map((entry) => entry.queryHash)
       .join(', ');
     throw new Error(
-      `Unknown queryHash "${queryHash}". Available: ${available || '(none)'}`
+      `Unknown queryHash "${queryHash}". Available: ${available || '(none)'}`,
     );
   }
 
@@ -343,7 +342,7 @@ const resolveMutation = (queryClient: QueryClient, mutationId: number) => {
       .map((entry) => entry.mutationId)
       .join(', ');
     throw new Error(
-      `Unknown mutationId "${mutationId}". Available: ${available || '(none)'}`
+      `Unknown mutationId "${mutationId}". Available: ${available || '(none)'}`,
     );
   }
 
@@ -360,7 +359,7 @@ export const buildTanStackQueryCacheSummary = (queryClient: QueryClient) => {
       total: queries.length,
       active: queries.filter((query) => query.getObserversCount() > 0).length,
       fetching: queries.filter(
-        (query) => query.state.fetchStatus === 'fetching'
+        (query) => query.state.fetchStatus === 'fetching',
       ).length,
       pending: queries.filter((query) => query.state.status === 'pending')
         .length,
@@ -372,10 +371,10 @@ export const buildTanStackQueryCacheSummary = (queryClient: QueryClient) => {
     mutations: {
       total: mutations.length,
       pending: mutations.filter(
-        (mutation) => mutation.state.status === 'pending'
+        (mutation) => mutation.state.status === 'pending',
       ).length,
       success: mutations.filter(
-        (mutation) => mutation.state.status === 'success'
+        (mutation) => mutation.state.status === 'success',
       ).length,
       error: mutations.filter((mutation) => mutation.state.status === 'error')
         .length,
@@ -384,7 +383,9 @@ export const buildTanStackQueryCacheSummary = (queryClient: QueryClient) => {
   };
 };
 
-export const createTanStackQueryAgentController = (queryClient: QueryClient) => {
+export const createTanStackQueryAgentController = (
+  queryClient: QueryClient,
+) => {
   const cursorState: CursorState = {
     queriesGeneration: 0,
     mutationsGeneration: 0,
@@ -421,7 +422,9 @@ export const createTanStackQueryAgentController = (queryClient: QueryClient) =>
     },
 
     listQueries(input: PaginationInput = {}) {
-      const queries = [...queryClient.getQueryCache().getAll()].sort(compareQueries);
+      const queries = [...queryClient.getQueryCache().getAll()].sort(
+        compareQueries,
+      );
       return {
         ...buildTanStackQueryCacheSummary(queryClient),
         total: queries.length,
@@ -429,7 +432,7 @@ export const createTanStackQueryAgentController = (queryClient: QueryClient) =>
           queries.map(getQuerySummary),
           'queries',
           cursorState.queriesGeneration,
-          input
+          input,
         ),
       };
     },
@@ -446,7 +449,7 @@ export const createTanStackQueryAgentController = (queryClient: QueryClient) =>
           observers: query.observers.map((observer) => ({
             queryHash: query.queryHash,
             options: pickObserverOptionsSummary(
-              observer.options as unknown as Record<string, unknown>
+              observer.options as unknown as Record<string, unknown>,
             ),
           })),
         },
@@ -503,7 +506,7 @@ export const createTanStackQueryAgentController = (queryClient: QueryClient) =>
 
     listMutations(input: PaginationInput = {}) {
       const mutations = [...queryClient.getMutationCache().getAll()].sort(
-        compareMutations
+        compareMutations,
       );
 
       return {
@@ -513,7 +516,7 @@ export const createTanStackQueryAgentController = (queryClient: QueryClient) =>
           mutations.map(getMutationSummary),
           'mutations',
           cursorState.mutationsGeneration,
-          input
+          input,
         ),
       };
     },

package/src/react-native/agent/useTanStackQueryAgentTools.ts

@@ -1,9 +1,7 @@
 import { useEffect, useMemo } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { useRozenitePluginAgentTool } from '@rozenite/agent-bridge';
-import {
-  createTanStackQueryAgentController,
-} from './tanstack-query-agent';
+import { createTanStackQueryAgentController } from './tanstack-query-agent';
 import {
   TANSTACK_QUERY_AGENT_PLUGIN_ID,
   tanstackQueryToolDefinitions,
@@ -12,7 +10,7 @@ import {
 export const useTanStackQueryAgentTools = (queryClient: QueryClient) => {
   const controller = useMemo(
     () => createTanStackQueryAgentController(queryClient),
-    [queryClient]
+    [queryClient],
   );
 
   useEffect(() => {

package/src/react-native/useHandleInitialData.ts

@@ -5,7 +5,7 @@ import { dehydrateQueryClient } from '../shared/dehydrate';
 
 export const useHandleInitialData = (
   queryClient: QueryClient,
-  client: TanStackQueryPluginClient | null
+  client: TanStackQueryPluginClient | null,
 ) => {
   useEffect(() => {
     if (!client) {

package/src/react-native/useSyncTanStackCache.ts

@@ -15,10 +15,10 @@ import { SerializableObserver, PartialQueryState } from '../shared/types';
 
 export const useSyncTanStackCache = (
   queryClient: QueryClient,
-  client: TanStackQueryPluginClient | null
+  client: TanStackQueryPluginClient | null,
 ) => {
   const previousObserversRef = useRef<Map<string, SerializableObserver[]>>(
-    new Map()
+    new Map(),
   );
 
   const handler = useMemo(() => {
@@ -188,7 +188,7 @@ export const useSyncTanStackCache = (
         ) {
           const dehydratedObservers = dehydrateObservers(query);
           const previousObservers = previousObserversRef.current.get(
-            query.queryHash
+            query.queryHash,
           );
 
           // For observerOptionsUpdated, only send if the observers actually changed
@@ -201,7 +201,7 @@ export const useSyncTanStackCache = (
 
           previousObserversRef.current.set(
             query.queryHash,
-            dehydratedObservers
+            dehydratedObservers,
           );
 
           client.send('sync-query-event', {

package/src/shared/agent-tools.ts

@@ -1,9 +1,14 @@
 import {
   defineAgentToolContract,
+  definePaginatedAgentToolContract,
   type AgentToolContract,
   type JSONSchema7,
 } from '@rozenite/agent-shared';
-import type { FetchStatus, MutationStatus, QueryStatus } from '@tanstack/react-query';
+import type {
+  FetchStatus,
+  MutationStatus,
+  QueryStatus,
+} from '@tanstack/react-query';
 import type { applyTanStackQueryDevtoolsAction } from '../react-native/devtools-actions';
 
 export const TANSTACK_QUERY_AGENT_PLUGIN_ID = '@rozenite/tanstack-query-plugin';
@@ -166,12 +171,14 @@ export type TanStackQueryGetCacheSummaryArgs = undefined;
 export type TanStackQueryGetCacheSummaryResult = TanStackQueryCacheSummary;
 export type TanStackQueryGetOnlineStatusArgs = undefined;
 export type TanStackQueryGetOnlineStatusResult = { online: boolean };
-export type TanStackQuerySetOnlineStatusArgs = TanStackQueryAgentOnlineStatusInput;
+export type TanStackQuerySetOnlineStatusArgs =
+  TanStackQueryAgentOnlineStatusInput;
 export type TanStackQuerySetOnlineStatusResult = { online: boolean };
 export type TanStackQueryListQueriesArgs = TanStackQueryAgentPaginationInput;
 export type TanStackQueryGetQueryDetailsArgs = TanStackQueryAgentQueryHashInput;
 export type TanStackQueryRefetchQueryArgs = TanStackQueryAgentQueryHashInput;
-export type TanStackQuerySetQueryLoadingArgs = TanStackQueryAgentQueryToggleInput;
+export type TanStackQuerySetQueryLoadingArgs =
+  TanStackQueryAgentQueryToggleInput;
 export type TanStackQuerySetQueryErrorArgs = TanStackQueryAgentQueryToggleInput;
 export type TanStackQueryInvalidateQueryArgs = TanStackQueryAgentQueryHashInput;
 export type TanStackQueryResetQueryArgs = TanStackQueryAgentQueryHashInput;
@@ -179,7 +186,8 @@ export type TanStackQueryRemoveQueryArgs = TanStackQueryAgentQueryHashInput;
 export type TanStackQueryClearQueryCacheArgs = undefined;
 export type TanStackQueryClearQueryCacheResult = TanStackQueryActionResult;
 export type TanStackQueryListMutationsArgs = TanStackQueryAgentPaginationInput;
-export type TanStackQueryGetMutationDetailsArgs = TanStackQueryAgentMutationIdInput;
+export type TanStackQueryGetMutationDetailsArgs =
+  TanStackQueryAgentMutationIdInput;
 export type TanStackQueryClearMutationCacheArgs = undefined;
 export type TanStackQueryClearMutationCacheResult = TanStackQueryActionResult;
 
@@ -200,7 +208,8 @@ const mutationActionProperties = {
 const paginationProperties = {
   limit: {
     type: 'number',
-    description: 'Maximum number of items to return. Defaults to 20. Maximum 100.',
+    description:
+      'Maximum number of items to return. Defaults to 20. Maximum 100.',
   },
   cursor: {
     type: 'string',
@@ -243,13 +252,14 @@ export const tanstackQueryToolDefinitions = {
       properties: {
         online: {
           type: 'boolean',
-          description: 'Whether the TanStack Query onlineManager should be online.',
+          description:
+            'Whether the TanStack Query onlineManager should be online.',
         },
       },
       required: ['online'],
     },
   }),
-  listQueries: defineAgentToolContract<
+  listQueries: definePaginatedAgentToolContract<
     TanStackQueryListQueriesArgs,
     TanStackQueryListQueriesResult
   >({
@@ -259,6 +269,28 @@ export const tanstackQueryToolDefinitions = {
       type: 'object',
       properties: paginationProperties,
     },
+    pagination: {
+      kind: 'cursor',
+      fields: [
+        'queryHash',
+        'queryKey',
+        'status',
+        'fetchStatus',
+        'observersCount',
+        'isInvalidated',
+        'dataUpdatedAt',
+        'errorUpdatedAt',
+        'hasData',
+        'hasError',
+      ],
+      defaultFields: [
+        'queryHash',
+        'queryKey',
+        'status',
+        'fetchStatus',
+        'hasError',
+      ],
+    },
   }),
   getQueryDetails: defineAgentToolContract<
     TanStackQueryGetQueryDetailsArgs,
@@ -368,16 +400,31 @@ export const tanstackQueryToolDefinitions = {
     description: 'Clear the full TanStack Query query cache.',
     inputSchema: emptyInputSchema,
   }),
-  listMutations: defineAgentToolContract<
+  listMutations: definePaginatedAgentToolContract<
     TanStackQueryListMutationsArgs,
     TanStackQueryListMutationsResult
   >({
     name: 'list-mutations',
-    description: 'List TanStack Query mutation summaries using cursor pagination.',
+    description:
+      'List TanStack Query mutation summaries using cursor pagination.',
     inputSchema: {
       type: 'object',
       properties: paginationProperties,
     },
+    pagination: {
+      kind: 'cursor',
+      fields: [
+        'mutationId',
+        'mutationKey',
+        'status',
+        'isPaused',
+        'submittedAt',
+        'failureCount',
+        'hasData',
+        'hasError',
+      ],
+      defaultFields: ['mutationId', 'mutationKey', 'status', 'hasError'],
+    },
   }),
   getMutationDetails: defineAgentToolContract<
     TanStackQueryGetMutationDetailsArgs,

package/src/shared/dehydrate.ts

@@ -33,7 +33,7 @@ export const dehydrateMutation = (mutation: Mutation): SerializableMutation => {
 };
 
 export const dehydrateQueryClient = (
-  queryClient: QueryClient
+  queryClient: QueryClient,
 ): SerializableQueryClient => {
   return {
     queries: queryClient.getQueryCache().getAll().map(dehydrateQuery),