@gaunt-sloth/tools 0.0.1

package/README.md

@@ -0,0 +1,25 @@
+# @gaunt-sloth/tools
+
+Tools and middleware for Gaunt Sloth.
+
+## Contents
+
+- Built-in tools configuration (`builtInToolsConfig`)
+- Filesystem toolkit (`GthFileSystemToolkit`) — provides read/write/glob/grep tools controlled by `.aiignore`
+- Custom tools (`GthCustomToolkit`) — executes user-defined shell commands from config
+- Dev tools (`GthDevToolkit`) — tools for development and coding sessions
+- Status update tool
+- Web fetch tool
+- Binary content injection middleware
+- Middleware registry (`resolveMiddleware`) and types
+
+## Dependencies
+
+- `@gaunt-sloth/core`
+
+## Exports
+
+```js
+import { builtInToolsConfig } from '@gaunt-sloth/tools/builtInToolsConfig.js';
+import { resolveMiddleware } from '@gaunt-sloth/tools/middleware/registry.js';
+```

package/dist/builtInToolsConfig.d.ts

@@ -0,0 +1,22 @@
+import { StructuredToolInterface } from '@langchain/core/tools';
+import { GthConfig } from '@gaunt-sloth/core/config.js';
+import { GthCommand } from '@gaunt-sloth/core/core/types.js';
+/**
+ * Available built-in tools may be configured in JSON config, see `builtInTools` of {@link GthConfig}.
+ *
+ * Does not include `filesystem`, because filesystem has its own config in {@link GthConfig}.
+ */
+export declare const AVAILABLE_BUILT_IN_TOOLS: {
+    /**
+     * Reference tool. Simply prints provided argument to the screen.
+     */
+    readonly gth_status_update: "#src/tools/gthStatusUpdateTool.js";
+    /**
+     * Web fetch tool.
+     */
+    readonly gth_web_fetch: "#src/tools/gthWebFetchTool.js";
+};
+/**
+ * Get default tools based on filesystem and built-in tools configuration
+ */
+export declare function getDefaultTools(config: GthConfig, command?: GthCommand): Promise<StructuredToolInterface[]>;

package/dist/builtInToolsConfig.js

@@ -0,0 +1,134 @@
+/**
+ * @packageDocumentation
+ * Built-in tools config. {@link AVAILABLE_BUILT_IN_TOOLS} has a list of available tools.
+ */
+import GthFileSystemToolkit from '#src/tools/GthFileSystemToolkit.js';
+import { displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getCurrentWorkDir } from '@gaunt-sloth/core/utils/systemUtils.js';
+import GthDevToolkit from '#src/tools/GthDevToolkit.js';
+import GthCustomToolkit from '#src/tools/GthCustomToolkit.js';
+/**
+ * Available built-in tools may be configured in JSON config, see `builtInTools` of {@link GthConfig}.
+ *
+ * Does not include `filesystem`, because filesystem has its own config in {@link GthConfig}.
+ */
+export const AVAILABLE_BUILT_IN_TOOLS = {
+    /**
+     * Reference tool. Simply prints provided argument to the screen.
+     */
+    gth_status_update: '#src/tools/gthStatusUpdateTool.js',
+    /**
+     * Web fetch tool.
+     */
+    gth_web_fetch: '#src/tools/gthWebFetchTool.js',
+};
+/**
+ * Get default tools based on filesystem and built-in tools configuration
+ */
+export async function getDefaultTools(config, command) {
+    const filesystemTools = filterFilesystemTools(config.filesystem, config.aiignore, config.binaryFormats);
+    const builtInTools = await getBuiltInTools(config);
+    const devTools = await filterDevTools(command, config.commands?.code?.devTools);
+    const customTools = getCustomTools(config, command);
+    return [...filesystemTools, ...devTools, ...customTools, ...builtInTools];
+}
+async function filterDevTools(command, devToolConfig) {
+    if (command !== 'code' || !devToolConfig) {
+        return [];
+    }
+    const toolkit = new GthDevToolkit(devToolConfig);
+    return [...toolkit.getTools()];
+}
+/**
+ * Get custom tools based on configuration.
+ * Supports global customTools and per-command overrides.
+ */
+function getCustomTools(config, command) {
+    // Determine which custom tools to use
+    let toolsConfig;
+    if (command && config.commands?.[command]) {
+        const cmdConfig = config.commands[command];
+        // Check if command has customTools override
+        if ('customTools' in cmdConfig) {
+            toolsConfig = cmdConfig.customTools;
+        }
+        else {
+            // No override, use root-level
+            toolsConfig = config.customTools;
+        }
+    }
+    else {
+        // No command specified or no command config, use root-level
+        toolsConfig = config.customTools;
+    }
+    // If explicitly disabled or empty, return no tools
+    if (toolsConfig === false || !toolsConfig || Object.keys(toolsConfig).length === 0) {
+        return [];
+    }
+    // Create toolkit with the determined config
+    const toolkit = new GthCustomToolkit(toolsConfig);
+    return toolkit.getTools();
+}
+/**
+ * Filter filesystem tools based on configuration
+ */
+function filterFilesystemTools(filesystemConfig, aiignoreConfig, binaryFormats) {
+    const toolkit = new GthFileSystemToolkit({
+        allowedDirectories: [getCurrentWorkDir()],
+        aiignoreConfig,
+        binaryFormats,
+    });
+    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 = 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) {
+    const tools = [];
+    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]);
+                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;
+}
+//# sourceMappingURL=builtInToolsConfig.js.map

