@gaunt-sloth/review 0.0.1

package/dist/modules/reviewModule.js

@@ -0,0 +1,87 @@
+import { defaultStatusCallback, displayDebug, displayError, displayInfo, displaySuccess, displayWarning, flushSessionLog, initSessionLogging, stopSessionLogging, } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getCommandOutputFilePath } from '#src/utils/fileUtils.js';
+import { HumanMessage, SystemMessage } from '@langchain/core/messages';
+import { GthAgentRunner } from '@gaunt-sloth/core/core/GthAgentRunner.js';
+import { MemorySaver } from '@langchain/langgraph';
+import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js';
+import { createReviewRateMiddleware, REVIEW_RATE_ARTIFACT_KEY, } from '#src/middleware/reviewRateMiddleware.js';
+import { deleteArtifact, getArtifact } from '@gaunt-sloth/core/state/artifactStore.js';
+import { setExitCode } from '@gaunt-sloth/core/utils/systemUtils.js';
+export async function review(source, preamble, diff, config, command = 'review', resolvers) {
+    const progressIndicator = config.streamOutput ? undefined : new ProgressIndicator('Reviewing.');
+    const messages = [new SystemMessage(preamble), new HumanMessage(diff)];
+    // Prepare logging path (if enabled by config)
+    const filePath = getCommandOutputFilePath(config, source);
+    if (filePath) {
+        initSessionLogging(filePath, config.streamSessionInferenceLog);
+    }
+    const rateConfig = config.commands?.[command]?.rating;
+    if (rateConfig && rateConfig.enabled !== false) {
+        const confMiddleware = config.middleware || [];
+        const middlewareWithoutReviewRate = confMiddleware.filter((mw) => {
+            return !(typeof mw === 'object' &&
+                mw !== null &&
+                'name' in mw &&
+                mw.name === 'review-rate');
+        });
+        // Resolve review-rate middleware directly rather than going through the registry
+        const reviewRateMiddleware = await createReviewRateMiddleware(rateConfig, config);
+        config.middleware = [...middlewareWithoutReviewRate, reviewRateMiddleware];
+    }
+    const runner = new GthAgentRunner(defaultStatusCallback, resolvers);
+    try {
+        await runner.init(command, config, new MemorySaver());
+        await runner.processMessages(messages);
+    }
+    catch (error) {
+        displayDebug(error instanceof Error ? error : String(error));
+        displayError('Failed to run review with agent.');
+    }
+    finally {
+        await runner.cleanup();
+    }
+    progressIndicator?.stop();
+    handleRatingResult(rateConfig, command);
+    // Close the file AFTER rating is written
+    if (filePath) {
+        try {
+            flushSessionLog();
+            stopSessionLogging();
+            displaySuccess(`\n\nThis report can be found in ${filePath}`);
+        }
+        catch (error) {
+            displayDebug(error instanceof Error ? error : String(error));
+            displayError(`Failed to write review to file: ${filePath}`);
+        }
+    }
+    deleteArtifact(REVIEW_RATE_ARTIFACT_KEY);
+}
+function handleRatingResult(rateConfig, command) {
+    if (!rateConfig || rateConfig.enabled === false) {
+        // No rating enabled - no need to handle the result
+        return;
+    }
+    const rating = getArtifact(REVIEW_RATE_ARTIFACT_KEY);
+    if (!rating) {
+        displayWarning(`Rating middleware did not return a score for ${command} command.`);
+        setExitCode(1); // Build should fail if rating is enabled, but no rating artifact is present
+        return;
+    }
+    const threshold = rateConfig.passThreshold ?? rating.passThreshold;
+    const maxRating = rateConfig.maxRating ?? rating.maxRating;
+    const verdictText = `${rating.rate}/${maxRating} (threshold: ${threshold})`;
+    displayInfo('\nREVIEW RATING');
+    if (rating.rate >= threshold) {
+        displaySuccess(`PASS ${verdictText}`);
+    }
+    else {
+        displayError(`FAIL ${verdictText}`);
+        if (rateConfig.errorOnReviewFail ?? true) {
+            setExitCode(1);
+        }
+    }
+    if (rating.comment) {
+        displayInfo(rating.comment);
+    }
+}
+//# sourceMappingURL=reviewModule.js.map

