@fre4x/jules 1.0.64 → 1.0.65-beta.1

package/dist/index.js

@@ -32507,6 +32507,18 @@ var paginationSchema = z2.object({
   limit: z2.number().int().min(1).max(100).default(20).describe("Maximum results to return (1\u2013100, default 20)"),
   offset: z2.number().int().min(0).default(0).describe("Number of results to skip for pagination (default 0)")
 });
+function applyPagination(items, params) {
+  const { limit, offset } = params;
+  const total = items.length;
+  const sliced = items.slice(offset, offset + limit);
+  return {
+    items: sliced,
+    total,
+    offset,
+    limit,
+    hasMore: offset + limit < total
+  };
+}
 
 // ../packages/shared/dist/package.js
 import { createRequire as createJsonRequire } from "node:module";
@@ -42102,11 +42114,9 @@ var MOCK_FIXTURES = {
 // src/schemas/julesSchemas.ts
 var zodCompat2 = zod_exports;
 var z3 = zodCompat2.z ?? zodCompat2.default?.z ?? zodCompat2.default ?? zodCompat2;
-var PaginationSchema = z3.object({
-  pageSize: z3.number().int().min(1).max(100).default(20).describe("Maximum results to return"),
-  pageToken: z3.string().optional().describe("Page token for retrieving the next page")
+var ListSourcesInputSchema = paginationSchema.extend({
+  pageToken: z3.string().optional().describe("Upstream page token for retrieving the next API page")
 });
-var ListSourcesInputSchema = PaginationSchema;
 var ListSourcesOutputSchema = z3.object({
   sources: z3.array(
     z3.object({
@@ -42127,11 +42137,11 @@ var CreateSessionInputSchema = z3.object({
   ),
   startingBranch: z3.string().default("main").describe("The starting branch for the repository."),
   automationMode: z3.enum(["AUTO_CREATE_PR", "NONE"]).optional().describe(
-    "Whether to automatically create a PR ('AUTO_CREATE_PR' or 'NONE', default: 'NONE')."
+    "Whether Jules should auto-open a PR after the session ('AUTO_CREATE_PR' or 'NONE', default: 'NONE')."
   ),
   title: z3.string().describe("The title of the session."),
   requirePlanApproval: z3.boolean().default(false).describe(
-    "If true, requires an explicit call to approve_plan to proceed."
+    "If true, the session pauses after planning until jules_approve_plan is called."
   )
 });
 var CreateSessionOutputSchema = z3.object({
@@ -42139,7 +42149,9 @@ var CreateSessionOutputSchema = z3.object({
   prompt: z3.string().optional(),
   title: z3.string().optional()
 });
-var ListSessionsInputSchema = PaginationSchema;
+var ListSessionsInputSchema = paginationSchema.extend({
+  pageToken: z3.string().optional().describe("Upstream page token for retrieving the next API page")
+});
 var ListSessionsOutputSchema = z3.object({
   sessions: z3.array(
     z3.object({
@@ -42155,12 +42167,14 @@ var ListSessionsOutputSchema = z3.object({
   nextPageToken: z3.string().optional()
 });
 var ApprovePlanInputSchema = z3.object({
-  sessionId: z3.string().describe("The session ID or resource name (e.g., 'sessions/12345').")
+  sessionId: z3.string().describe(
+    "The paused session ID or resource name to unblock (e.g., 'sessions/12345')."
+  )
 });
 var ApprovePlanOutputSchema = z3.object({
   success: z3.boolean(),
   session: z3.string(),
-  data: z3.record(z3.string(), z3.any()).optional()
+  data: z3.record(z3.string(), z3.unknown()).optional()
 });
 
 // ../node_modules/axios/lib/helpers/bind.js
@@ -46035,7 +46049,7 @@ function handleApiError(error48) {
 function registerApprovePlanTool(server2) {
   server2.tool(
     "jules_approve_plan",
-    "Approve a pending plan for a Jules session to proceed.",
+    "Approve a plan-gated Jules session so execution can continue.",
     ApprovePlanInputSchema.shape,
     async (params) => {
       try {
@@ -46121,6 +46135,33 @@ function registerCreateSessionTool(server2) {
   );
 }
 
+// src/tools/paginationWindow.ts
+async function fetchPaginationWindow(params, fetchPage) {
+  const targetCount = params.offset + params.limit + 1;
+  const collected = [];
+  let nextPageToken = params.pageToken;
+  while (collected.length < targetCount) {
+    const page = await fetchPage({
+      pageSize: Math.max(
+        1,
+        Math.min(100, targetCount - collected.length)
+      ),
+      pageToken: nextPageToken
+    });
+    collected.push(...page.items);
+    nextPageToken = page.nextPageToken;
+    if (!page.items.length || !page.nextPageToken) {
+      break;
+    }
+  }
+  const paginated = applyPagination(collected, params);
+  return {
+    items: paginated.items,
+    nextPageToken,
+    hasMore: paginated.hasMore
+  };
+}
+
 // src/tools/listSessions.ts
 function registerListSessionsTool(server2) {
   server2.tool(
@@ -46129,19 +46170,25 @@ function registerListSessionsTool(server2) {
     ListSessionsInputSchema.shape,
     async (params) => {
       try {
-        const queryParams = {
-          pageSize: params.pageSize
-        };
-        if (params.pageToken) queryParams.pageToken = params.pageToken;
-        const data = IS_MOCK ? MOCK_FIXTURES.listSessions : await julesApiRequest(
-          "/v1alpha/sessions",
-          "GET",
-          void 0,
-          queryParams
+        const paginated = await fetchPaginationWindow(
+          params,
+          async ({ pageSize, pageToken }) => {
+            const data = IS_MOCK ? MOCK_FIXTURES.listSessions : await julesApiRequest(
+              "/v1alpha/sessions",
+              "GET",
+              void 0,
+              {
+                pageSize,
+                ...pageToken ? { pageToken } : {}
+              }
+            );
+            return {
+              items: data?.sessions ?? [],
+              nextPageToken: data?.nextPageToken
+            };
+          }
         );
-        const sessions = data?.sessions ?? [];
-        const nextPageToken = data?.nextPageToken;
-        if (!sessions.length) {
+        if (!paginated.items.length) {
           return {
             content: [
               {
@@ -46151,12 +46198,12 @@ function registerListSessionsTool(server2) {
             ],
             structuredContent: {
               sessions: [],
-              nextPageToken
+              nextPageToken: paginated.nextPageToken
             }
           };
         }
         const lines = ["# Jules Sessions", ""];
-        for (const session of sessions) {
+        for (const session of paginated.items) {
           lines.push(`## ${session.title}`);
           lines.push(`- **ID**: ${session.name}`);
           if (session.state)
@@ -46167,8 +46214,17 @@ function registerListSessionsTool(server2) {
             );
           lines.push("");
         }
-        if (nextPageToken)
-          lines.push(`**Next Page Token**: ${nextPageToken}`);
+        if (paginated.nextPageToken) {
+          lines.push(
+            `**Next API Page Token**: ${paginated.nextPageToken}`
+          );
+        }
+        if (paginated.hasMore) {
+          lines.push(
+            `
+*More sessions available locally. Increase offset to view.*`
+          );
+        }
         const textContent = lines.join("\n");
         return {
           content: [
@@ -46177,7 +46233,10 @@ function registerListSessionsTool(server2) {
               text: truncateToLimit(textContent)
             }
           ],
-          structuredContent: { sessions, nextPageToken }
+          structuredContent: {
+            sessions: paginated.items,
+            nextPageToken: paginated.nextPageToken
+          }
         };
       } catch (error48) {
         return handleApiError(error48);
@@ -46194,19 +46253,25 @@ function registerListSourcesTool(server2) {
     ListSourcesInputSchema.shape,
     async (params) => {
       try {
-        const queryParams = {
-          pageSize: params.pageSize
-        };
-        if (params.pageToken) queryParams.pageToken = params.pageToken;
-        const data = IS_MOCK ? MOCK_FIXTURES.listSources : await julesApiRequest(
-          "/v1alpha/sources",
-          "GET",
-          void 0,
-          queryParams
+        const paginated = await fetchPaginationWindow(
+          params,
+          async ({ pageSize, pageToken }) => {
+            const data = IS_MOCK ? MOCK_FIXTURES.listSources : await julesApiRequest(
+              "/v1alpha/sources",
+              "GET",
+              void 0,
+              {
+                pageSize,
+                ...pageToken ? { pageToken } : {}
+              }
+            );
+            return {
+              items: data?.sources ?? [],
+              nextPageToken: data?.nextPageToken
+            };
+          }
         );
-        const sources = data?.sources ?? [];
-        const nextPageToken = data?.nextPageToken;
-        if (!sources.length) {
+        if (!paginated.items.length) {
           return {
             content: [
               {
@@ -46216,12 +46281,12 @@ function registerListSourcesTool(server2) {
             ],
             structuredContent: {
               sources: [],
-              nextPageToken
+              nextPageToken: paginated.nextPageToken
             }
           };
         }
         const lines = ["# Jules Sources", ""];
-        for (const source of sources) {
+        for (const source of paginated.items) {
           lines.push(`## ${source.name}`);
           if (source.id) lines.push(`- **ID**: ${source.id}`);
           if (source.githubRepo)
@@ -46230,8 +46295,17 @@ function registerListSourcesTool(server2) {
             );
           lines.push("");
         }
-        if (nextPageToken)
-          lines.push(`**Next Page Token**: ${nextPageToken}`);
+        if (paginated.nextPageToken) {
+          lines.push(
+            `**Next API Page Token**: ${paginated.nextPageToken}`
+          );
+        }
+        if (paginated.hasMore) {
+          lines.push(
+            `
+*More sources available locally. Increase offset to view.*`
+          );
+        }
         const textContent = lines.join("\n");
         return {
           content: [
@@ -46240,7 +46314,10 @@ function registerListSourcesTool(server2) {
               text: truncateToLimit(textContent)
             }
           ],
-          structuredContent: { sources, nextPageToken }
+          structuredContent: {
+            sources: paginated.items,
+            nextPageToken: paginated.nextPageToken
+          }
         };
       } catch (error48) {
         return handleApiError(error48);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/jules",
-  "version": "1.0.64",
+  "version": "1.0.65-beta.1",
   "description": "MCP server for Jules API integration",
   "type": "module",
   "bin": {
@@ -16,8 +16,8 @@
     "build": "node ../scripts/build-package.mjs",
     "typecheck": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsc --noEmit",
     "inspector": "npm run build && node ../scripts/run-official-inspector.mjs node dist/index.js",
-    "test": "vitest run --exclude dist",
-    "test:watch": "vitest",
+    "test": "node ../scripts/run-vitest.mjs run --exclude dist",
+    "test:watch": "node ../scripts/run-vitest.mjs",
     "clean": "rm -rf dist"
   },
   "engines": {