package/dist/builtInToolsConfig.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from '#src/builtInToolsConfig.js';
+export { resolveMiddleware } from '#src/middleware/registry.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from '#src/builtInToolsConfig.js';
+export { resolveMiddleware } from '#src/middleware/registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/middleware/binaryContentInjectionMiddleware.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @packageDocumentation
+ * Middleware to inject binary content (images, PDFs, audio) as HumanMessage.
+ *
+ * The gth_read_binary tool returns binary data as a special string format:
+ * gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * where path is URL-encoded to handle special characters like semicolons.
+ *
+ * This middleware:
+ * 1. Detects the gth_read_binary tool calls
+ * 2. Parses the special string format from ToolMessage content
+ * 3. Injects HumanMessage with binary content blocks before next model call
+ *
+ * This works around LangChain's limitation where ToolMessage doesn't properly
+ * support binary content blocks for most providers.
+ */
+import { type AgentMiddleware } from 'langchain';
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+export interface BinaryContentInjectionMiddlewareSettings {
+    name?: 'binary-content-injection';
+}
+export declare function createBinaryContentInjectionMiddleware(_settings: BinaryContentInjectionMiddlewareSettings, _gthConfig: GthConfig): Promise<AgentMiddleware>;

package/dist/middleware/binaryContentInjectionMiddleware.js

