@gaunt-sloth/core 0.0.1

package/dist/utils/fileUtils.js

@@ -0,0 +1,216 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getCurrentWorkDir } from '#src/utils/systemUtils.js';
+import { GSLOTH_DIR, GSLOTH_SETTINGS_DIR } from '#src/constants.js';
+import { displayError, displayInfo, displaySuccess, displayWarning, } from '#src/utils/consoleUtils.js';
+import url from 'node:url';
+/**
+ * Checks if .gsloth directory exists in the project root
+ * @returns Boolean indicating whether .gsloth directory exists
+ */
+export function gslothDirExists() {
+    const currentDir = getCurrentWorkDir();
+    const gslothDirPath = resolve(currentDir, GSLOTH_DIR);
+    return existsSync(gslothDirPath);
+}
+/**
+ * Gets the path where gsloth should write files based on .gsloth directory existence
+ * @param filename The filename to append to the path
+ * @returns The resolved path where the file should be written
+ */
+export function getGslothFilePath(filename) {
+    const currentDir = getCurrentWorkDir();
+    if (gslothDirExists()) {
+        const gslothDirPath = resolve(currentDir, GSLOTH_DIR);
+        return resolve(gslothDirPath, filename);
+    }
+    return resolve(currentDir, filename);
+}
+/**
+ * Gets the path where gsloth should write configuration files based on .gsloth directory existence.
+ * The main difference from {@link #getGslothConfigReadPath} is that this getGslothConfigWritePath
+ * method creates internal settings directory if it does not exist.
+ *
+ * If .gsloth dir exists returns `projectdir/.gsloth/.gsloth-settings`
+ * If .gsloth dir does not exist returns `projectdir`
+ *
+ * @param filename The configuration filename
+ * @returns The resolved path where the configuration file should be written
+ */
+export function getGslothConfigWritePath(filename) {
+    const currentDir = getCurrentWorkDir();
+    if (gslothDirExists()) {
+        const gslothDirPath = resolve(currentDir, GSLOTH_DIR);
+        const gslothSettingsPath = resolve(gslothDirPath, GSLOTH_SETTINGS_DIR);
+        // Create .gsloth-settings directory if it doesn't exist
+        if (!existsSync(gslothSettingsPath)) {
+            mkdirSync(gslothSettingsPath, { recursive: true });
+        }
+        return resolve(gslothSettingsPath, filename);
+    }
+    return resolve(currentDir, filename);
+}
+/**
+ * Gets the path where gsloth should look for configuration files based on .gsloth directory existence
+ * @param filename The configuration filename to look for
+ * @param identityProfileRaw The identity profile dir within GSLOTH_SETTINGS_DIR to look for the configuration file in.
+ * @returns The resolved path where the configuration file should be found
+ */
+export function getGslothConfigReadPath(filename, identityProfileRaw) {
+    const projectDir = getCurrentWorkDir();
+    const identityProfile = identityProfileRaw?.trim();
+    if (gslothDirExists()) {
+        const gslothDirPath = resolve(projectDir, GSLOTH_DIR);
+        const gslothSettingsPath = resolve(gslothDirPath, GSLOTH_SETTINGS_DIR);
+        const configPath = identityProfile
+            ? resolve(gslothSettingsPath, identityProfile, filename)
+            : resolve(gslothSettingsPath, filename);
+        if (existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    return resolve(projectDir, filename);
+}
+/**
+ * Resolve an explicit output path string to an absolute file path.
+ * Concerned only with string values:
+ * - If the string includes a path separator, resolve relative to project root and ensure parent directories exist.
+ * - If it's a bare filename, place it under .gsloth/ when present, otherwise project root.
+ */
+export function resolveOutputPath(writeOutputToFile) {
+    const currentDir = getCurrentWorkDir();
+    const provided = String(writeOutputToFile).trim();
+    // Detect if provided path contains path separators (cross-platform)
+    const hasSeparator = provided.includes('/') || provided.includes('\\');
+    // If no separators, treat as bare filename: prefer .gsloth/ when present
+    if (!hasSeparator) {
+        return getGslothFilePath(provided);
+    }
+    // If path contains directories, respect as-is and ensure parent dirs
+    const absolutePath = resolve(currentDir, provided);
+    const parentDir = dirname(absolutePath);
+    if (!existsSync(parentDir)) {
+        mkdirSync(parentDir, { recursive: true });
+    }
+    return absolutePath;
+}
+export function toFileSafeString(string) {
+    return string.replace(/[^A-Za-z0-9]/g, '-');
+}
+/**
+ * Returns a formatted date string in the format YYYY-MM-DD_HH-MM-SS using local time
+ * @returns A formatted date string
+ */
+export function fileSafeLocalDate() {
+    const date = new Date();
+    // Format: YYYY-MM-DD_HH-MM-SS using local time directly
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day}_${hours}-${minutes}-${seconds}`;
+}
+/**
+ * Generates a standardized filename with the format: gth_YYYY-MM-DD_HH-MM-SS_COMMAND.md
+ * @param command - The command that created the file (ASK, REVIEW, PR, etc.)
+ * @returns A standardized filename string
+ */
+export function generateStandardFileName(command) {
+    const dateTimeStr = fileSafeLocalDate();
+    const commandStr = toFileSafeString(command.toUpperCase());
+    return `gth_${dateTimeStr}_${commandStr}.md`;
+}
+export function readFileFromProjectDir(fileName) {
+    const currentDir = getCurrentWorkDir();
+    const filePath = resolve(currentDir, fileName);
+    displayInfo(`Reading file ${filePath}...`);
+    return readFileSyncWithMessages(filePath);
+}
+const corePackageDir = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+export function readFileFromInstallDir(filePath) {
+    const installFilePath = resolve(corePackageDir, filePath);
+    try {
+        return readFileSync(installFilePath, { encoding: 'utf8' });
+    }
+    catch (readFromInstallDirError) {
+        displayError(`The ${installFilePath} not found or can\'t be read.`);
+        throw readFromInstallDirError;
+    }
+}
+export function writeFileIfNotExistsWithMessages(filePath, content) {
+    displayInfo(`checking ${filePath} existence`);
+    if (!existsSync(filePath)) {
+        // Create parent directories if they don't exist
+        const parentDir = dirname(filePath);
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        writeFileSync(filePath, content);
+        displaySuccess(`Created ${filePath}`);
+    }
+    else {
+        displayWarning(`${filePath} already exists`);
+    }
+}
+export function appendToFile(filePath, content) {
+    try {
+        const parentDir = dirname(filePath);
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        appendFileSync(filePath, content);
+    }
+    catch (e) {
+        displayError(`Failed to append to file ${filePath}: ${e.message}`);
+    }
+}
+export function readFileSyncWithMessages(filePath, errorMessageIn, noFileMessage) {
+    const errorMessage = errorMessageIn ?? 'Error reading file at: ';
+    try {
+        return readFileSync(filePath, { encoding: 'utf8' });
+    }
+    catch (error) {
+        displayError(errorMessage + filePath);
+        if (error.code === 'ENOENT') {
+            displayWarning(noFileMessage ?? 'Please ensure the file exists.');
+        }
+        else {
+            displayError(error.message);
+        }
+        throw error;
+    }
+}
+/**
+ * Dynamically imports a module from a file path from the outside of the installation dir
+ * @returns A promise that resolves to the imported module
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function importExternalFile(filePath) {
+    const configFileUrl = url.pathToFileURL(filePath).toString();
+    return import(configFileUrl);
+}
+/**
+ * Returns the output file path for a given command execution based on configuration.
+ * - If writeOutputToFile is false, returns null.
+ * - If writeOutputToFile is a string, resolves it without generating a default filename.
+ * - If writeOutputToFile is true, generates a standard filename from source and resolves it under .gsloth/ (when present) or project root.
+ */
+export function getCommandOutputFilePath(config, source) {
+    const setting = config.writeOutputToFile;
+    if (setting === false) {
+        return null;
+    }
+    if (typeof setting === 'string') {
+        const trimmed = setting.trim();
+        if (trimmed.length === 0)
+            return null;
+        return resolveOutputPath(trimmed);
+    }
+    // setting === true -> generate filename and place it using getGslothFilePath
+    const filename = generateStandardFileName(source.toUpperCase());
+    return getGslothFilePath(filename);
+}
+//# 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":"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"}

