@fre4x/jules 1.0.55 → 1.0.57

package/dist/index.js

@@ -18438,22 +18438,26 @@ var require_follow_redirects = __commonJS({
 // ../packages/shared/dist/errors.js
 function createApiError(message, statusCode) {
   let hint = "Check your network connection and retry.";
+  let type = "Service Error";
   if (statusCode === 429) {
-    hint = "Rate limit exceeded. Suggestion: Wait for 60 seconds (Exponential Backoff) before retrying or reduce concurrent calls.";
+    type = "Rate Limit";
+    hint = "Request volume is too high. Suggestion: Wait briefly before retrying or reduce concurrent calls.";
   } else if (statusCode === 401 || statusCode === 403) {
-    hint = "Authentication failed. Suggestion: Verify your API key or token in the environment configuration.";
+    type = "Authentication Error";
+    hint = "The request could not be authorized. Suggestion: Verify your API key or token in the environment configuration.";
   } else if (statusCode && statusCode >= 500) {
-    hint = "Upstream service is having issues. Suggestion: This is a temporary external error. Try again in a few minutes.";
+    type = "Upstream Error";
+    hint = "The remote service is experiencing temporary issues. Suggestion: Try again in a few minutes.";
   } else if (statusCode === 404) {
-    hint = "The requested resource was not found. Suggestion: Check if the ID or Ticker is correct, or search for it first.";
+    type = "Not Found";
+    hint = "The requested information could not be found. Suggestion: Check if the ID, Ticker, or query parameters are correct.";
   }
-  const detail = statusCode ? ` (HTTP ${statusCode})` : "";
   return {
     isError: true,
     content: [
       {
         type: "text",
-        text: `API Error${detail}: ${message}
+        text: `${type}: ${message}
 
 **Next Action**: ${hint}`
       }
@@ -32497,7 +32501,8 @@ config(en_default());
 var zod_default = external_exports;
 
 // ../packages/shared/dist/pagination.js
-var z2 = external_exports || zod_default || zod_exports;
+var zodCompat = zod_exports;
+var z2 = zodCompat.z ?? zodCompat.default?.z ?? zodCompat.default ?? zodCompat;
 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)")
@@ -42095,14 +42100,26 @@ var MOCK_FIXTURES = {
 };
 
 // src/schemas/julesSchemas.ts
-var z3 = external_exports || zod_default || zod_exports;
-var ResponseFormatSchema = z3.enum(["markdown", "json"]).optional().describe("Output format: 'markdown' or 'json' (default: markdown)");
+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"),
-  response_format: ResponseFormatSchema
+  pageToken: z3.string().optional().describe("Page token for retrieving the next page")
 });
 var ListSourcesInputSchema = PaginationSchema;
+var ListSourcesOutputSchema = z3.object({
+  sources: z3.array(
+    z3.object({
+      name: z3.string(),
+      id: z3.string().optional(),
+      githubRepo: z3.object({
+        owner: z3.string(),
+        repo: z3.string()
+      }).optional()
+    })
+  ).optional(),
+  nextPageToken: z3.string().optional()
+});
 var CreateSessionInputSchema = z3.object({
   prompt: z3.string().describe("The user's goal or prompt for the session."),
   source: z3.string().describe(
@@ -42115,13 +42132,35 @@ var CreateSessionInputSchema = z3.object({
   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."
-  ),
-  response_format: ResponseFormatSchema
+  )
+});
+var CreateSessionOutputSchema = z3.object({
+  name: z3.string(),
+  prompt: z3.string().optional(),
+  title: z3.string().optional()
 });
 var ListSessionsInputSchema = PaginationSchema;
+var ListSessionsOutputSchema = z3.object({
+  sessions: z3.array(
+    z3.object({
+      name: z3.string(),
+      title: z3.string(),
+      state: z3.string().optional(),
+      githubPr: z3.object({
+        url: z3.string(),
+        number: z3.number()
+      }).optional()
+    })
+  ).optional(),
+  nextPageToken: z3.string().optional()
+});
 var ApprovePlanInputSchema = z3.object({
-  sessionId: z3.string().describe("The session ID or resource name (e.g., 'sessions/12345')."),
-  response_format: ResponseFormatSchema
+  sessionId: z3.string().describe("The session ID or resource name (e.g., 'sessions/12345').")
+});
+var ApprovePlanOutputSchema = z3.object({
+  success: z3.boolean(),
+  session: z3.string(),
+  data: z3.record(z3.string(), z3.any()).optional()
 });
 
 // ../node_modules/axios/lib/helpers/bind.js
@@ -45949,9 +45988,13 @@ function handleApiError(error48) {
     if (error48.response) {
       const status = error48.response.status;
       const data = error48.response.data;
-      const detail = String(
-        data?.error?.message ?? JSON.stringify(data) ?? "No details."
+      const rawDetail = String(
+        data?.error?.message ?? "No additional information available."
       );
+      const detail = rawDetail.replace(
+        /database|query|sql|internal|stack|trace|axios/gi,
+        "service"
+      ).slice(0, 500);
       switch (status) {
         case 400:
           return createApiError(`Bad Request: ${detail}`, 400);
@@ -45990,19 +46033,10 @@ function handleApiError(error48) {
 
 // src/tools/approvePlan.ts
 function registerApprovePlanTool(server2) {
-  server2.registerTool(
+  server2.tool(
     "jules_approve_plan",
-    {
-      title: "Approve Jules Session Plan",
-      description: "Approve a pending plan for a Jules session to proceed.",
-      inputSchema: ApprovePlanInputSchema,
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: true,
-        idempotentHint: false,
-        openWorldHint: false
-      }
-    },
+    "Approve a pending plan for a Jules session to proceed.",
+    ApprovePlanInputSchema.shape,
     async (params) => {
       try {
         const endpoint = params.sessionId.includes("/") ? `/${params.sessionId}:approvePlan` : `/v1alpha/sessions/${params.sessionId}:approvePlan`;
@@ -46011,27 +46045,23 @@ function registerApprovePlanTool(server2) {
           "POST",
           {}
         );
-        let textContent;
-        if (params.response_format !== "json" /* JSON */) {
-          textContent = `# Plan Approved
+        const textContent = `# Plan Approved
 
 Successfully approved plan for session \`${params.sessionId}\`.
 
 Use \`jules_list_sessions\` to monitor progress.`;
-        } else {
-          textContent = JSON.stringify(
-            { success: true, session: params.sessionId, data },
-            null,
-            2
-          );
-        }
         return {
           content: [
             {
               type: "text",
               text: truncateToLimit(textContent)
             }
-          ]
+          ],
+          structuredContent: {
+            success: true,
+            session: params.sessionId,
+            data
+          }
         };
       } catch (error48) {
         return handleApiError(error48);
@@ -46042,19 +46072,10 @@ Use \`jules_list_sessions\` to monitor progress.`;
 
 // src/tools/createSession.ts
 function registerCreateSessionTool(server2) {
-  server2.registerTool(
+  server2.tool(
     "jules_create_session",
-    {
-      title: "Create Jules Session",
-      description: "Create a new Jules session to work on a repository.",
-      inputSchema: CreateSessionInputSchema,
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false,
-        openWorldHint: false
-      }
-    },
+    "Create a new Jules session to work on a repository.",
+    CreateSessionInputSchema.shape,
     async (params) => {
       try {
         const data = IS_MOCK ? MOCK_FIXTURES.createSession : await julesApiRequest(
@@ -46074,28 +46095,24 @@ function registerCreateSessionTool(server2) {
           }
         );
         const sessionId = data.name;
-        let textContent;
-        if (params.response_format !== "json" /* JSON */) {
-          const lines = [
-            "# Session Created",
-            "",
-            `- **Session ID**: ${sessionId}`,
-            `- **Title**: ${data.title ?? params.title}`,
-            `- **Prompt**: ${data.prompt ?? params.prompt}`,
-            "",
-            "Use `jules_list_sessions` to check its status."
-          ];
-          textContent = lines.join("\n");
-        } else {
-          textContent = JSON.stringify(data, null, 2);
-        }
+        const lines = [
+          "# Session Created",
+          "",
+          `- **Session ID**: ${sessionId}`,
+          `- **Title**: ${data.title ?? params.title}`,
+          `- **Prompt**: ${data.prompt ?? params.prompt}`,
+          "",
+          "Use `jules_list_sessions` to check its status."
+        ];
+        const textContent = lines.join("\n");
         return {
           content: [
             {
               type: "text",
               text: truncateToLimit(textContent)
             }
-          ]
+          ],
+          structuredContent: data
         };
       } catch (error48) {
         return handleApiError(error48);
@@ -46106,19 +46123,10 @@ function registerCreateSessionTool(server2) {
 
 // src/tools/listSessions.ts
 function registerListSessionsTool(server2) {
-  server2.registerTool(
+  server2.tool(
     "jules_list_sessions",
-    {
-      title: "List Jules Sessions",
-      description: "List your active and past Jules sessions and their status.",
-      inputSchema: ListSessionsInputSchema,
-      annotations: {
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
+    "List your active and past Jules sessions and their status.",
+    ListSessionsInputSchema.shape,
     async (params) => {
       try {
         const queryParams = {
@@ -46140,37 +46148,36 @@ function registerListSessionsTool(server2) {
                 type: "text",
                 text: "No sessions found."
               }
-            ]
+            ],
+            structuredContent: {
+              sessions: [],
+              nextPageToken
+            }
           };
         }
-        const output = { sessions, nextPageToken };
-        let textContent;
-        if (params.response_format !== "json" /* JSON */) {
-          const lines = ["# Jules Sessions", ""];
-          for (const session of sessions) {
-            lines.push(`## ${session.title}`);
-            lines.push(`- **ID**: ${session.name}`);
-            if (session.state)
-              lines.push(`- **State**: ${session.state}`);
-            if (session.githubPr)
-              lines.push(
-                `- **GitHub PR**: #${session.githubPr.number} (${session.githubPr.url})`
-              );
-            lines.push("");
-          }
-          if (nextPageToken)
-            lines.push(`**Next Page Token**: ${nextPageToken}`);
-          textContent = lines.join("\n");
-        } else {
-          textContent = JSON.stringify(output, null, 2);
+        const lines = ["# Jules Sessions", ""];
+        for (const session of sessions) {
+          lines.push(`## ${session.title}`);
+          lines.push(`- **ID**: ${session.name}`);
+          if (session.state)
+            lines.push(`- **State**: ${session.state}`);
+          if (session.githubPr)
+            lines.push(
+              `- **GitHub PR**: #${session.githubPr.number} (${session.githubPr.url})`
+            );
+          lines.push("");
         }
+        if (nextPageToken)
+          lines.push(`**Next Page Token**: ${nextPageToken}`);
+        const textContent = lines.join("\n");
         return {
           content: [
             {
               type: "text",
               text: truncateToLimit(textContent)
             }
-          ]
+          ],
+          structuredContent: { sessions, nextPageToken }
         };
       } catch (error48) {
         return handleApiError(error48);
@@ -46181,19 +46188,10 @@ function registerListSessionsTool(server2) {
 
 // src/tools/listSources.ts
 function registerListSourcesTool(server2) {
-  server2.registerTool(
+  server2.tool(
     "jules_list_sources",
-    {
-      title: "List Jules Sources",
-      description: "List available sources (repositories) connected to Jules.",
-      inputSchema: ListSourcesInputSchema,
-      annotations: {
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
+    "List available sources (repositories) connected to Jules.",
+    ListSourcesInputSchema.shape,
     async (params) => {
       try {
         const queryParams = {
@@ -46215,35 +46213,34 @@ function registerListSourcesTool(server2) {
                 type: "text",
                 text: "No sources found."
               }
-            ]
+            ],
+            structuredContent: {
+              sources: [],
+              nextPageToken
+            }
           };
         }
-        const output = { sources, nextPageToken };
-        let textContent;
-        if (params.response_format !== "json" /* JSON */) {
-          const lines = ["# Jules Sources", ""];
-          for (const source of sources) {
-            lines.push(`## ${source.name}`);
-            if (source.id) lines.push(`- **ID**: ${source.id}`);
-            if (source.githubRepo)
-              lines.push(
-                `- **GitHub Repo**: ${source.githubRepo.owner}/${source.githubRepo.repo}`
-              );
-            lines.push("");
-          }
-          if (nextPageToken)
-            lines.push(`**Next Page Token**: ${nextPageToken}`);
-          textContent = lines.join("\n");
-        } else {
-          textContent = JSON.stringify(output, null, 2);
+        const lines = ["# Jules Sources", ""];
+        for (const source of sources) {
+          lines.push(`## ${source.name}`);
+          if (source.id) lines.push(`- **ID**: ${source.id}`);
+          if (source.githubRepo)
+            lines.push(
+              `- **GitHub Repo**: ${source.githubRepo.owner}/${source.githubRepo.repo}`
+            );
+          lines.push("");
         }
+        if (nextPageToken)
+          lines.push(`**Next Page Token**: ${nextPageToken}`);
+        const textContent = lines.join("\n");
         return {
           content: [
             {
               type: "text",
               text: truncateToLimit(textContent)
             }
-          ]
+          ],
+          structuredContent: { sources, nextPageToken }
         };
       } catch (error48) {
         return handleApiError(error48);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/jules",
-  "version": "1.0.55",
+  "version": "1.0.57",
   "description": "MCP server for Jules API integration",
   "type": "module",
   "bin": {