@gaunt-sloth/core 0.0.1

package/dist/config.js

@@ -0,0 +1,412 @@
+/**
+ * @packageDocumentation
+ * Gaunt Sloth Configuration.
+ *
+ * Refer to {@link GthConfig} to find all possible configuration properties.
+ *
+ * Refer to {@link DEFAULT_CONFIG} for default configuration.
+ *
+ * Some config params can be overriden from command line, see {@link CommandLineConfigOverrides}
+ */
+import { PROJECT_GUIDELINES, PROJECT_REVIEW_INSTRUCTIONS, USER_PROJECT_CONFIG_JS, USER_PROJECT_CONFIG_JSON, USER_PROJECT_CONFIG_MJS, } from '#src/constants.js';
+import { StatusLevel } from '#src/core/types.js';
+import { displayDebug, displayError, displayInfo, displayWarning, setConsoleLevel, } from '#src/utils/consoleUtils.js';
+import { getGslothConfigReadPath, importExternalFile } from '#src/utils/fileUtils.js';
+import { error, exit, isTTY, setUseColour } from '#src/utils/systemUtils.js';
+import { existsSync, readFileSync } from 'node:fs';
+export const availableDefaultConfigs = [
+    'vertexai',
+    'anthropic',
+    'groq',
+    'deepseek',
+    'openai',
+    'google-genai',
+    'xai',
+    'openrouter',
+];
+/**
+ * Default config
+ */
+export const DEFAULT_CONFIG = {
+    contentSource: 'file',
+    requirementSource: 'file',
+    contentProvider: 'file',
+    requirementsProvider: 'file',
+    /**
+     * Path to project-specific guidelines.
+     * The default is `.gsloth.guidelines.md`; this config may be used to point Gaunt Sloth to a different file,
+     * for example, to AGENTS.md
+     */
+    projectGuidelines: PROJECT_GUIDELINES,
+    /**
+     * Whether to include the current date in the project review instructions or not.
+     */
+    includeCurrentDateAfterGuidelines: false,
+    projectReviewInstructions: PROJECT_REVIEW_INSTRUCTIONS,
+    filesystem: 'none',
+    debugLog: false,
+    consoleLevel: StatusLevel.INFO, // Default to INFO level, not debug
+    /**
+     * Default provider for both requirements and content is GitHub.
+     * It needs GitHub CLI (gh).
+     *
+     * `github` content provider uses `gh pr diff NN` internally. {@link src/providers/ghPrDiffProvider.ts!}
+     *
+     *
+     * `github` requirements provider `gh issue view NN` internally
+     */
+    commands: {
+        pr: {
+            contentSource: 'github',
+            requirementSource: 'github',
+            contentProvider: 'github',
+            requirementsProvider: 'github',
+            rating: {
+                enabled: true,
+                passThreshold: 6,
+                minRating: 0,
+                maxRating: 10,
+                errorOnReviewFail: true,
+            },
+        },
+        review: {
+            rating: {
+                enabled: true,
+                passThreshold: 6,
+                minRating: 0,
+                maxRating: 10,
+                errorOnReviewFail: true,
+            },
+        },
+        ask: {
+            filesystem: 'read',
+        },
+        chat: {
+            filesystem: 'read',
+        },
+        code: {
+            filesystem: 'all',
+        },
+        api: {
+            filesystem: 'read',
+            port: 3000,
+            cors: {
+                allowOrigin: 'http://localhost:3000',
+                allowMethods: 'POST, GET, OPTIONS',
+                allowHeaders: 'Content-Type, Accept',
+            },
+        },
+    },
+    streamOutput: true,
+    writeOutputToFile: true,
+    writeBinaryOutputsToFile: true,
+    useColour: true,
+    streamSessionInferenceLog: true,
+    canInterruptInferenceWithEsc: true,
+    aiignore: {
+        enabled: true,
+        patterns: undefined,
+    },
+};
+/**
+ * Needed DEFAULT_CONFIG to be plain const to be picked up by typedoc,
+ * this cast here is just for typecheck.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-expressions
+DEFAULT_CONFIG;
+/**
+ * Initialize configuration by loading from available config files
+ * @returns The loaded GthConfig
+ */
+export async function initConfig(commandLineConfigOverrides) {
+    if (commandLineConfigOverrides.customConfigPath &&
+        !existsSync(commandLineConfigOverrides.customConfigPath)) {
+        throw new Error(`Provided manual config "${commandLineConfigOverrides.customConfigPath}" does not exist`);
+    }
+    const jsonConfigPath = commandLineConfigOverrides.customConfigPath ??
+        getGslothConfigReadPath(USER_PROJECT_CONFIG_JSON, commandLineConfigOverrides.identityProfile);
+    // Try loading the JSON config file first
+    if (jsonConfigPath.endsWith('.json') && existsSync(jsonConfigPath)) {
+        try {
+            // TODO makes sense to employ ZOD to validate config
+            const jsonConfig = JSON.parse(readFileSync(jsonConfigPath, 'utf8'));
+            // If the config has an LLM with a type, create the appropriate LLM instance
+            if (jsonConfig.llm && typeof jsonConfig.llm === 'object' && 'type' in jsonConfig.llm) {
+                return await tryJsonConfig(jsonConfig, commandLineConfigOverrides);
+            }
+            else {
+                error(`${jsonConfigPath} is not in valid format. Should at least define llm.type`);
+                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) {
+            displayDebug(e instanceof Error ? e : String(e));
+            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_JSON}, will try other formats.`);
+            // Continue to try other formats
+            return await tryJsConfig(commandLineConfigOverrides);
+        }
+    }
+    else {
+        // JSON config not found, try JS
+        return tryJsConfig(commandLineConfigOverrides);
+    }
+}
+// Helper function to try loading JS config
+async function tryJsConfig(commandLineConfigOverrides) {
+    const jsConfigPath = commandLineConfigOverrides.customConfigPath ??
+        getGslothConfigReadPath(USER_PROJECT_CONFIG_JS, commandLineConfigOverrides.identityProfile);
+    if (jsConfigPath.endsWith('.js') && existsSync(jsConfigPath)) {
+        try {
+            const i = await importExternalFile(jsConfigPath);
+            const customConfig = await i.configure();
+            return await mergeConfig(customConfig, commandLineConfigOverrides);
+        }
+        catch (e) {
+            displayDebug(e instanceof Error ? e : String(e));
+            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_JS}, will try other formats.`);
+            // Continue to try other formats
+            return await tryMjsConfig(commandLineConfigOverrides);
+        }
+    }
+    else {
+        // JS config not found, try MJS
+        return await tryMjsConfig(commandLineConfigOverrides);
+    }
+}
+// Helper function to try loading MJS config
+async function tryMjsConfig(commandLineConfigOverrides) {
+    const mjsConfigPath = commandLineConfigOverrides.customConfigPath ??
+        getGslothConfigReadPath(USER_PROJECT_CONFIG_MJS, commandLineConfigOverrides.identityProfile);
+    if (mjsConfigPath.endsWith('.mjs') && existsSync(mjsConfigPath)) {
+        try {
+            const i = await importExternalFile(mjsConfigPath);
+            const customConfig = await i.configure();
+            return await mergeConfig(customConfig, commandLineConfigOverrides);
+        }
+        catch (e) {
+            displayDebug(e instanceof Error ? e : String(e));
+            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_MJS}.`);
+            displayError(`No valid configuration found. Please create a valid configuration file.`);
+            exit(1);
+        }
+    }
+    else {
+        // No config files found
+        displayError('No configuration file found. Please create one of: ' +
+            `${USER_PROJECT_CONFIG_JSON}, ${USER_PROJECT_CONFIG_JS}, or ${USER_PROJECT_CONFIG_MJS} ` +
+            'in your project directory.');
+        exit(1);
+    }
+    // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
+    throw new Error('Unexpected error occurred.');
+}
+/**
+ * Process JSON LLM config by creating the appropriate LLM instance
+ * @param jsonConfig - The parsed JSON config
+ * @param commandLineConfigOverrides - command line config overrides
+ * @returns Promise<GthConfig>
+ */
+export async function tryJsonConfig(jsonConfig, commandLineConfigOverrides) {
+    try {
+        if (jsonConfig.llm && typeof jsonConfig.llm === 'object') {
+            // Get the type of LLM (e.g. 'vertexai', 'anthropic') - this should exist
+            const llmType = jsonConfig.llm.type;
+            if (!llmType) {
+                displayError('LLM type not specified in config.');
+                exit(1);
+            }
+            // Get the configuration for the specific LLM type
+            const llmConfig = jsonConfig.llm;
+            if (commandLineConfigOverrides.verbose) {
+                // Necessary to avoid https://github.com/langchain-ai/langchainjs/issues/8705
+                llmConfig.verbose = commandLineConfigOverrides.verbose;
+            }
+            // Import the appropriate config module
+            const configModule = await import(`#src/providers/${llmType}.js`);
+            if (configModule.processJsonConfig) {
+                const llm = (await configModule.processJsonConfig(llmConfig));
+                const mergedConfig = mergeRawConfig(jsonConfig, llm, commandLineConfigOverrides);
+                if (configModule.postProcessJsonConfig) {
+                    return await configModule.postProcessJsonConfig(mergedConfig);
+                }
+                else {
+                    return await mergedConfig;
+                }
+            }
+            else {
+                displayWarning(`Config module for ${llmType} does not have processJsonConfig function.`);
+                exit(1);
+            }
+        }
+        else {
+            displayError('No LLM configuration found in config.');
+            exit(1);
+        }
+    }
+    catch (e) {
+        if (e instanceof Error && e.message.includes('Cannot find module')) {
+            displayError(`LLM type '${jsonConfig.llm.type}' not supported.`);
+        }
+        else {
+            displayError(`Error processing LLM config: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        exit(1);
+    }
+    // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
+    throw new Error('Unexpected error occurred.');
+}
+/**
+ * Deep merge two objects, with source overriding target properties
+ * @param target - The target object with default values
+ * @param source - The source object with user overrides
+ * @param maxDepth - Maximum recursion depth to prevent stack overflow (default: 4)
+ */
+function deepMerge(target, source, maxDepth = 4) {
+    if (!source)
+        return target;
+    if (!target)
+        return source;
+    const result = { ...target };
+    // Return result without merging if depth is exceeded
+    if (maxDepth === 0)
+        return result;
+    for (const key in source) {
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (sourceValue &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            // Recursively merge nested objects
+            result[key] = deepMerge(targetValue, sourceValue, maxDepth - 1);
+        }
+        else if (sourceValue !== undefined) {
+            // Override with source value if it exists
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+/**
+ * Merge config with default config
+ */
+async function mergeConfig(partialConfig, commandLineConfigOverrides) {
+    const config = partialConfig;
+    // Migrate deprecated property names
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const raw = config;
+    if (raw.contentProvider && !raw.contentSource) {
+        displayWarning('Config property "contentProvider" is deprecated. Use "contentSource" instead.');
+        config.contentSource = raw.contentProvider;
+    }
+    if (raw.requirementsProvider && !raw.requirementSource) {
+        displayWarning('Config property "requirementsProvider" is deprecated. Use "requirementSource" instead.');
+        config.requirementSource = raw.requirementsProvider;
+    }
+    // Keep both old and new in sync
+    if (config.contentSource)
+        config.contentProvider = config.contentSource;
+    if (config.requirementSource)
+        config.requirementsProvider = config.requirementSource;
+    // Migrate command-level deprecated properties
+    if (config.commands) {
+        for (const cmdName of ['pr', 'review']) {
+            const cmd = config.commands[cmdName];
+            if (cmd) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const cmdRaw = cmd;
+                if (cmdRaw.contentProvider && !cmdRaw.contentSource) {
+                    cmd.contentSource = cmdRaw.contentProvider;
+                }
+                if (cmdRaw.requirementsProvider && !cmdRaw.requirementSource) {
+                    cmd.requirementSource = cmdRaw.requirementsProvider;
+                }
+                if (cmd.contentSource)
+                    cmd.contentProvider = cmd.contentSource;
+                if (cmd.requirementSource)
+                    cmd.requirementsProvider = cmd.requirementSource;
+            }
+        }
+    }
+    // Deep merge command configs while preserving defaults
+    // Type complexity from DEFAULT_CONFIG.commands 'as const' requires any cast for deep merge result
+    const mergedCommands = {
+        pr: deepMerge(DEFAULT_CONFIG.commands.pr, config?.commands?.pr), // eslint-disable-line @typescript-eslint/no-explicit-any
+        review: deepMerge(DEFAULT_CONFIG.commands.review, config?.commands?.review), // eslint-disable-line @typescript-eslint/no-explicit-any
+        code: deepMerge(DEFAULT_CONFIG.commands.code, config?.commands?.code), // eslint-disable-line @typescript-eslint/no-explicit-any
+        ask: deepMerge(DEFAULT_CONFIG.commands.ask, config?.commands?.ask), // eslint-disable-line @typescript-eslint/no-explicit-any
+        chat: deepMerge(DEFAULT_CONFIG.commands.chat, config?.commands?.chat), // eslint-disable-line @typescript-eslint/no-explicit-any
+        api: deepMerge(DEFAULT_CONFIG.commands.api, config?.commands?.api), // eslint-disable-line @typescript-eslint/no-explicit-any
+    };
+    const mergedConfig = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        commands: mergedCommands,
+    };
+    if (commandLineConfigOverrides.identityProfile !== undefined) {
+        displayInfo(`Activating profile: ${commandLineConfigOverrides.identityProfile}`);
+        mergedConfig.identityProfile = commandLineConfigOverrides.identityProfile.trim();
+    }
+    if (commandLineConfigOverrides.verbose !== undefined) {
+        mergedConfig.llm.verbose = commandLineConfigOverrides.verbose;
+    }
+    if (commandLineConfigOverrides.writeOutputToFile !== undefined) {
+        mergedConfig.writeOutputToFile = commandLineConfigOverrides.writeOutputToFile;
+    }
+    // Set the useColour value in systemUtils
+    setUseColour(mergedConfig.useColour);
+    // Set console logging level
+    if (mergedConfig.consoleLevel !== undefined) {
+        const resolvedConsoleLevel = resolveConsoleLevel(mergedConfig.consoleLevel);
+        if (resolvedConsoleLevel !== undefined) {
+            mergedConfig.consoleLevel = resolvedConsoleLevel;
+            setConsoleLevel(resolvedConsoleLevel);
+        }
+        else {
+            displayWarning(`Invalid consoleLevel "${String(mergedConfig.consoleLevel)}", using default ${StatusLevel.INFO}.`);
+            mergedConfig.consoleLevel = StatusLevel.INFO;
+            setConsoleLevel(StatusLevel.INFO);
+        }
+    }
+    mergedConfig.canInterruptInferenceWithEsc = mergedConfig.canInterruptInferenceWithEsc && isTTY();
+    return mergedConfig;
+}
+const CONSOLE_LEVELS_BY_NAME = {
+    debug: StatusLevel.DEBUG,
+    info: StatusLevel.INFO,
+    display: StatusLevel.DISPLAY,
+    success: StatusLevel.SUCCESS,
+    warning: StatusLevel.WARNING,
+    error: StatusLevel.ERROR,
+    stream: StatusLevel.STREAM,
+};
+function resolveConsoleLevel(level) {
+    if (typeof level === 'number') {
+        return StatusLevel[level] !== undefined ? level : undefined;
+    }
+    if (typeof level === 'string') {
+        const normalized = level.trim().toLowerCase();
+        if (normalized in CONSOLE_LEVELS_BY_NAME) {
+            return CONSOLE_LEVELS_BY_NAME[normalized];
+        }
+        const enumValue = StatusLevel[level];
+        if (typeof enumValue === 'number') {
+            return enumValue;
+        }
+    }
+    return undefined;
+}
+/**
+ * Merge raw with default config
+ */
+async function mergeRawConfig(config, llm, commandLineConfigOverrides) {
+    const modelDisplayName = config.llm?.model;
+    return await mergeConfig({ ...config, llm, modelDisplayName }, commandLineConfigOverrides);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const GSLOTH_DIR = ".gsloth";
+export declare const GSLOTH_SETTINGS_DIR = ".gsloth-settings";
+export declare const GSLOTH_AUTH = ".gsloth-auth";
+export declare const USER_PROJECT_CONFIG_JS = ".gsloth.config.js";
+export declare const USER_PROJECT_CONFIG_JSON = ".gsloth.config.json";
+export declare const USER_PROJECT_CONFIG_MJS = ".gsloth.config.mjs";
+export declare const GSLOTH_BACKSTORY = ".gsloth.backstory.md";
+export declare const PROJECT_GUIDELINES = ".gsloth.guidelines.md";
+export declare const PROJECT_REVIEW_INSTRUCTIONS = ".gsloth.review.md";
+export declare const GSLOTH_SYSTEM_PROMPT = ".gsloth.system.md";
+export declare const GSLOTH_CHAT_PROMPT = ".gsloth.chat.md";
+export declare const GSLOTH_CODE_PROMPT = ".gsloth.code.md";
+export declare const AIIGNORE_FILE = ".aiignore";

package/dist/constants.js

@@ -0,0 +1,14 @@
+export const GSLOTH_DIR = '.gsloth';
+export const GSLOTH_SETTINGS_DIR = '.gsloth-settings';
+export const GSLOTH_AUTH = '.gsloth-auth';
+export const USER_PROJECT_CONFIG_JS = '.gsloth.config.js';
+export const USER_PROJECT_CONFIG_JSON = '.gsloth.config.json';
+export const USER_PROJECT_CONFIG_MJS = '.gsloth.config.mjs';
+export const GSLOTH_BACKSTORY = '.gsloth.backstory.md';
+export const PROJECT_GUIDELINES = '.gsloth.guidelines.md';
+export const PROJECT_REVIEW_INSTRUCTIONS = '.gsloth.review.md';
+export const GSLOTH_SYSTEM_PROMPT = '.gsloth.system.md';
+export const GSLOTH_CHAT_PROMPT = '.gsloth.chat.md';
+export const GSLOTH_CODE_PROMPT = '.gsloth.code.md';
+export const AIIGNORE_FILE = '.aiignore';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC"}

package/dist/core/GthAgentRunner.d.ts

@@ -0,0 +1,27 @@
+import { GthConfig } from '#src/config.js';
+import { BaseCheckpointSaver } from '@langchain/langgraph';
+import { AgentResolvers, GthAgentInterface, GthCommand, Message, StatusUpdateCallback } from '#src/core/types.js';
+/**
+ * Agent simplifies interaction with LLM and reduces it to calling a few methods
+ * {@link GthAgentRunner#init} and {@link GthAgentRunner#processMessages}.
+ */
+export declare class GthAgentRunner {
+    private statusUpdate;
+    private resolvers;
+    private agent;
+    private config;
+    private runConfig;
+    constructor(statusUpdate: StatusUpdateCallback, resolvers?: AgentResolvers);
+    /**
+     * Init is split into a separate method. This may create a number of connections,
+     * and we'd better have an instance by that moment, for the case things will go wrong,
+     * so we can wrap init into try-catch and then call {@link #cleanup} within finally.
+     */
+    init(command: GthCommand | undefined, configIn: GthConfig, checkpointSaver?: BaseCheckpointSaver | undefined): Promise<void>;
+    /**
+     * processMessages deals with both streaming and non-streaming approaches.
+     */
+    processMessages(messages: Message[]): Promise<string>;
+    getAgent(): GthAgentInterface | null;
+    cleanup(): Promise<void>;
+}

package/dist/core/GthAgentRunner.js

@@ -0,0 +1,109 @@
+import { GthLangChainAgent } from '#src/core/GthLangChainAgent.js';
+import { enhanceVertexUnauthorizedMessage } from '#src/utils/vertexaiUtils.js';
+import { getNewRunnableConfig } from '#src/utils/llmUtils.js';
+import { initDebugLogging, debugLog, debugLogError, debugLogObject, } from '#src/utils/debugUtils.js';
+/**
+ * Agent simplifies interaction with LLM and reduces it to calling a few methods
+ * {@link GthAgentRunner#init} and {@link GthAgentRunner#processMessages}.
+ */
+export class GthAgentRunner {
+    statusUpdate;
+    resolvers;
+    agent = null;
+    config = null;
+    runConfig = null;
+    constructor(statusUpdate, resolvers) {
+        this.statusUpdate = statusUpdate;
+        this.resolvers = resolvers;
+    }
+    /**
+     * Init is split into a separate method. This may create a number of connections,
+     * and we'd better have an instance by that moment, for the case things will go wrong,
+     * so we can wrap init into try-catch and then call {@link #cleanup} within finally.
+     */
+    async init(command, configIn, checkpointSaver) {
+        this.config = configIn;
+        // Initialize debug logging
+        initDebugLogging(configIn.debugLog ?? false);
+        debugLog(`Initializing GthAgentRunner with command: ${command || 'default'}`);
+        this.runConfig = getNewRunnableConfig();
+        debugLogObject('Runnable Config', this.runConfig);
+        this.agent = new GthLangChainAgent(this.statusUpdate, this.resolvers);
+        // Initialize the agent
+        debugLog('Initializing agent...');
+        await this.agent.init(command, configIn, checkpointSaver);
+        debugLog('Agent initialization complete');
+    }
+    /**
+     * processMessages deals with both streaming and non-streaming approaches.
+     */
+    async processMessages(messages) {
+        if (!this.agent || !this.config || !this.runConfig) {
+            throw new Error('AgentRunner not initialized. Call init() first.');
+        }
+        debugLog('Processing messages...');
+        debugLogObject('Input Messages', messages);
+        try {
+            // Decision: Use streaming or non-streaming based on config
+            if (this.config.streamOutput) {
+                // Use streaming
+                debugLog('Using streaming mode');
+                const stream = await this.agent.stream(messages, this.runConfig);
+                let result = '';
+                try {
+                    for await (const chunk of stream) {
+                        debugLogObject('Stream chunk', chunk);
+                        result += chunk;
+                    }
+                }
+                catch (streamError) {
+                    // Handle streaming-specific errors
+                    debugLogError('Stream processing', streamError);
+                    throw new Error(`Stream processing failed: ${streamError instanceof Error ? streamError.message : String(streamError)}`);
+                }
+                debugLog(`Stream completed. Total response length: ${result.length}`);
+                if (result.trim().length === 0) {
+                    debugLog('Stream produced empty response, retrying once with non-streaming invoke.');
+                    const fallback = await this.agent.invoke(messages, this.runConfig);
+                    debugLog(`Fallback non-stream response length: ${fallback.length}`);
+                    if (fallback.trim().length === 0) {
+                        throw new Error('Model returned an empty response after tool execution. Try again or switch to a more stable model.');
+                    }
+                    return fallback;
+                }
+                return result;
+            }
+            else {
+                // Use non-streaming
+                debugLog('Using non-streaming mode');
+                const result = await this.agent.invoke(messages, this.runConfig);
+                debugLog(`Non-stream response length: ${result.length}`);
+                if (result.trim().length === 0) {
+                    throw new Error('Model returned an empty response. Try again or switch to a more stable model.');
+                }
+                return result;
+            }
+        }
+        catch (error) {
+            // Handle agent invocation errors
+            debugLogError('Agent processing', error);
+            const originalMessage = error instanceof Error ? error.message : String(error);
+            const enhancedMessage = enhanceVertexUnauthorizedMessage(originalMessage, this.config?.llm);
+            throw new Error(`Agent processing failed: ${enhancedMessage}`, error instanceof Error ? { cause: error } : undefined);
+        }
+    }
+    // noinspection JSUnusedGlobalSymbols
+    getAgent() {
+        return this.agent;
+    }
+    async cleanup() {
+        debugLog('Cleaning up GthAgentRunner...');
+        if (this.agent && 'cleanup' in this.agent && typeof this.agent.cleanup === 'function') {
+            await this.agent.cleanup();
+        }
+        this.agent = null;
+        this.config = null;
+        debugLog('GthAgentRunner cleanup complete');
+    }
+}
+//# sourceMappingURL=GthAgentRunner.js.map

package/dist/core/GthAgentRunner.js.map

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