package/dist/utils/globalConfigUtils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Gets the global .gsloth directory path in the user's home directory
+ * @returns The resolved path to the global .gsloth directory
+ */
+export declare function getGlobalGslothDir(): string;
+/**
+ * Ensures the global .gsloth directory exists in the user's home directory
+ * Creates it if it doesn't exist
+ * @returns The resolved path to the global .gsloth directory
+ */
+export declare function ensureGlobalGslothDir(): string;
+/**
+ * Gets the global auth directory path
+ * @returns The resolved path to the global auth directory
+ */
+export declare function getGlobalAuthDir(): string;
+/**
+ * Ensures the global auth directory exists
+ * Creates it if it doesn't exist
+ * @returns The resolved path to the global auth directory
+ */
+export declare function ensureGlobalAuthDir(): string;
+/**
+ * Gets the path for a specific OAuth provider's storage file
+ * @param serverUrl The server URL or identifier for the OAuth provider
+ * @returns The resolved path where the OAuth data should be stored
+ */
+export declare function getOAuthStoragePath(serverUrl: string): string;

package/dist/utils/globalConfigUtils.js

@@ -0,0 +1,61 @@
+import { existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { GSLOTH_DIR, GSLOTH_AUTH } from '#src/constants.js';
+/**
+ * Gets the global .gsloth directory path in the user's home directory
+ * @returns The resolved path to the global .gsloth directory
+ */
+export function getGlobalGslothDir() {
+    return resolve(homedir(), GSLOTH_DIR);
+}
+/**
+ * Ensures the global .gsloth directory exists in the user's home directory
+ * Creates it if it doesn't exist
+ * @returns The resolved path to the global .gsloth directory
+ */
+export function ensureGlobalGslothDir() {
+    const globalDir = getGlobalGslothDir();
+    if (!existsSync(globalDir)) {
+        mkdirSync(globalDir, { recursive: true });
+    }
+    return globalDir;
+}
+/**
+ * Gets the global auth directory path
+ * @returns The resolved path to the global auth directory
+ */
+export function getGlobalAuthDir() {
+    const globalDir = getGlobalGslothDir();
+    return resolve(globalDir, GSLOTH_AUTH);
+}
+/**
+ * Ensures the global auth directory exists
+ * Creates it if it doesn't exist
+ * @returns The resolved path to the global auth directory
+ */
+export function ensureGlobalAuthDir() {
+    // First ensure parent directory exists
+    ensureGlobalGslothDir();
+    const authDir = getGlobalAuthDir();
+    if (!existsSync(authDir)) {
+        mkdirSync(authDir, { recursive: true });
+    }
+    return authDir;
+}
+/**
+ * Gets the path for a specific OAuth provider's storage file
+ * @param serverUrl The server URL or identifier for the OAuth provider
+ * @returns The resolved path where the OAuth data should be stored
+ */
+export function getOAuthStoragePath(serverUrl) {
+    const authDir = ensureGlobalAuthDir();
+    // Create a safe filename from the server URL
+    const safeFilename = serverUrl
+        .replace(/https?:\/\//, '')
+        .replace(/[^a-zA-Z0-9.-]/g, '_')
+        .replace(/_+/g, '_')
+        .toLowerCase();
+    return resolve(authDir, `${safeFilename}.json`);
+}
+//# sourceMappingURL=globalConfigUtils.js.map

package/dist/utils/globalConfigUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalConfigUtils.js","sourceRoot":"","sources":["../../src/utils/globalConfigUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IAEvC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,OAAO,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,uCAAuC;IACvC,qBAAqB,EAAE,CAAC;IAExB,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAEnC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,6CAA6C;IAC7C,MAAM,YAAY,GAAG,SAAS;SAC3B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;IAEjB,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/llmUtils.d.ts

@@ -0,0 +1,39 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { GthConfig } from '#src/config.js';
+import { SystemMessage } from '@langchain/core/messages';
+/**
+ * Creates new runnable config.
+ * configurable.thread_id is an important part of that because it helps to distinguish different chat sessions.
+ * We normally do not have multiple sessions in the terminal, but I had bad stuff happening in tests
+ * and in another prototype project where I was importing Gaunt Sloth.
+ */
+export declare function getNewRunnableConfig(): RunnableConfig;
+export declare function readBackstory(config: Pick<GthConfig, 'identityProfile' | 'noDefaultPrompts'>): string;
+export declare function readGuidelines(config: Pick<GthConfig, 'projectGuidelines' | 'includeCurrentDateAfterGuidelines' | 'organization' | 'identityProfile' | 'noDefaultPrompts'> | string): string;
+export declare function readReviewInstructions(config: Pick<GthConfig, 'projectReviewInstructions' | 'identityProfile' | 'noDefaultPrompts'> | string): string;
+export declare function readSystemPrompt(config: Pick<GthConfig, 'identityProfile' | 'noDefaultPrompts'>): string;
+export declare function readChatPrompt(config: Pick<GthConfig, 'identityProfile' | 'noDefaultPrompts'>): string;
+export declare function buildSystemMessages(config: GthConfig, modePrompt?: string | null): SystemMessage[];
+export declare function readCodePrompt(config: Pick<GthConfig, 'identityProfile' | 'noDefaultPrompts'>): string;
+/**
+ * Wraps content within randomized block
+ */
+export declare function wrapContent(content: string, wrapBlockPrefix?: string, prefix?: string, alwaysWrap?: boolean): string;
+/**
+ * Utility function to execute hook(s) - either a single hook or an array of hooks
+ * Fully type-safe and works with any number of arguments
+ * @param hooks - Single hook function or array of hook functions (or undefined)
+ * @param args - Arguments to pass to each hook function
+ */
+export declare function executeHooks<T extends (...args: any[]) => Promise<void>>(hooks: T | T[] | undefined, ...args: Parameters<T>): Promise<void>;
+/**
+ * Format tool call arguments in a human-readable way
+ */
+export declare function formatToolCallArgs(args: Record<string, unknown>): string;
+/**
+ * Format multiple tool calls for display (matches Invocation.ts behavior)
+ */
+export declare function formatToolCalls(toolCalls: Array<{
+    name: string;
+    args?: Record<string, unknown>;
+}>, maxLength?: number): string;

package/dist/utils/llmUtils.js

@@ -0,0 +1,153 @@
+import { randomUUID } from 'node:crypto';
+import { GSLOTH_BACKSTORY, GSLOTH_CHAT_PROMPT, GSLOTH_CODE_PROMPT, GSLOTH_SYSTEM_PROMPT, } from '#src/constants.js';
+import { getGslothConfigReadPath, readFileFromInstallDir } from '#src/utils/fileUtils.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { debugLog } from '#src/utils/debugUtils.js';
+import { truncateString } from '#src/utils/stringUtils.js';
+import { SystemMessage } from '@langchain/core/messages';
+/**
+ * Creates new runnable config.
+ * configurable.thread_id is an important part of that because it helps to distinguish different chat sessions.
+ * We normally do not have multiple sessions in the terminal, but I had bad stuff happening in tests
+ * and in another prototype project where I was importing Gaunt Sloth.
+ */
+export function getNewRunnableConfig() {
+    return {
+        recursionLimit: 1000,
+        configurable: { thread_id: randomUUID() },
+    };
+}
+export function readBackstory(config) {
+    return readPromptFile(GSLOTH_BACKSTORY, config.identityProfile, config.noDefaultPrompts);
+}
+export function readGuidelines(config) {
+    if (typeof config === 'string') {
+        return readPromptFile(config, undefined);
+    }
+    const guidelines = readPromptFile(config.projectGuidelines, config.identityProfile, config.noDefaultPrompts);
+    if (config.includeCurrentDateAfterGuidelines) {
+        const currentDate = new Date();
+        const orgName = config.organization?.name;
+        const locale = config.organization?.locale;
+        const timezone = config.organization?.timezone;
+        const hasLocaleOrTimezone = Boolean((locale && locale.trim()) || (timezone && timezone.trim()));
+        const humanReadableDate = hasLocaleOrTimezone
+            ? new Intl.DateTimeFormat(locale?.trim() || undefined, {
+                dateStyle: 'full',
+                timeStyle: 'long',
+                timeZone: timezone?.trim() || undefined,
+            }).format(currentDate)
+            : '';
+        const lines = [guidelines];
+        if (orgName) {
+            lines.push(`Organization: ${orgName}`);
+        }
+        lines.push(`Current Date: ${currentDate.toISOString()}${hasLocaleOrTimezone ? ` - ${humanReadableDate}` : ''}`);
+        return lines.join('\n');
+    }
+    return guidelines;
+}
+export function readReviewInstructions(config) {
+    if (typeof config === 'string') {
+        return readPromptFile(config, undefined);
+    }
+    return readPromptFile(config.projectReviewInstructions, config.identityProfile, config.noDefaultPrompts);
+}
+export function readSystemPrompt(config) {
+    return readPromptFile(GSLOTH_SYSTEM_PROMPT, config.identityProfile, config.noDefaultPrompts);
+}
+export function readChatPrompt(config) {
+    return readPromptFile(GSLOTH_CHAT_PROMPT, config.identityProfile, config.noDefaultPrompts);
+}
+export function buildSystemMessages(config, modePrompt) {
+    const parts = [readBackstory(config), readGuidelines(config)];
+    if (modePrompt)
+        parts.push(modePrompt);
+    const systemPrompt = readSystemPrompt(config);
+    if (systemPrompt)
+        parts.push(systemPrompt);
+    const content = parts.filter(Boolean).join('\n');
+    return content.trim() ? [new SystemMessage(content)] : [];
+}
+export function readCodePrompt(config) {
+    return readPromptFile(GSLOTH_CODE_PROMPT, config.identityProfile, config.noDefaultPrompts);
+}
+function readPromptFile(filename, identityProfile, noDefaultPrompts) {
+    const path = getGslothConfigReadPath(filename, identityProfile);
+    if (existsSync(path)) {
+        return readFileSync(path, { encoding: 'utf8' });
+    }
+    if (noDefaultPrompts) {
+        return '';
+    }
+    return readFileFromInstallDir(filename);
+}
+/**
+ * Wraps content within randomized block
+ */
+export function wrapContent(content, wrapBlockPrefix = 'block', prefix = 'content', alwaysWrap = false) {
+    if (content || alwaysWrap) {
+        const contentWrapper = [];
+        const block = wrapBlockPrefix + '-' + randomUUID().substring(0, 7);
+        contentWrapper.push(`\nProvided ${prefix} follows within ${block} block\n`);
+        contentWrapper.push(`<${block}>\n`);
+        contentWrapper.push(content);
+        contentWrapper.push(`\n</${block}>\n`);
+        return contentWrapper.join('');
+    }
+    return content;
+}
+/**
+ * Utility function to execute hook(s) - either a single hook or an array of hooks
+ * Fully type-safe and works with any number of arguments
+ * @param hooks - Single hook function or array of hook functions (or undefined)
+ * @param args - Arguments to pass to each hook function
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export async function executeHooks(hooks, ...args) {
+    if (!hooks)
+        return;
+    if (Array.isArray(hooks)) {
+        for (const hook of hooks) {
+            await hook(...args);
+        }
+    }
+    else {
+        await hooks(...args);
+    }
+}
+/**
+ * Format tool call arguments in a human-readable way
+ */
+export function formatToolCallArgs(args) {
+    return Object.entries(args)
+        .map(([key, value]) => {
+        let displayValue;
+        if (typeof value === 'string') {
+            displayValue = value;
+        }
+        else if (Array.isArray(value) || (typeof value === 'object' && value !== null)) {
+            displayValue = JSON.stringify(value);
+        }
+        else {
+            displayValue = String(value);
+        }
+        return `${key}: ${truncateString(displayValue, 50)}`;
+    })
+        .join(', ');
+}
+/**
+ * Format multiple tool calls for display (matches Invocation.ts behavior)
+ */
+export function formatToolCalls(toolCalls, maxLength = 255) {
+    const formatted = toolCalls
+        .map((toolCall) => {
+        debugLog(JSON.stringify(toolCall));
+        const formattedArgs = formatToolCallArgs(toolCall.args || {});
+        return `${toolCall.name}(${formattedArgs})`;
+    })
+        .join(', ');
+    // Truncate to maxLength characters if needed
+    return formatted.length > maxLength ? formatted.slice(0, maxLength - 3) + '...' : formatted;
+}
+//# 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":"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"}

package/dist/utils/stringUtils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Truncate a string to a maximum length with ellipsis
+ */
+export declare function truncateString(str: string, maxLength: number): string;

package/dist/utils/stringUtils.js

@@ -0,0 +1,10 @@
+/**
+ * Truncate a string to a maximum length with ellipsis
+ */
+export function truncateString(str, maxLength) {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return str.slice(0, maxLength - 3) + '...';
+}
+//# 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;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC3D,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC7C,CAAC"}

package/dist/utils/systemUtils.d.ts

@@ -0,0 +1,70 @@
+import { createInterface, type Interface as ReadLineInterface } from 'node:readline/promises';
+/**
+ * Generic interface for program-like objects that can parse arguments.
+ * Allows decoupling from commander's Command type.
+ */
+export interface ProgramLike {
+    getOptionValue(key: string): unknown;
+    parseAsync(args?: string[]): Promise<unknown>;
+}
+export declare const waitForEscape: (callback: () => void, enabled: boolean) => void;
+export declare const stopWaitingForEscape: () => void;
+export declare const setRawMode: (rawMode: boolean) => void;
+export declare const initLogStream: (logFileName: string) => void;
+export declare const writeToLogStream: (message: string) => void;
+export declare const closeLogStream: () => void;
+/**
+ * The process.cwd() has a weird behaviour when the app is a part of monorepo,
+ * always returning the directory of this specific project,
+ * this causes integration tests to fail, because they are specifically testing ability to respect actual current dirs.
+ * Gaunt Sloth is a command line tool and it is always supposed to function in the current directory.
+ * Using INIT_CWD forces to always use actual CWD. cwd() fallback is just in case.
+ * In environments where INIT_CWD is available (npm and alike) - INIT_CWD is the correct choice,
+ * since they are likely to juggle the process.cwd(), where it is unavailable process.cwd() is used.
+ */
+export declare const getCurrentWorkDir: () => string;
+export declare const getInstallDir: () => string;
+/**
+ * Cached string from stdin. Should only be called after readStdin completes execution.
+ */
+export declare const getStringFromStdin: () => string;
+/**
+ * Get the current useColour setting.
+ */
+export declare const getUseColour: () => boolean;
+/**
+ * Set the useColour setting.
+ */
+export declare const setUseColour: (useColour: boolean) => void;
+export declare const isTTY: () => boolean;
+export declare const exit: (code?: number) => never;
+export declare const stdin: NodeJS.ReadStream & {
+    fd: 0;
+};
+export declare const stdout: NodeJS.WriteStream & {
+    fd: 1;
+};
+export declare const argv: string[];
+export declare const env: NodeJS.ProcessEnv;
+export declare const setExitCode: (code: number) => void;
+export { createInterface };
+export type { ReadLineInterface };
+/**
+ * Provide the path to the entry point of the application.
+ * This is used to set the install directory.
+ * This is called from cli.js root entry point.
+ */
+export declare const setEntryPoint: (indexJs: string) => void;
+/**
+ * Asynchronously reads the stdin and stores it as a string,
+ * it can later be retrieved with getStringFromStdin.
+ */
+export declare function readStdin(program: ProgramLike): Promise<void>;
+export declare const log: (message: string) => void;
+export declare const error: (message: string) => void;
+export declare const warn: (message: string) => void;
+export declare const info: (message: string) => void;
+export declare const debug: (message: string) => void;
+export declare const stream: (chunk: string) => boolean;
+export declare function execAsync(command: string): Promise<string>;
+export declare function getSlothVersion(): string;