package/dist/modules/reviewModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewModule.js","sourceRoot":"","sources":["../../src/modules/reviewModule.ts"],"names":[],"mappings":"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"}

package/dist/modules/types.d.ts

@@ -0,0 +1,18 @@
+import type { BaseMessage } from '@langchain/core/messages';
+export type Message = BaseMessage;
+export interface State {
+    messages: Message[];
+}
+export interface ProgressCallback {
+    (): void;
+}
+export interface ReviewOptions {
+    source: string;
+    preamble: string;
+    diff: string;
+}
+export interface QuestionOptions {
+    source: string;
+    preamble: string;
+    content: string;
+}

package/dist/modules/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/modules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":""}

package/dist/sources/fileSource.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Reads the text file from current dir
+ * @param _ config (unused in this source)
+ * @param fileName
+ * @returns file contents
+ */
+export declare function get(_: ProviderConfig | null, fileName: string | undefined): Promise<string | null>;

package/dist/sources/fileSource.js

@@ -0,0 +1,20 @@
+import { resolve } from 'node:path';
+import { display } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getCurrentWorkDir } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { readFileSyncWithMessages } from '#src/utils/fileUtils.js';
+/**
+ * Reads the text file from current dir
+ * @param _ config (unused in this source)
+ * @param fileName
+ * @returns file contents
+ */
+export async function get(_, fileName) {
+    if (!fileName) {
+        return null;
+    }
+    const currentDir = getCurrentWorkDir();
+    const filePath = resolve(currentDir, fileName);
+    display(`Reading file ${fileName}...`);
+    return readFileSyncWithMessages(filePath);
+}
+//# sourceMappingURL=fileSource.js.map

package/dist/sources/fileSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSource.js","sourceRoot":"","sources":["../../src/sources/fileSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,CAAwB,EACxB,QAA4B;IAE5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,CAAC,gBAAgB,QAAQ,KAAK,CAAC,CAAC;IACvC,OAAO,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/sources/ghIssueSource.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Gets GitHub issue using GitHub CLI
+ * @param _ config (unused in this source)
+ * @param issueId GitHub issue number
+ * @returns GitHub issue content or null if not found
+ */
+export declare function get(_: ProviderConfig | null, issueId: string | undefined): Promise<string | null>;

package/dist/sources/ghIssueSource.js

