gaunt-sloth-assistant 0.7.2 → 0.7.3

package/dist/providers/jiraIssueProvider.js

@@ -1,6 +1,5 @@
 import { display, displayError, displayWarning } from '#src/consoleUtils.js';
-import { env } from '#src/systemUtils.js';
-import { ProgressIndicator } from '#src/utils.js';
+import { getJiraCredentials, jiraRequest } from '#src/helpers/jira/jiraClient.js';
 /**
  * Gets Jira issue using Atlassian REST API v3 with Personal Access Token
  *
@@ -19,28 +18,9 @@ export async function get(config, issueId) {
         displayWarning('No issue ID provided');
         return null;
     }
-    // Get username from environment variable or config
-    const username = env.JIRA_USERNAME || config.username;
-    if (!username) {
-        throw new Error('Missing JIRA username. The username can be defined as JIRA_USERNAME environment variable or as "username" in config.');
-    }
-    // Get token from environment variable or config
-    const token = env.JIRA_API_PAT_TOKEN || config.token;
-    if (!token) {
-        throw new Error('Missing JIRA PAT token. The token can be defined as JIRA_API_PAT_TOKEN environment variable or as "token" in config.');
-    }
-    // Get cloud ID from environment variable or config
-    const cloudId = env.JIRA_CLOUD_ID || config.cloudId;
-    if (!cloudId) {
-        throw new Error('Missing JIRA Cloud ID. The Cloud ID can be defined as JIRA_CLOUD_ID environment variable or as "cloudId" in config.');
-    }
+    const credentials = getJiraCredentials(config);
     try {
-        const issue = await getJiraIssue({
-            ...config,
-            username,
-            token,
-            cloudId,
-        }, issueId);
+        const issue = await getJiraIssue(credentials, issueId);
         if (!issue) {
             return null;
         }
@@ -63,43 +43,20 @@ export async function get(config, issueId) {
  * @param jiraKey Jira issue ID
  * @returns Jira issue response
  */