@@ -0,0 +1,125 @@
+/**
+ * @packageDocumentation
+ * Middleware to inject binary content (images, PDFs, audio) as HumanMessage.
+ *
+ * The gth_read_binary tool returns binary data as a special string format:
+ * gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * where path is URL-encoded to handle special characters like semicolons.
+ *
+ * This middleware:
+ * 1. Detects the gth_read_binary tool calls
+ * 2. Parses the special string format from ToolMessage content
+ * 3. Injects HumanMessage with binary content blocks before next model call
+ *
+ * This works around LangChain's limitation where ToolMessage doesn't properly
+ * support binary content blocks for most providers.
+ */
+import { createMiddleware } from 'langchain';
+import path from 'node:path';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+import { ToolMessage, HumanMessage } from '@langchain/core/messages';
+/**
+ * Parse the special binary format string returned by gth_read_binary tool.
+ * Format: gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * Path is URL-encoded to handle special characters.
+ */
+function parseBinaryContent(content) {
+    if (!content.startsWith('gth_read_binary;')) {
+        return null;
+    }
+    try {
+        const parts = content.split(';');
+        if (parts.length < 4) {
+            return null;
+        }
+        const typeMatch = parts[1]?.match(/^type:(.+)$/);
+        const pathMatch = parts[2]?.match(/^path:(.+)$/);
+        const dataMatch = parts[3]?.match(/^data:(.+)$/);
+        const base64Match = content.match(/;base64,(.+)$/);
+        if (!typeMatch || !pathMatch || !dataMatch || !base64Match) {
+            return null;
+        }
+        // Decode the URL-encoded path
+        const decodedPath = decodeURIComponent(pathMatch[1]);
+        return {
+            formatType: typeMatch[1],
+            path: decodedPath,
+            media_type: dataMatch[1],
+            data: base64Match[1],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function createContentBlock(binaryData) {
+    const { formatType, media_type, data } = binaryData;
+    return {
+        type: formatType,
+        source_type: 'base64',
+        mime_type: media_type,
+        data,
+        metadata: {
+            filename: path.basename(binaryData.path),
+        },
+    };
+}
+function getFormatLabel(formatType) {
+    const labels = {
+        image: 'image',
+        video: 'video',
+        audio: 'audio',
+        file: 'file',
+    };
+    return labels[formatType] || 'file';
+}
+export function createBinaryContentInjectionMiddleware(_settings, _gthConfig) {
+    debugLog('Creating binary content injection middleware');
+    return Promise.resolve(createMiddleware({
+        name: 'binary-content-injection',
+        // Before next model call, detect and inject HumanMessage with binary content
+        beforeModel: async (state) => {
+            const messages = state.messages || [];
+            // Find recent ToolMessages from gth_read_binary
+            const binaryMessages = [];
+            // Check last few messages (usually just need to check the most recent)
+            for (let i = messages.length - 1; i >= Math.max(0, messages.length - 5); i--) {
+                const msg = messages[i];
+                if (msg instanceof ToolMessage &&
+                    msg.name === 'gth_read_binary' &&
+                    typeof msg.content === 'string') {
+                    const parsedContent = parseBinaryContent(msg.content);
+                    if (parsedContent) {
+                        binaryMessages.push({ message: msg, binaryData: parsedContent });
+                    }
+                }
+            }
+            // If we found binary content, inject HumanMessage(s)
+            if (binaryMessages.length > 0) {
+                debugLog(`Injecting ${binaryMessages.length} HumanMessage(s) with binary content`);
+                const newMessages = [...messages];
+                for (const { binaryData } of binaryMessages) {
+                    const formatLabel = getFormatLabel(binaryData.formatType);
+                    const contentBlock = createContentBlock(binaryData);
+                    const humanMessage = new HumanMessage({
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Here is the ${formatLabel} content from the file:`,
+                            },
+                            contentBlock,
+                        ],
+                    });
+                    newMessages.push(humanMessage);
+                }
+                // Return the modified state with new messages
+                return {
+                    messages: newMessages,
+                };
+            }
+            // No binary content, pass through
+            return undefined;
+        },
+    }));
+}
+//# sourceMappingURL=binaryContentInjectionMiddleware.js.map

package/dist/middleware/binaryContentInjectionMiddleware.js.map

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

package/dist/middleware/registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @packageDocumentation
+ * Middleware registry for Gaunt Sloth Assistant.
+ *
+ * This module provides factory functions for creating predefined middleware instances
+ * and a resolver to convert middleware configurations into middleware objects.
+ */
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+import type { AnthropicPromptCachingConfig, MiddlewareConfig, SummarizationConfig } from '#src/middleware/types.js';
+import { type AgentMiddleware } from 'langchain';
+/**
+ * Create Anthropic prompt caching middleware.
+ * This middleware adds cache control headers to reduce API costs.
+ */
+export declare function createAnthropicPromptCachingMiddleware(config: AnthropicPromptCachingConfig, _: GthConfig): Promise<AgentMiddleware>;
+/**
+ * Create summarization middleware.
+ * This middleware automatically condenses conversation history when approaching token limits.
+ *
+ * @param config - Configuration for the middleware
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Middleware object
+ */
+export declare function createSummarizationMiddleware(config: SummarizationConfig, gthConfig: GthConfig): Promise<AgentMiddleware>;
+/**
+ * Resolve middleware configuration into middleware instances.
+ * Converts string identifiers and config objects into actual middleware.
+ * Automatically injects binary-content-injection middleware if binaryFormats is enabled.
+ *
+ * @param configs - Array of middleware configurations
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Array of middleware instances
+ */
+export declare function resolveMiddleware(configs: MiddlewareConfig[] | undefined, gthConfig: GthConfig): Promise<AgentMiddleware[]>;

package/dist/middleware/registry.js

@@ -0,0 +1,124 @@
+/**
+ * @packageDocumentation
+ * Middleware registry for Gaunt Sloth Assistant.
+ *
+ * This module provides factory functions for creating predefined middleware instances
+ * and a resolver to convert middleware configurations into middleware objects.
+ */
+import { displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+import { anthropicPromptCachingMiddleware, summarizationMiddleware, } from 'langchain';
+import { createBinaryContentInjectionMiddleware, } from '#src/middleware/binaryContentInjectionMiddleware.js';
+const predefinedMiddlewareFactories = {
+    /**
+     * Anthropic prompt caching middleware. see https://docs.langchain.com/oss/javascript/langchain/middleware#anthropic-prompt-caching
+     */
+    'anthropic-prompt-caching': (settings, gthConfig) => createAnthropicPromptCachingMiddleware(settings, gthConfig),
+    /**
+     * Summarization middleware. see https://docs.langchain.com/oss/javascript/langchain/middleware#summarization
+     */
+    summarization: (settings, gthConfig) => createSummarizationMiddleware(settings, gthConfig),
+    /**
+     * Binary content injection middleware.
+     * Intercepts tool results containing binary data (images, PDFs, audio) and injects them
+     * as HumanMessage content blocks before the next model call.
+     * This works around LangChain's limitation where ToolMessage doesn't support binary content.
+     */
+    'binary-content-injection': (settings, gthConfig) => createBinaryContentInjectionMiddleware(settings, gthConfig),
+};
+function isPredefinedMiddlewareName(name) {
+    return name in predefinedMiddlewareFactories;
+}
+function isPredefinedMiddlewareObject(config) {
+    return (typeof config === 'object' &&
+        config !== null &&
+        'name' in config &&
+        typeof config.name === 'string' &&
+        isPredefinedMiddlewareName(config.name));
+}
+/**
+ * Create Anthropic prompt caching middleware.
+ * This middleware adds cache control headers to reduce API costs.
+ */
+export async function createAnthropicPromptCachingMiddleware(config, _) {
+    debugLog(`Creating Anthropic prompt caching middleware with TTL: ${config.ttl || 'default'}`);
+    // Dynamic import for async initialization
+    return Promise.resolve(anthropicPromptCachingMiddleware({ ttl: config.ttl }));
+}
+/**
+ * Create summarization middleware.
+ * This middleware automatically condenses conversation history when approaching token limits.
+ *
+ * @param config - Configuration for the middleware
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Middleware object
+ */
+export async function createSummarizationMiddleware(config, gthConfig) {
+    debugLog('Creating summarization middleware');
+    return Promise.resolve(summarizationMiddleware({
+        model: config.model || gthConfig.llm,
+        ...config,
+    }));
+}
+/**
+ * Resolve middleware configuration into middleware instances.
+ * Converts string identifiers and config objects into actual middleware.
+ * Automatically injects binary-content-injection middleware if binaryFormats is enabled.
+ *
+ * @param configs - Array of middleware configurations
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Array of middleware instances
+ */
+export async function resolveMiddleware(configs, gthConfig) {
+    const configsToResolve = configs || [];
+    const middleware = [];
+    // Auto-inject binary-content-injection middleware if binaryFormats is configured
+    // It is only auto-injected if binaryFormats is enabled.
+    const hasBinaryFormats = gthConfig.binaryFormats !== undefined &&
+        gthConfig.binaryFormats !== false &&
+        gthConfig.binaryFormats.length > 0;
+    const hasBinaryMiddleware = configsToResolve.some((c) => c === 'binary-content-injection' ||
+        (typeof c === 'object' && 'name' in c && c.name === 'binary-content-injection'));
+    if (hasBinaryFormats && !hasBinaryMiddleware) {
+        debugLog('Auto-injecting binary-content-injection middleware (binaryFormats is enabled)');
+        middleware.push(await createPredefinedMiddleware('binary-content-injection', {}, gthConfig));
+    }
+    for (const config of configsToResolve) {
+        try {
+            // Handle string configuration (predefined middleware with defaults)
+            if (typeof config === 'string') {
+                middleware.push(await createPredefinedMiddleware(config, {}, gthConfig));
+            }
+            // Handle predefined middleware with custom settings
+            else if (isPredefinedMiddlewareObject(config)) {
+                const { name, ...settings } = config;
+                middleware.push(await createPredefinedMiddleware(name, settings, gthConfig));
+            }
+            // Handle custom middleware object (JS config only)
+            else {
+                debugLog('Adding custom middleware');
+                middleware.push(config);
+            }
+        }
+        catch (error) {
+            displayWarning(`Failed to create middleware: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return middleware;
+}
+/**
+ * Create a predefined middleware instance by name.
+ *
+ * @param name - Name of the predefined middleware
+ * @param settings - Configuration settings for the middleware
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Middleware instance
+ */
+async function createPredefinedMiddleware(name, settings, gthConfig) {
+    if (!isPredefinedMiddlewareName(name)) {
+        throw new Error(`Unknown predefined middleware: ${name}`);
+    }
+    const factory = predefinedMiddlewareFactories[name];
+    return factory(settings, gthConfig);
+}
+//# sourceMappingURL=registry.js.map

package/dist/middleware/registry.js.map

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

package/dist/middleware/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @packageDocumentation
+ * Type definitions for middleware configuration in Gaunt Sloth Assistant.
+ *
+ * Middleware provides hooks to intercept and control agent execution at critical points.
+ * This module defines the configuration interfaces for both predefined and custom middleware.
+ */
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { AgentMiddleware } from 'langchain';
+/**
+ * Predefined middleware types that can be configured via JSON config.
+ */
+export type PredefinedMiddlewareName = 'anthropic-prompt-caching' | 'summarization' | 'binary-content-injection';
+/**
+ * Configuration for Anthropic prompt caching middleware.
+ */
+export interface AnthropicPromptCachingConfig {
+    /**
+     * Cache TTL (time to live).
+     * Examples: "5m" for 5 minutes, "1h" for 1 hour
+     */
+    ttl?: '5m' | '1h';
+}
+/**
+ * Configuration for summarization middleware.
+ */
+export interface SummarizationConfig {
+    /**
+     * Model to use for summarization.
+     * If not provided, uses the main LLM from config.
+     */
+    model?: BaseChatModel;
+    /**
+     * Maximum tokens before triggering summarization.
+     * Set one of:
+     */
+    trigger?: {
+        fraction?: number;
+        tokens?: number;
+        messages?: number;
+    };
+    /**
+     * How many tokens, messages, or a fraction of context to keep.
+     * Set one of:
+     */
+    keep?: {
+        fraction?: number;
+        tokens?: number;
+        messages?: number;
+    };
+    /**
+     * Custom prompt template for summarization.
+     */
+    summaryPrompt?: string;
+}
+/**
+ * Configuration for image format transformation middleware.
+ */
+export interface ImageFormatTransformConfig {
+    /**
+     * Detail level for image processing.
+     * Examples: "low", "high", "auto"
+     */
+    detail?: 'low' | 'high' | 'auto';
+}
+/**
+ * Configuration for binary content injection middleware.
+ * This middleware intercepts tool results containing binary data (images, PDFs, audio)
+ * and injects them as HumanMessage content blocks.
+ */
+export interface BinaryContentInjectionConfig {
+}
+/**
+ * Union type of all predefined middleware configurations.
+ */
+export type PredefinedMiddlewareConfig = ({
+    name: 'anthropic-prompt-caching';
+} & AnthropicPromptCachingConfig) | ({
+    name: 'summarization';
+} & SummarizationConfig) | ({
+    name: 'binary-content-injection';
+} & BinaryContentInjectionConfig);
+/**
+ * Middleware configuration that can be specified in JSON or JS config.
+ * - String: Name of predefined middleware with default settings
+ * - PredefinedMiddlewareConfig: Predefined middleware with custom settings (JSON compatible)
+ * - CustomMiddleware: Custom middleware object (JS config only)
+ */
+export type MiddlewareConfig = string | PredefinedMiddlewareConfig | AgentMiddleware;

package/dist/middleware/types.js

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Type definitions for middleware configuration in Gaunt Sloth Assistant.
+ *
+ * Middleware provides hooks to intercept and control agent execution at critical points.
+ * This module defines the configuration interfaces for both predefined and custom middleware.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/middleware/types.js.map

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