@@ -0,0 +1,34 @@
+import { displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { execAsync } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js';
+/**
+ * Gets GitHub issue using GitHub CLI
+ * @param _ config (unused in this source)
+ * @param issueId GitHub issue number
+ * @returns GitHub issue content or null if not found
+ */
+export async function get(_, issueId) {
+    if (!issueId) {
+        displayWarning('No GitHub issue number provided');
+        return null;
+    }
+    try {
+        // Use the GitHub CLI to fetch issue details
+        const progress = new ProgressIndicator(`Fetching GitHub issue #${issueId}`);
+        const issueContent = await execAsync(`gh issue view ${issueId}`);
+        progress.stop();
+        if (!issueContent) {
+            displayWarning(`No content found for GitHub issue #${issueId}`);
+            return null;
+        }
+        return `GitHub Issue: #${issueId}\n\n${issueContent}`;
+    }
+    catch (error) {
+        displayWarning(`
+Failed to get GitHub issue #${issueId}: ${error instanceof Error ? error.message : String(error)}
+Consider checking if gh cli (https://cli.github.com/) is installed and authenticated.
+    `);
+        return null;
+    }
+}
+//# sourceMappingURL=ghIssueSource.js.map

package/dist/sources/ghIssueSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghIssueSource.js","sourceRoot":"","sources":["../../src/sources/ghIssueSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,CAAwB,EACxB,OAA2B;IAE3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,iCAAiC,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QACjE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,cAAc,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,kBAAkB,OAAO,OAAO,YAAY,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CAAC;8BACW,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;;KAE3F,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/sources/ghPrDiffSource.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Gets PR diff using GitHub CLI
+ * @param _ config (unused in this source)
+ * @param prId GitHub PR number
+ * @returns GitHub PR diff content or null if not found
+ */
+export declare function get(_: ProviderConfig | null, prId: string | undefined): Promise<string | null>;

package/dist/sources/ghPrDiffSource.js

@@ -0,0 +1,29 @@
+import { execAsync } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js';
+/**
+ * Gets PR diff using GitHub CLI
+ * @param _ config (unused in this source)
+ * @param prId GitHub PR number
+ * @returns GitHub PR diff content or null if not found
+ */
+export async function get(_, prId) {
+    if (!prId) {
+        throw new Error('No GitHub PR number provided');
+    }
+    // Use the GitHub CLI to fetch PR diff
+    const progress = new ProgressIndicator(`Fetching GitHub PR #${prId} diff`);
+    try {
+        const prDiffContent = await execAsync(`gh pr diff ${prId}`);
+        progress.stop();
+        if (!prDiffContent) {
+            throw new Error(`No diff content found for GitHub PR #${prId}`);
+        }
+        return `GitHub PR Diff: #${prId}\n\n${prDiffContent}`;
+    }
+    catch (error) {
+        progress.stop();
+        throw new Error(`Failed to get GitHub PR diff #${prId}: ${error instanceof Error ? error.message : String(error)}
+Consider checking if gh cli (https://cli.github.com/) is installed and authenticated.`);
+    }
+}
+//# sourceMappingURL=ghPrDiffSource.js.map

package/dist/sources/ghPrDiffSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghPrDiffSource.js","sourceRoot":"","sources":["../../src/sources/ghPrDiffSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,CAAwB,EACxB,IAAwB;IAExB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,sCAAsC;IACtC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,uBAAuB,IAAI,OAAO,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QAC5D,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhB,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,oBAAoB,IAAI,OAAO,aAAa,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;sFAC9B,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/sources/jiraIssueLegacySource.d.ts

@@ -0,0 +1,8 @@
+import type { JiraLegacyConfig } from '#src/sources/types.js';
+/**
+ * Gets Jira issue using Atlassian REST API v2 with unscoped API token (aka Legacy Token)
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue content
+ */
+export declare function get(config: Partial<JiraLegacyConfig>, issueId: string | undefined): Promise<string | null>;

package/dist/sources/jiraIssueLegacySource.js

@@ -0,0 +1,74 @@
+import { display, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { env } from '@gaunt-sloth/core/utils/systemUtils.js';
+/**
+ * Gets Jira issue using Atlassian REST API v2 with unscoped API token (aka Legacy Token)
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue content
+ */
+export async function get(config, issueId) {
+    if (!config) {
+        displayWarning('No Jira config provided');
+        return null;
+    }
+    if (!issueId) {
+        displayWarning('No issue ID provided');
+        return null;
+    }
+    if (!config.baseUrl) {
+        displayWarning('No Jira base URL 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_LEGACY_API_TOKEN || config.token;
+    if (!token) {
+        throw new Error('Missing JIRA Legacy API token. The legacy token can be defined as JIRA_LEGACY_API_TOKEN environment variable or as "token" in config.');
+    }
+    try {
+        const issue = await getJiraIssue({
+            ...config,
+            username,
+            token,
+        }, issueId);
+        if (!issue) {
+            return null;
+        }
+        const summary = issue.fields.summary;
+        const description = issue.fields.description;
+        return `Jira Issue: ${issueId}\nSummary: ${summary}\n\nDescription:\n${description}`;
+    }
+    catch (error) {
+        displayError(`Failed to get Jira issue: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+/**
+ * Helper function to get Jira issue details
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue response
+ */
+async function getJiraIssue(config, issueId) {
+    const auth = Buffer.from(`${config.username}:${config.token}`).toString('base64');
+    const url = `${config.baseUrl}${issueId}`;
+    if (config.displayUrl) {
+        display(`Loading Jira issue ${config.displayUrl}${issueId}`);
+    }
+    display(`Retrieving jira from api ${url.replace(/^https?:\/\//, '')}`);
+    const response = await fetch(url, {
+        headers: {
+            Authorization: `Basic ${auth}`,
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Jira issue from ${url} with status: ${response.statusText}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=jiraIssueLegacySource.js.map

package/dist/sources/jiraIssueLegacySource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraIssueLegacySource.js","sourceRoot":"","sources":["../../src/sources/jiraIssueLegacySource.ts"],"names":[],"mappings":"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"}

package/dist/sources/jiraIssueSource.d.ts

@@ -0,0 +1,11 @@
+import type { JiraConfig } from './types.js';
+/**
+ * Gets Jira issue using Atlassian REST API v3 with Personal Access Token
+ *
+ * TODO we need to figure out how would this work with public jira.
+ *
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue content
+ */
+export declare function get(config: Partial<JiraConfig> | null, issueId: string | undefined): Promise<string | null>;

package/dist/sources/jiraIssueSource.js

@@ -0,0 +1,62 @@
+import { display, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getJiraCredentials, jiraRequest, } from '#src/helpers/jira/jiraClient.js';
+/**
+ * Gets Jira issue using Atlassian REST API v3 with Personal Access Token
+ *
+ * TODO we need to figure out how would this work with public jira.
+ *
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue content
+ */
+export async function get(config, issueId) {
+    if (!config) {
+        displayWarning('No Jira config provided');
+        return null;
+    }
+    if (!issueId) {
+        displayWarning('No issue ID provided');
+        return null;
+    }
+    const credentials = getJiraCredentials(config);
+    try {
+        const issue = await getJiraIssue(credentials, issueId);
+        if (!issue) {
+            return null;
+        }
+        const summary = issue.fields.summary;
+        const description = issue.fields.description;
+        return `Jira Issue: ${issueId}\nSummary: ${summary}\n\nDescription:\n${description}`;
+    }
+    catch (error) {
+        displayError(`Failed to get Jira issue: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+/**
+ * Helper function to get Jira issue details using Atlassian REST API v2.
+ *
+ * The feature was initially developed to use Atlassian REST API v3, which by
+ * default returns the ADF JSON format for description, which is not very useful for us.
+ *
+ * @param config Jira configuration
+ * @param jiraKey Jira issue ID
+ * @returns Jira issue response
+ */
+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
+    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
+    return jiraRequest(credentials, `/rest/api/2/issue/${jiraKey}${filters}`, {
+        method: 'GET',
+    });
+}
+//# sourceMappingURL=jiraIssueSource.js.map

package/dist/sources/jiraIssueSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraIssueSource.js","sourceRoot":"","sources":["../../src/sources/jiraIssueSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEhG,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,iCAAiC,CAAC;AAYzC;;;;;;;;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,WAAoC,EACpC,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/sources/textSource.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Returns the provided text as is
+ * @param _ config (unused in this source)
+ * @param text Text to return
+ * @returns The provided text
+ */
+export declare function get(_: ProviderConfig | null, text: string | undefined): Promise<string | null>;

package/dist/sources/textSource.js

@@ -0,0 +1,10 @@
+/**
+ * Returns the provided text as is
+ * @param _ config (unused in this source)
+ * @param text Text to return
+ * @returns The provided text
+ */
+export async function get(_, text) {
+    return text ?? null;
+}
+//# sourceMappingURL=textSource.js.map

package/dist/sources/textSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textSource.js","sourceRoot":"","sources":["../../src/sources/textSource.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,CAAwB,EACxB,IAAwB;IAExB,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC"}

package/dist/sources/types.d.ts

@@ -0,0 +1,33 @@
+export interface ProviderConfig {
+    username?: string;
+    token?: string;
+    baseUrl?: string;
+    [key: string]: unknown;
+}
+export interface JiraLegacyConfig extends ProviderConfig {
+    username: string;
+    baseUrl: string;
+    displayUrl?: string;
+    token: string;
+}
+export interface JiraConfig extends ProviderConfig {
+    cloudId: string;
+    username?: string;
+    displayUrl?: string;
+    token?: string;
+    fullBase64Token?: string;
+}
+/**
+ * Configuration for an A2A (Agent-to-Agent) protocol agent.
+ * @experimental A2A support is experimental and may change.
+ * @see {@link https://a2a-protocol.org/}
+ */
+export interface A2AConfig {
+    /** Unique identifier for the agent, used in tool naming */
+    agentId: string;
+    /** URL endpoint for the A2A agent */
+    agentUrl: string;
+}
+export interface Provider {
+    get: (config: ProviderConfig | null, id: string | undefined) => Promise<string | null>;
+}

package/dist/sources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":""}

package/dist/state/artifactStore.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/state/artifactStore.js';

package/dist/state/artifactStore.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/state/artifactStore.js';
+//# sourceMappingURL=artifactStore.js.map

package/dist/state/artifactStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactStore.js","sourceRoot":"","sources":["../../src/state/artifactStore.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/utils/ProgressIndicator.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/ProgressIndicator.js';

package/dist/utils/ProgressIndicator.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/ProgressIndicator.js';
+//# sourceMappingURL=ProgressIndicator.js.map

package/dist/utils/ProgressIndicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressIndicator.js","sourceRoot":"","sources":["../../src/utils/ProgressIndicator.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC"}

package/dist/utils/consoleUtils.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/consoleUtils.js';

package/dist/utils/consoleUtils.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/consoleUtils.js';
+//# sourceMappingURL=consoleUtils.js.map

package/dist/utils/consoleUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleUtils.js","sourceRoot":"","sources":["../../src/utils/consoleUtils.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC"}

package/dist/utils/debugUtils.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/debugUtils.js';

package/dist/utils/debugUtils.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/debugUtils.js';
+//# sourceMappingURL=debugUtils.js.map

package/dist/utils/debugUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugUtils.js","sourceRoot":"","sources":["../../src/utils/debugUtils.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC"}

package/dist/utils/fileUtils.d.ts

@@ -0,0 +1,7 @@
+export * from '@gaunt-sloth/core/utils/fileUtils.js';
+/**
+ * Reads multiple files from the current directory and returns their contents
+ * @param fileNames - Array of file names to read
+ * @returns Combined content of all files with proper formatting, each file is wrapped in random block like <file-abvesde>
+ */
+export declare function readMultipleFilesFromProjectDir(fileNames: string | string[]): string;

package/dist/utils/fileUtils.js

@@ -0,0 +1,20 @@
+export * from '@gaunt-sloth/core/utils/fileUtils.js';
+import { readFileFromProjectDir } from '@gaunt-sloth/core/utils/fileUtils.js';
+import { wrapContent } from '@gaunt-sloth/core/utils/llmUtils.js';
+/**
+ * Reads multiple files from the current directory and returns their contents
+ * @param fileNames - Array of file names to read
+ * @returns Combined content of all files with proper formatting, each file is wrapped in random block like <file-abvesde>
+ */
+export function readMultipleFilesFromProjectDir(fileNames) {
+    if (!Array.isArray(fileNames)) {
+        return wrapContent(readFileFromProjectDir(fileNames), 'file', `file ${fileNames}`, true);
+    }
+    return fileNames
+        .map((fileName) => {
+        const content = readFileFromProjectDir(fileName);
+        return `${wrapContent(content, 'file', `file ${fileName}`, true)}`;
+    })
+        .join('\n\n');
+}
+//# sourceMappingURL=fileUtils.js.map

package/dist/utils/fileUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAA4B;IAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/llmUtils.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/llmUtils.js';

package/dist/utils/llmUtils.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/llmUtils.js';
+//# sourceMappingURL=llmUtils.js.map

package/dist/utils/llmUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmUtils.js","sourceRoot":"","sources":["../../src/utils/llmUtils.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC"}

package/dist/utils/stringUtils.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/stringUtils.js';

package/dist/utils/stringUtils.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/stringUtils.js';
+//# sourceMappingURL=stringUtils.js.map

package/dist/utils/stringUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringUtils.js","sourceRoot":"","sources":["../../src/utils/stringUtils.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}

package/dist/utils/systemUtils.d.ts

@@ -0,0 +1 @@
+export * from '@gaunt-sloth/core/utils/systemUtils.js';

package/dist/utils/systemUtils.js

@@ -0,0 +1,2 @@
+export * from '@gaunt-sloth/core/utils/systemUtils.js';
+//# sourceMappingURL=systemUtils.js.map

package/dist/utils/systemUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemUtils.js","sourceRoot":"","sources":["../../src/utils/systemUtils.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}