-async function getJiraIssue(config, jiraKey) {
+async function getJiraIssue(credentials, jiraKey) {
     // Jira Cloud ID can be found by authenticated user at https://company.atlassian.net/_edge/tenant_info
     // According to doc https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get permissions to read this resource:
     // https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issues/#api-rest-api-2-issue-issueidorkey-get
     // either Classic (RECOMMENDED) read:jira-work
-    // or Granular read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira, read:issue.changelog:jira, read:avatar:jira, read:issue:jira, read:status:jira, read:user:jira, read:field-configuration:jira
-    const apiUrl = `https://api.atlassian.com/ex/jira/${config.cloudId}/rest/api/2/issue/${jiraKey}`;
-    if (config.displayUrl) {
-        display(`Loading Jira issue ${config.displayUrl}${jiraKey}`);
+    // or Granular read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira, read:issue.changelog:jira,
+    // read:avatar:jira, read:issue:jira, read:status:jira, read:user:jira, read:field-configuration:jira
+    if (credentials.displayUrl) {
+        display(`Loading Jira issue ${credentials.displayUrl}${jiraKey}`);
     }
     // This filter will be necessary for V3: `&expand=renderedFields` to convert ADF to HTML
     const filters = '?fields=summary,description'; // Limit JSON to summary and description
-    // Encode credentials for Basic Authentication header
-    const credentials = `${config.username}:${config.token}`;
-    const encodedCredentials = Buffer.from(credentials).toString('base64');
-    const authHeader = `Basic ${encodedCredentials}`;
-    // Define request headers
-    const headers = {
-        Authorization: authHeader,
-        Accept: 'application/json; charset=utf-8',
-        'Accept-Language': 'en-US,en;q=0.9', // Prevents errors in other languages
-    };
-    const progressIndicator = new ProgressIndicator(`Retrieving jira from api ${apiUrl.replace(/^https?:\/\//, '')}`);
-    const response = await fetch(apiUrl + filters, {
+    return jiraRequest(credentials, `/rest/api/2/issue/${jiraKey}${filters}`, {
         method: 'GET',
-        headers: headers,
     });
-    progressIndicator.stop();
-    if (!response?.ok) {
-        try {
-            const errorData = await response.json();
-            throw new Error(`Failed to fetch Jira issue: ${response.statusText} - ${JSON.stringify(errorData)}`);
-        }
-        catch (_e) {
-            throw new Error(`Failed to fetch Jira issue: ${response?.statusText}`);
-        }
-    }
-    return response.json();
 }
 //# sourceMappingURL=jiraIssueProvider.js.map

package/dist/providers/jiraIssueProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"jiraIssueProvider.js","sourceRoot":"","sources":["../../src/providers/jiraIssueProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jiraIssueProvider.js","sourceRoot":"","sources":["../../src/providers/jiraIssueProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAYlF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,MAAkC,EAClC,OAA2B;IAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,cAAc,CAAC,yBAAyB,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;QAE7C,OAAO,eAAe,OAAO,cAAc,OAAO,qBAAqB,WAAW,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CACV,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,YAAY,CACzB,WAAsF,EACtF,OAAe;IAEf,sGAAsG;IAEtG,0KAA0K;IAC1K,sHAAsH;IACtH,8CAA8C;IAC9C,qHAAqH;IACrH,qGAAqG;IAErG,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,sBAAsB,WAAW,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,wFAAwF;IACxF,MAAM,OAAO,GAAG,6BAA6B,CAAC,CAAC,wCAAwC;IAEvF,OAAO,WAAW,CAAoB,WAAW,EAAE,qBAAqB,OAAO,GAAG,OAAO,EAAE,EAAE;QAC3F,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/gthJiraLogWorkTool.d.ts

@@ -0,0 +1,3 @@
+import { type StructuredToolInterface } from '@langchain/core/tools';
+import { SlothConfig } from '#src/config.js';
+export declare function get(config: SlothConfig): StructuredToolInterface<import("@langchain/core/tools").ToolSchemaBase, any, any>;

package/dist/tools/gthJiraLogWorkTool.js

@@ -0,0 +1,37 @@
+import { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { displayWarning } from '#src/consoleUtils.js';
+import jiraLogWork from '#src/helpers/jira/jiraLogWork.js';
+// Define the input schema for the tool
+const gthJiraLogWorkSchema = z.object({
+    jiraId: z.string().describe('The Jira issue ID (e.g., "PROJ-123")'),
+    timeInSeconds: z.number().describe('Time spent in seconds'),
+    comment: z.string().optional().describe('Work log comment'),
+    startedAt: z.string().optional().describe('ISO 8601 date string for when work started'),
+});
+const toolDefinition = {
+    name: 'gth_jira_log_work',
+    description: `Gaunt Sloth Jira Log Work Tool. Log work time to a Jira issue. Requires Jira configuration with credentials.
+Example: gth_jira_log_work({ jiraId: "PROJ-123", timeInSeconds: 3600, comment: "Implemented feature X" })`,
+    schema: gthJiraLogWorkSchema,
+};
+function getToolImpl(config) {
+    let toolImpl = async ({ jiraId, timeInSeconds, comment = 'Work logged', startedAt, }) => {
+        const jiraConfig = config || {};
+        const startDate = startedAt ? new Date(startedAt) : new Date();
+        return await jiraLogWork(jiraConfig, jiraId, timeInSeconds, comment, startDate);
+    };
+    return tool(toolImpl, toolDefinition);
+}
+// Export a default instance that uses environment variables
+export function get(config) {
+    if (!config.prebuiltToolsConfig?.jira && config.requirementsProviderConfig?.jira) {
+        displayWarning('config.prebuiltToolsConfig.jira is not defined. Using config.requirementsProviderConfig.jira.');
+    }
+    let jiraConfig = config.prebuiltToolsConfig?.jira || config.requirementsProviderConfig?.jira;
+    if (!jiraConfig) {
+        throw new Error('gth_jira_log_work is added to preBuiltTools, but no Jira config is provided.');
+    }
+    return getToolImpl(jiraConfig);
+}
+//# sourceMappingURL=gthJiraLogWorkTool.js.map

package/dist/tools/gthJiraLogWorkTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gthJiraLogWorkTool.js","sourceRoot":"","sources":["../../src/tools/gthJiraLogWorkTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,WAAW,MAAM,kCAAkC,CAAC;AAI3D,uCAAuC;AACvC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACnE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;0GAC2F;IACxG,MAAM,EAAE,oBAAoB;CAC7B,CAAC;AAEF,SAAS,WAAW,CAAC,MAA4B;IAC/C,IAAI,QAAQ,GAAG,KAAK,EAAE,EACpB,MAAM,EACN,aAAa,EACb,OAAO,GAAG,aAAa,EACvB,SAAS,GAC4B,EAAmB,EAAE;QAC1D,MAAM,UAAU,GAAG,MAAM,IAAI,EAAE,CAAC;QAEhC,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAE/D,OAAO,MAAM,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,GAAG,CAAC,MAAmB;IACrC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,IAAI,MAAM,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC;QACjF,cAAc,CACZ,+FAA+F,CAChG,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,GAAG,MAAM,CAAC,mBAAmB,EAAE,IAAI,IAAI,MAAM,CAAC,0BAA0B,EAAE,IAAI,CAAC;IAC7F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/gthStatusUpdateTool.d.ts

@@ -0,0 +1,2 @@
+import { SlothConfig } from '#src/config.js';
+export declare function get(_: SlothConfig): import("@langchain/core/tools").DynamicTool<void>;

package/dist/tools/gthStatusUpdateTool.js

@@ -0,0 +1,16 @@
+import { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import chalk from 'chalk';
+import { display } from '#src/consoleUtils.js';
+const toolDefinition = {
+    name: 'gth_status_update',
+    description: `Gaunt Sloth Status Update Tool. Use this tool to update status in the console. Example: gth_status_update "Working on something important", be brief, feel free to use emojis. Update after using tools.`,
+    schema: z.string(),
+};
+const toolImpl = (s) => {
+    display(chalk.grey(s));
+};
+export function get(_) {
+    return tool(toolImpl, toolDefinition);
+}
+//# sourceMappingURL=gthStatusUpdateTool.js.map

package/dist/tools/gthStatusUpdateTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gthStatusUpdateTool.js","sourceRoot":"","sources":["../../src/tools/gthStatusUpdateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,0MAA0M;IACvN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC;AACF,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAQ,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAc;IAChC,OAAO,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC"}

package/docs/DEVELOPMENT.md

@@ -18,3 +18,29 @@ Running unit tests:
 ```shell
 npm run test
 ```
+
+## Running tests on both Windows and WSL
+
+If you first installed deps on Windows and then running tests on WSL
+or vice versa you're likely to experience an error like
+
+```
+Error: Cannot find module @rollup/rollup-linux-x64-gnu. npm has a bug related to optional dependencies 
+```
+
+or 
+
+```
+'tsc' is not recognized as an internal or external command, operable program or batch file.
+```
+
+Simply install that missing *optional* rollup dependency or TypeScript without saving it, 
+like that:
+
+`npm install @rollup/rollup-linux-x64-gnu --no-save`
+
+or 
+
+`npm install typescript --no-save`
+
+This will allow switching between environments and run tests in both.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaunt-sloth-assistant",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "",
   "license": "MIT",
   "author": "Andrew Kondratev",

package/src/builtInToolsConfig.ts

@@ -0,0 +1,99 @@
+import GthFileSystemToolkit from '#src/tools/GthFileSystemToolkit.js';
+import { StructuredToolInterface } from '@langchain/core/tools';
+import { SlothConfig } from '#src/config.js';
+import { displayWarning } from '#src/consoleUtils.js';
+import { getCurrentDir } from '#src/systemUtils.js';
+
+const AVAILABLE_BUILT_IN_TOOLS = {
+  gth_status_update: '#src/tools/gthStatusUpdateTool.js',
+  gth_jira_log_work: '#src/tools/gthJiraLogWorkTool.js',
+};
+
+/**
+ * Get default tools based on filesystem and built-in tools configuration
+ */
+export async function getDefaultTools(config: SlothConfig): Promise<StructuredToolInterface[]> {
+  const filesystemTools = filterFilesystemTools(
+    new GthFileSystemToolkit([getCurrentDir()]),
+    config.filesystem
+  );
+  const builtInTools = await getBuiltInTools(config);
+
+  return [...filesystemTools, ...builtInTools];
+}
+
+/**
+ * Filter filesystem tools based on configuration
+ */
+function filterFilesystemTools(
+  toolkit: GthFileSystemToolkit,
+  filesystemConfig: string[] | 'all' | 'read' | 'none'
+): StructuredToolInterface[] {
+  if (filesystemConfig === 'all') {
+    return toolkit.getTools();
+  }
+
+  if (filesystemConfig === 'none') {
+    return [];
+  }
+
+  if (filesystemConfig === 'read') {
+    // Read-only: only allow read operations
+    return toolkit.getFilteredTools(['read']);
+  }
+
+  if (!Array.isArray(filesystemConfig)) {
+    return toolkit.getTools();
+  }
+
+  if (filesystemConfig.includes('all')) {
+    return toolkit.getTools();
+  }
+
+  // Handle an array of specific tool names or 'read'/'all'
+  const allowedTools: StructuredToolInterface[] = filesystemConfig.includes('read')
+    ? toolkit.getFilteredTools(['read'])
+    : [];
+
+  // Also allow specific tool names
+  const allowedToolNames = new Set(
+    filesystemConfig.filter((name) => name !== 'read' && name !== 'all')
+  );
+  const specificNamedTools = toolkit.getTools().filter((tool) => {
+    return tool.name && allowedToolNames.has(tool.name);
+  });
+
+  // Combine and deduplicate
+  const allAllowedTools = [...allowedTools, ...specificNamedTools];
+  return allAllowedTools.filter(
+    (tool, index, arr) => arr.findIndex((t) => t.name === tool.name) === index
+  );
+}
+
+/**
+ * Get built-in tools based on configuration
+ */
+async function getBuiltInTools(config: SlothConfig): Promise<StructuredToolInterface[]> {
+  const tools: StructuredToolInterface[] = [];
+
+  if (!config.builtInTools) {
+    return tools;
+  }
+
+  for (const toolName of config.builtInTools) {
+    if (toolName in AVAILABLE_BUILT_IN_TOOLS) {
+      try {
+        const tool = await import(
+          AVAILABLE_BUILT_IN_TOOLS[toolName as keyof typeof AVAILABLE_BUILT_IN_TOOLS]
+        );
+        tools.push(tool.get(config));
+      } catch (error) {
+        displayWarning(`Failed to load built-in tool '${toolName}': ${error}`);
+      }
+    } else {
+      displayWarning(`Unknown built-in tool: ${toolName}`);
+    }
+  }
+
+  return tools;
+}

package/src/commands/prCommand.ts

@@ -7,16 +7,19 @@ import {
 } from '#src/prompt.js';
 import { readMultipleFilesFromCurrentDir } from '#src/utils.js';
 import {
-  REQUIREMENTS_PROVIDERS,
   CONTENT_PROVIDERS,
-  type RequirementsProviderType,
-  getRequirementsFromProvider,
   type ContentProviderType,
+  getRequirementsFromProvider,
+  REQUIREMENTS_PROVIDERS,
+  type RequirementsProviderType,
 } from './commandUtils.js';
+import jiraLogWork from '#src/helpers/jira/jiraLogWork.js';
+import { JiraConfig } from '#src/providers/types.js';
 
 interface PrCommandOptions {
   file?: string[];
   requirementsProvider?: RequirementsProviderType;
+  message?: string;
 }
 
 export function prCommand(program: Command): void {
@@ -42,6 +45,7 @@ export function prCommand(program: Command): void {
       '-f, --file [files...]',
       'Input files. Content of these files will be added BEFORE the diff, but after requirements'
     )
+    .option('-m, --message <message>', 'Extra message to provide just before the content')
     .action(async (prId: string, requirementsId: string | undefined, options: PrCommandOptions) => {
       const { initConfig } = await import('#src/config.js');
       const config = await initConfig(); // Initialize and get config
@@ -85,9 +89,30 @@ export function prCommand(program: Command): void {
       const { get } = await import(providerPath);
       content.push(await get(null, prId));
 
+      if (options.message) {
+        content.push(options.message);
+      }
+
       const { review } = await import('#src/modules/reviewModule.js');
       // TODO consider including requirements id
       // TODO sanitize prId
       await review(`PR-${prId}`, systemMessage.join('\n'), content.join('\n'), config, 'pr');
+
+      if (
+        requirementsId &&
+        (config.commands?.pr?.requirementsProvider ?? config.requirementsProvider) === 'jira' &&
+        config.commands?.pr?.logWorkForReviewInSeconds
+      ) {
+        // TODO we need to figure out some sort of post-processors
+        let jiraConfig =
+          config.prebuiltToolsConfig?.jira ||
+          (config.requirementsProviderConfig?.jira as JiraConfig);
+        await jiraLogWork(
+          jiraConfig,
+          requirementsId,
+          config.commands?.pr?.logWorkForReviewInSeconds,
+          'code review'
+        );
+      }
     });
 }

package/src/config.ts

@@ -13,8 +13,7 @@ import {
   USER_PROJECT_CONFIG_JSON,
   USER_PROJECT_CONFIG_MJS,
 } from '#src/constants.js';
-import { getCurrentDir } from '#src/systemUtils.js';
-import GthFileSystemToolkit from '#src/tools/GthFileSystemToolkit.js';
+import { JiraConfig } from '#src/providers/types.js';
 
 export interface SlothConfig extends BaseSlothConfig {
   llm: BaseChatModel; // FIXME this is still bad keeping instance in config is probably not best choice
@@ -24,6 +23,7 @@ export interface SlothConfig extends BaseSlothConfig {
   projectReviewInstructions: string;
   streamOutput: boolean;
   filesystem: string[] | 'all' | 'read' | 'none';
+  builtInTools?: string[];
   tools?: StructuredToolInterface[] | BaseToolkit[];
 }
 
@@ -45,32 +45,46 @@ interface BaseSlothConfig {
   projectReviewInstructions?: string;
   streamOutput?: boolean;
   filesystem?: string[] | 'all' | 'read' | 'none';
+  prebuiltToolsConfig?: PreBuiltToolsConfig;
+  customToolsConfig?: CustomToolsConfig;
+  requirementsProviderConfig?: Record<string, unknown>;
+  contentProviderConfig?: Record<string, unknown>;
+  mcpServers?: Record<string, Connection>;
+  builtInTools?: string[];
   commands?: {
     pr?: {
       contentProvider?: string;
       requirementsProvider?: string;
       filesystem?: string[] | 'all' | 'read' | 'none';
+      builtInTools?: string[];
+      logWorkForReviewInSeconds?: number;
     };
     review?: {
       requirementsProvider?: string;
       contentProvider?: string;
       filesystem?: string[] | 'all' | 'read' | 'none';
+      builtInTools?: string[];
     };
     ask?: {
       filesystem?: string[] | 'all' | 'read' | 'none';
+      builtInTools?: string[];
     };
     chat?: {
       filesystem?: string[] | 'all' | 'read' | 'none';
+      builtInTools?: string[];
     };
     code?: {
       filesystem?: string[] | 'all' | 'read' | 'none';
+      builtInTools?: string[];
     };
   };
-  requirementsProviderConfig?: Record<string, unknown>;
-  contentProviderConfig?: Record<string, unknown>;
-  mcpServers?: Record<string, Connection>;
 }
 
+export type CustomToolsConfig = Record<string, object>;
+export type PreBuiltToolsConfig = {
+  jira: JiraConfig;
+};
+
 export interface LLMConfig extends Record<string, unknown> {
   type: string;
   model: string;
@@ -118,6 +132,7 @@ export async function initConfig(): Promise<SlothConfig> {
         exit(1);
         // noinspection ExceptionCaughtLocallyJS
         // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
+        // noinspection ExceptionCaughtLocallyJS
         throw new Error('Unexpected error occurred.');
       }
     } catch (e) {
@@ -303,60 +318,3 @@ function mergeConfig(partialConfig: Partial<SlothConfig>): SlothConfig {
 function mergeRawConfig(config: RawSlothConfig, llm: BaseChatModel): SlothConfig {
   return mergeConfig({ ...config, llm });
 }
-
-/**
- * Filter filesystem tools based on configuration
- */
-function filterFilesystemTools(
-  toolkit: GthFileSystemToolkit,
-  filesystemConfig: string[] | 'all' | 'read' | 'none'
-): StructuredToolInterface[] {
-  if (filesystemConfig === 'all') {
-    return toolkit.getTools();
-  }
-
-  if (filesystemConfig === 'none') {
-    return [];
-  }
-
-  if (filesystemConfig === 'read') {
-    // Read-only: only allow read operations
-    return toolkit.getFilteredTools(['read']);
-  }
-
-  if (!Array.isArray(filesystemConfig)) {
-    return toolkit.getTools();
-  }
-
-  if (filesystemConfig.includes('all')) {
-    return toolkit.getTools();
-  }
-
-  // Handle an array of specific tool names or 'read'/'all'
-  const allowedTools: StructuredToolInterface[] = filesystemConfig.includes('read')
-    ? toolkit.getFilteredTools(['read'])
-    : [];
-
-  // Also allow specific tool names
-  const allowedToolNames = new Set(
-    filesystemConfig.filter((name) => name !== 'read' && name !== 'all')
-  );
-  const specificNamedTools = toolkit.getTools().filter((tool) => {
-    return tool.name && allowedToolNames.has(tool.name);
-  });
-
-  // Combine and deduplicate
-  const allAllowedTools = [...allowedTools, ...specificNamedTools];
-  return allAllowedTools.filter(
-    (tool, index, arr) => arr.findIndex((t) => t.name === tool.name) === index
-  );
-}
-
-/**
- * Get default tools based on filesystem configuration
- */
-export function getDefaultTools(
-  filesystemConfig: string[] | 'all' | 'read' | 'none' = 'none'
-): StructuredToolInterface[] {
-  return [...filterFilesystemTools(new GthFileSystemToolkit([getCurrentDir()]), filesystemConfig)];
-}

package/src/core/Invocation.ts

@@ -1,6 +1,6 @@
 import type { Message } from '#src/modules/types.js';
 import { AIMessage, isAIMessage } from '@langchain/core/messages';
-import { getDefaultTools, SlothConfig } from '#src/config.js';
+import { SlothConfig } from '#src/config.js';
 import type { Connection } from '@langchain/mcp-adapters';
 import { MultiServerMCPClient } from '@langchain/mcp-adapters';
 import { createReactAgent } from '@langchain/langgraph/prebuilt';
@@ -10,6 +10,7 @@ import { type RunnableConfig } from '@langchain/core/runnables';
 import { ToolCall } from '@langchain/core/messages/tool';
 import { GthCommand, StatusLevel } from '#src/core/types.js';
 import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import { getDefaultTools } from '#src/builtInToolsConfig.js';
 
 export type StatusUpdateCallback = (level: StatusLevel, message: string) => void;
 
@@ -43,7 +44,7 @@ export class Invocation {
     this.mcpClient = this.getMcpClient(this.config);
 
     // Get default filesystem tools (filtered based on config)
-    const defaultTools = getDefaultTools(this.config.filesystem || 'none');
+    const defaultTools = await getDefaultTools(config);
 
     // Get user config tools
     const flattenedConfigTools = this.extractAndFlattenTools(this.config.tools || []);
@@ -81,6 +82,10 @@ export class Invocation {
         command && config.commands?.[command]?.filesystem !== undefined
           ? config.commands[command].filesystem!
           : config.filesystem,
+      builtInTools:
+        command && config.commands?.[command]?.builtInTools !== undefined
+          ? config.commands[command].builtInTools!
+          : config.builtInTools,
     };
   }
 

package/src/helpers/jira/jiraClient.ts

@@ -0,0 +1,99 @@
+import { env } from '#src/systemUtils.js';
+import type { JiraConfig } from '#src/providers/types.js';
+import { ProgressIndicator } from '#src/utils.js';
+
+export function getJiraCredentials(config: Partial<JiraConfig> | null): JiraConfig {
+  if (!config) {
+    throw new Error('No Jira config provided');
+  }
+
+  const username = env.JIRA_USERNAME || config.username;
+  if (!username) {
+    throw new Error(
+      'Missing JIRA username. The username can be defined as JIRA_USERNAME environment variable or as "username" in config.'
+    );
+  }
+
+  const token = env.JIRA_API_PAT_TOKEN || config.token;
+  if (!token) {
+    throw new Error(
+      'Missing JIRA PAT token. The token can be defined as JIRA_API_PAT_TOKEN environment variable or as "token" in config.'
+    );
+  }
+
+  const cloudId = env.JIRA_CLOUD_ID || config.cloudId;
+  if (!cloudId) {
+    throw new Error(
+      'Missing JIRA Cloud ID. The Cloud ID can be defined as JIRA_CLOUD_ID environment variable or as "cloudId" in config.'
+    );
+  }
+
+  return {
+    username,
+    token,
+    cloudId,
+    displayUrl: config.displayUrl,
+  };
+}
+
+export function getJiraHeaders(config: JiraConfig): Record<string, string> {
+  const credentials = `${config.username}:${config.token}`;
+  const encodedCredentials = Buffer.from(credentials).toString('base64');
+  const authHeader = `Basic ${encodedCredentials}`;
+
+  return {
+    Authorization: authHeader,
+    Accept: 'application/json; charset=utf-8',
+    'Accept-Language': 'en-US,en;q=0.9',
+    'Content-Type': 'application/json',
+  };
+}
+
+export async function jiraRequest<T>(
+  config: JiraConfig,
+  endpoint: string,
+  options: RequestInit = {},
+  showProgress = true
+): Promise<T> {
+  const apiUrl = `https://api.atlassian.com/ex/jira/${config.cloudId}${endpoint}`;
+  const headers = getJiraHeaders(config);
+
+  let progressIndicator: ProgressIndicator | undefined;
+  if (showProgress) {
+    progressIndicator = new ProgressIndicator(
+      `${options.method || 'GET'} ${apiUrl.replace(/^https?:\/\//, '')}`
+    );
+  }
+
+  try {
+    const response = await fetch(apiUrl, {
+      ...options,
+      headers: {
+        ...headers,
+        ...options.headers,
+      },
+    });
+
+    if (progressIndicator) {
+      progressIndicator.stop();
+    }
+
+    if (!response.ok) {
+      let errorMessage = `Failed to fetch from Jira: ${response.statusText}`;
+      try {
+        const errorData = await response.json();
+        errorMessage += ` - ${JSON.stringify(errorData)}`;
+      } catch {
+        // If we can't parse JSON error, use the basic message
+      }
+      throw new Error(errorMessage);
+    }
+
+    return response.json() as Promise<T>;
+  } catch (error) {
+    if (progressIndicator) {
+      progressIndicator.stop();
+    }
+    throw error;
+  }
+}