sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/config/workspace-roots.js

@@ -0,0 +1,448 @@
+/**
+ * Workspace Roots Management for SFCC MCP Server
+ *
+ * This module handles secure discovery and validation of workspace roots
+ * provided by MCP clients, enabling automatic dw.json discovery from the
+ * VS Code workspace without requiring absolute paths.
+ *
+ * Configuration Discovery Priority:
+ * 1. CLI parameter (--dw-json) - handled in main.ts
+ * 2. Environment variables (SFCC_*) - handled in main.ts
+ * 3. MCP workspace roots (this module) - called after client connects
+ *
+ * This discovery mechanism is preferred over CWD-based search because
+ * MCP servers often start with cwd set to the user's home directory,
+ * not the project directory. The MCP workspace roots capability provides
+ * the correct project context from VS Code/Copilot/Cursor.
+ *
+ * Security considerations:
+ * - Only file:// URIs are accepted (per MCP spec)
+ * - Path traversal attacks are prevented
+ * - System directories are blocked
+ * - Symlink resolution is handled securely
+ */
+import { existsSync, realpathSync, statSync } from 'fs';
+import { resolve, normalize, join, isAbsolute } from 'path';
+import { fileURLToPath } from 'url';
+import { Logger } from '../utils/logger.js';
+import { loadSecureDwJson } from './dw-json-loader.js';
+/**
+ * Dangerous system paths that should never be accessed
+ * These are blocked to prevent accidental or malicious access to sensitive areas
+ */
+const BLOCKED_SYSTEM_PATHS = [
+    '/etc',
+    '/proc',
+    '/sys',
+    '/dev',
+    '/root',
+    '/var/log',
+    '/var/run',
+    '/boot',
+    '/sbin',
+    '/bin',
+    // Windows system paths
+    'C:\\Windows',
+    'C:\\Program Files',
+    'C:\\ProgramData',
+    // Common sensitive directories
+    '.ssh',
+    '.gnupg',
+    '.aws',
+    '.config/gcloud',
+];
+/**
+ * Allowed path prefixes for workspace roots
+ * These are the typical locations where development projects reside
+ */
+const ALLOWED_PATH_PATTERNS = [
+    // User home directories
+    /^\/Users\/[^/]+\//i, // macOS
+    /^\/home\/[^/]+\//i, // Linux (allow all users, not just runner)
+    /^C:\\Users\\[^\\]+\\/i, // Windows
+    // Common project directories
+    /^\/opt\//i,
+    /^\/var\/www\//i,
+    /^\/srv\//i,
+    // Temp directories (for testing)
+    /^\/tmp\//i,
+    /^\/private\/tmp\//i, // macOS real temp path
+    /^\/var\/folders\//i, // macOS temp
+    /^\/private\/var\/folders\//i, // macOS real temp path (symlink resolved)
+    /^C:\\Temp\\/i, // Windows temp
+    // CI workspace paths
+    /^\/home\/runner\/work\//i, // GitHub Actions
+];
+/**
+ * Validates that a file URI is safe and converts it to an absolute path
+ *
+ * @param uri - The file:// URI to validate
+ * @returns Validation result with resolved path or error
+ */
+function validateFileUri(uri) {
+    // Check for null bytes and other dangerous characters
+    if (uri.includes('\0') || uri.includes('\x00')) {
+        return { isValid: false, error: 'URI contains invalid characters' };
+    }
+    // Verify it's a file:// URI
+    if (!uri.startsWith('file://')) {
+        return { isValid: false, error: 'Only file:// URIs are supported for workspace roots' };
+    }
+    try {
+        // Convert file URI to path securely
+        const path = fileURLToPath(uri);
+        return validatePath(path);
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            error: `Invalid file URI: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Validates that a file path is safe to use as a workspace root
+ *
+ * @param inputPath - The path to validate
+ * @returns Validation result with resolved path or error
+ */
+function validatePath(inputPath) {
+    // Check for null bytes
+    if (inputPath.includes('\0')) {
+        return { isValid: false, error: 'Path contains invalid characters' };
+    }
+    // Check for excessively long paths (DoS prevention)
+    if (inputPath.length > 4096) {
+        return { isValid: false, error: 'Path is too long' };
+    }
+    // Normalize and resolve the path
+    let resolvedPath;
+    try {
+        resolvedPath = normalize(resolve(inputPath));
+    }
+    catch {
+        return { isValid: false, error: 'Failed to resolve path' };
+    }
+    // Verify it's an absolute path
+    if (!isAbsolute(resolvedPath)) {
+        return { isValid: false, error: 'Path must be absolute' };
+    }
+    // Check against blocked system paths
+    const lowerPath = resolvedPath.toLowerCase();
+    for (const blocked of BLOCKED_SYSTEM_PATHS) {
+        const blockedLower = blocked.toLowerCase();
+        if (lowerPath === blockedLower || lowerPath.startsWith(`${blockedLower}/`) || lowerPath.startsWith(`${blockedLower}\\`)) {
+            return { isValid: false, error: 'Access to system directories is not allowed' };
+        }
+    }
+    // Check that path matches allowed patterns
+    const matchesAllowed = ALLOWED_PATH_PATTERNS.some(pattern => pattern.test(resolvedPath));
+    if (!matchesAllowed) {
+        return {
+            isValid: false,
+            error: 'Path is outside of allowed workspace directories',
+        };
+    }
+    // Verify the path exists and is a directory
+    try {
+        if (!existsSync(resolvedPath)) {
+            return { isValid: false, error: 'Path does not exist' };
+        }
+        const stats = statSync(resolvedPath);
+        if (!stats.isDirectory()) {
+            return { isValid: false, error: 'Path is not a directory' };
+        }
+        // Resolve symlinks to verify the real path is also safe
+        const realPath = realpathSync(resolvedPath);
+        if (realPath !== resolvedPath) {
+            // Re-validate the resolved symlink path
+            const symlinkValidation = validatePath(realPath);
+            if (!symlinkValidation.isValid) {
+                return {
+                    isValid: false,
+                    error: `Symlink target is not allowed: ${symlinkValidation.error}`,
+                };
+            }
+            resolvedPath = realPath;
+        }
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            error: `Cannot access path: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+    return { isValid: true, resolvedPath };
+}
+/**
+ * Service for managing workspace roots from MCP clients
+ *
+ * This class provides secure handling of workspace roots, enabling
+ * automatic discovery of configuration files (like dw.json) in the
+ * agent's working directories.
+ */
+export class WorkspaceRootsService {
+    roots = [];
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? Logger.getInstance();
+    }
+    /**
+     * Update workspace roots from MCP client response
+     *
+     * @param clientRoots - Array of roots from the MCP client (roots/list response)
+     * @returns Array of successfully validated roots
+     */
+    updateRoots(clientRoots) {
+        this.roots = [];
+        for (const root of clientRoots) {
+            const validation = validateFileUri(root.uri);
+            if (validation.isValid && validation.resolvedPath) {
+                this.roots.push({
+                    uri: root.uri,
+                    path: validation.resolvedPath,
+                    name: root.name,
+                });
+                this.logger.debug(`Validated workspace root: ${root.name ?? root.uri} -> ${validation.resolvedPath}`);
+            }
+            else {
+                this.logger.debug(`Rejected workspace root: ${root.uri} - ${validation.error}`);
+            }
+        }
+        this.logger.log(`Workspace roots updated: ${this.roots.length} valid root(s)`);
+        return [...this.roots];
+    }
+    /**
+     * Get all validated workspace roots
+     */
+    getRoots() {
+        return [...this.roots];
+    }
+    /**
+     * Search for a file in all workspace roots
+     *
+     * @param filename - The filename to search for (e.g., 'dw.json')
+     * @param maxDepth - Maximum directory depth to search (default: 2)
+     * @returns The first matching file path, or undefined if not found
+     */
+    findFile(filename, maxDepth = 2) {
+        // Validate filename to prevent path traversal
+        if (filename.includes('/') || filename.includes('\\') || filename.includes('..')) {
+            this.logger.debug(`Invalid filename rejected: ${filename}`);
+            return undefined;
+        }
+        for (const root of this.roots) {
+            const found = this.searchInDirectory(root.path, filename, 0, maxDepth);
+            if (found) {
+                this.logger.debug(`Found ${filename} in workspace root: ${found}`);
+                return found;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Recursively search for a file in a directory
+     *
+     * @param directory - Directory to search
+     * @param filename - Filename to find
+     * @param currentDepth - Current recursion depth
+     * @param maxDepth - Maximum depth to search
+     * @returns File path if found, undefined otherwise
+     */
+    searchInDirectory(directory, filename, currentDepth, maxDepth) {
+        // Check immediate file
+        const filePath = join(directory, filename);
+        if (existsSync(filePath)) {
+            try {
+                const stats = statSync(filePath);
+                if (stats.isFile()) {
+                    return filePath;
+                }
+            }
+            catch {
+                // Ignore access errors
+            }
+        }
+        // Don't recurse deeper if at max depth
+        if (currentDepth >= maxDepth) {
+            return undefined;
+        }
+        // Search subdirectories (limited set to avoid excessive scanning)
+        const allowedSubdirs = ['cartridges', 'config', '.vscode', 'sfcc'];
+        for (const subdir of allowedSubdirs) {
+            const subdirPath = join(directory, subdir);
+            try {
+                if (existsSync(subdirPath) && statSync(subdirPath).isDirectory()) {
+                    const found = this.searchInDirectory(subdirPath, filename, currentDepth + 1, maxDepth);
+                    if (found) {
+                        return found;
+                    }
+                }
+            }
+            catch {
+                // Ignore access errors
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if a given path is within any of the validated workspace roots
+     *
+     * This is useful for validating that file operations stay within
+     * the allowed workspace boundaries.
+     *
+     * @param filePath - The path to check
+     * @returns true if the path is within a workspace root
+     */
+    isPathWithinRoots(filePath) {
+        try {
+            // Normalize and resolve the path
+            const normalizedPath = normalize(resolve(filePath));
+            // For existing paths, resolve symlinks to get the real path
+            // For non-existing paths (like potential new files), use the normalized path
+            let checkPath = normalizedPath;
+            if (existsSync(normalizedPath)) {
+                checkPath = realpathSync(normalizedPath);
+            }
+            else {
+                // For non-existing paths, try to resolve symlinks in the parent directory chain
+                // This handles cases like /var/folders on macOS which is a symlink to /private/var/folders
+                let parentPath = normalizedPath;
+                while (parentPath !== '/') {
+                    const parent = resolve(parentPath, '..');
+                    if (parent === parentPath) {
+                        break;
+                    }
+                    parentPath = parent;
+                    if (existsSync(parentPath)) {
+                        // Found an existing parent, resolve its realpath and reconstruct
+                        const realParent = realpathSync(parentPath);
+                        const relativePart = normalizedPath.substring(parentPath.length);
+                        checkPath = realParent + relativePart;
+                        break;
+                    }
+                }
+            }
+            return this.roots.some(root => {
+                return checkPath.startsWith(`${root.path}/`) || checkPath.startsWith(`${root.path}\\`) || checkPath === root.path;
+            });
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Clear all workspace roots
+     */
+    clear() {
+        this.roots = [];
+        this.logger.debug('Workspace roots cleared');
+    }
+    /**
+     * Discover dw.json from MCP client workspace roots
+     *
+     * This is the main entry point for workspace-based config discovery.
+     * It takes raw roots from the MCP client, validates them, searches for
+     * dw.json, and loads the configuration.
+     *
+     * @param clientRoots - Raw roots array from server.listRoots() response
+     * @returns Discovery result with config if found
+     */
+    discoverDwJson(clientRoots) {
+        this.logger.log('[WorkspaceRoots] Starting dw.json discovery from client roots');
+        // Log what we received from the client
+        if (!clientRoots) {
+            this.logger.log('[WorkspaceRoots] No roots array received from client (undefined)');
+            return { success: false, reason: 'No roots array received from client' };
+        }
+        this.logger.log(`[WorkspaceRoots] Received ${clientRoots.length} root(s) from client`);
+        if (clientRoots.length === 0) {
+            this.logger.log('[WorkspaceRoots] Client returned empty roots array');
+            return { success: false, reason: 'Client returned empty roots array', rootsReceived: 0 };
+        }
+        // Log each root we received
+        clientRoots.forEach((root, index) => {
+            this.logger.log(`[WorkspaceRoots] Root ${index + 1}: uri="${root.uri}", name="${root.name ?? '(none)'}"`);
+        });
+        // Validate and store the workspace roots
+        const validRoots = this.updateRoots(clientRoots);
+        this.logger.log(`[WorkspaceRoots] After validation: ${validRoots.length} valid root(s)`);
+        if (validRoots.length === 0) {
+            this.logger.log('[WorkspaceRoots] No valid roots after security validation');
+            return {
+                success: false,
+                reason: 'No valid workspace roots after security validation',
+                rootsReceived: clientRoots.length,
+                validRoots: 0,
+            };
+        }
+        // Log validated roots
+        validRoots.forEach((root, index) => {
+            this.logger.log(`[WorkspaceRoots] Valid root ${index + 1}: path="${root.path}"`);
+        });
+        // Search for dw.json in workspace roots
+        this.logger.log('[WorkspaceRoots] Searching for dw.json in workspace roots...');
+        const dwJsonPath = this.findFile('dw.json');
+        if (!dwJsonPath) {
+            this.logger.log('[WorkspaceRoots] No dw.json found in any workspace root');
+            return {
+                success: false,
+                reason: 'No dw.json found in workspace roots',
+                rootsReceived: clientRoots.length,
+                validRoots: validRoots.length,
+            };
+        }
+        this.logger.log(`[WorkspaceRoots] Found dw.json at: ${dwJsonPath}`);
+        // Load and validate the dw.json
+        try {
+            const config = loadSecureDwJson(dwJsonPath);
+            this.logger.log('[WorkspaceRoots] Successfully loaded dw.json');
+            this.logger.log(`[WorkspaceRoots]   hostname: ${config.hostname}`);
+            this.logger.log(`[WorkspaceRoots]   username: ${config.username ? '(set)' : '(not set)'}`);
+            this.logger.log(`[WorkspaceRoots]   password: ${config.password ? '(set)' : '(not set)'}`);
+            this.logger.log(`[WorkspaceRoots]   client-id: ${config['client-id'] ? '(set)' : '(not set)'}`);
+            this.logger.log(`[WorkspaceRoots]   client-secret: ${config['client-secret'] ? '(set)' : '(not set)'}`);
+            return {
+                success: true,
+                config,
+                dwJsonPath,
+                rootsReceived: clientRoots.length,
+                validRoots: validRoots.length,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`[WorkspaceRoots] Failed to load dw.json: ${errorMessage}`);
+            return {
+                success: false,
+                reason: `Failed to load dw.json: ${errorMessage}`,
+                dwJsonPath,
+                rootsReceived: clientRoots.length,
+                validRoots: validRoots.length,
+            };
+        }
+    }
+}
+/**
+ * Validate a path for dw.json access
+ *
+ * This is a standalone function that can be used by the dw-json-loader
+ * to validate paths before attempting to read them.
+ *
+ * @param filePath - The path to validate
+ * @returns Object with isValid flag and optional error message
+ */
+export function validateDwJsonPath(filePath) {
+    // First validate the directory containing the file
+    const directory = resolve(filePath, '..');
+    const validation = validatePath(directory);
+    if (!validation.isValid) {
+        return validation;
+    }
+    // Additional validation: ensure it's a .json file
+    if (!filePath.toLowerCase().endsWith('.json')) {
+        return { isValid: false, error: 'Only .json files are allowed' };
+    }
+    return { isValid: true };
+}
+//# sourceMappingURL=workspace-roots.js.map

package/dist/config/workspace-roots.js.map

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

package/dist/constants/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

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

package/dist/constants/index.js

@@ -0,0 +1,3 @@
+"use strict";
+// Constants module currently has no re-exports; reserved for future shared constants.
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

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

package/dist/core/handlers/abstract-client-handler.d.ts

@@ -0,0 +1,52 @@
+import { BaseToolHandler, ToolExecutionContext, GenericToolSpec, HandlerContext, ToolArguments } from './base-handler.js';
+import { ClientFactory } from './client-factory.js';
+/**
+ * Abstract base class for handlers that need a client with factory-based creation.
+ * This provides a simpler alternative to SimpleClientHandler when you need
+ * access to ClientFactory for more complex client creation scenarios.
+ *
+ * Use this when:
+ * - Your client needs ClientFactory for creation (e.g., requires config/credentials)
+ * - You need a simple single-client handler pattern
+ *
+ * Use SimpleClientHandler when:
+ * - Your client has a simple constructor with no dependencies
+ * - You want the most minimal boilerplate
+ */
+export declare abstract class AbstractClientHandler<TToolName extends string, TClient> extends BaseToolHandler<TToolName> {
+    protected client: TClient | null;
+    protected clientFactory: ClientFactory;
+    constructor(context: HandlerContext, subLoggerName: string);
+    /**
+     * Create the client for this handler.
+     * Returns null if the client cannot be created (e.g., missing credentials).
+     */
+    protected abstract createClient(): TClient | null;
+    /**
+     * Get the context key used to expose the client in the execution context.
+     */
+    protected abstract getClientContextKey(): string;
+    /**
+     * Get a descriptive name for the client (used in logging and error messages).
+     */
+    protected abstract getClientDisplayName(): string;
+    /**
+     * Get the error message when the client is not available.
+     * Override this for custom error messages.
+     */
+    protected getClientRequiredError(): string;
+    protected onInitialize(): Promise<void>;
+    protected onDispose(): Promise<void>;
+    protected createExecutionContext(): Promise<ToolExecutionContext>;
+    /**
+     * Abstract method to get tool configuration.
+     * Each concrete handler implements this with their specific config.
+     */
+    protected abstract getToolConfig(): Record<TToolName, GenericToolSpec<ToolArguments, any>>;
+    /**
+     * Abstract method to get tool name set for O(1) lookup.
+     * Each concrete handler implements this with their specific tool set.
+     */
+    protected abstract getToolNameSet(): Set<TToolName>;
+}
+//# sourceMappingURL=abstract-client-handler.d.ts.map

package/dist/core/handlers/abstract-client-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/abstract-client-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,8BAAsB,qBAAqB,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO,CAAE,SAAQ,eAAe,CAAC,SAAS,CAAC;IAC/G,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAQ;IACxC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;gBAE3B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;IAK1D;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,GAAG,IAAI;IAEjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,IAAI,MAAM;IAEhD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,MAAM;IAEjD;;;OAGG;IACH,SAAS,CAAC,sBAAsB,IAAI,MAAM;cAI1B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;cAK1B,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAYvE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAE1F;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,GAAG,CAAC,SAAS,CAAC;CACpD"}

package/dist/core/handlers/abstract-client-handler.js

@@ -0,0 +1,51 @@
+import { BaseToolHandler } from './base-handler.js';
+import { ClientFactory } from './client-factory.js';
+/**
+ * Abstract base class for handlers that need a client with factory-based creation.
+ * This provides a simpler alternative to SimpleClientHandler when you need
+ * access to ClientFactory for more complex client creation scenarios.
+ *
+ * Use this when:
+ * - Your client needs ClientFactory for creation (e.g., requires config/credentials)
+ * - You need a simple single-client handler pattern
+ *
+ * Use SimpleClientHandler when:
+ * - Your client has a simple constructor with no dependencies
+ * - You want the most minimal boilerplate
+ */
+export class AbstractClientHandler extends BaseToolHandler {
+    client = null;
+    clientFactory;
+    constructor(context, subLoggerName) {
+        super(context, subLoggerName);
+        this.clientFactory = new ClientFactory(context, this.logger);
+    }
+    /**
+     * Get the error message when the client is not available.
+     * Override this for custom error messages.
+     */
+    getClientRequiredError() {
+        return `${this.getClientDisplayName()} client not initialized`;
+    }
+    async onInitialize() {
+        this.client = this.createClient();
+        if (this.client) {
+            this.logger.debug(`${this.getClientDisplayName()} client initialized`);
+        }
+    }
+    async onDispose() {
+        this.client = null;
+        this.logger.debug(`${this.getClientDisplayName()} client disposed`);
+    }
+    async createExecutionContext() {
+        if (!this.client) {
+            throw new Error(this.getClientRequiredError());
+        }
+        return {
+            handlerContext: this.context,
+            logger: this.logger,
+            [this.getClientContextKey()]: this.client,
+        };
+    }
+}
+//# sourceMappingURL=abstract-client-handler.js.map

package/dist/core/handlers/abstract-client-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-client-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/abstract-client-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,qBAAyD,SAAQ,eAA0B;IACrG,MAAM,GAAmB,IAAI,CAAC;IAC9B,aAAa,CAAgB;IAEvC,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAkBD;;;OAGG;IACO,sBAAsB;QAC9B,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IACjE,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IACtE,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM;SAC1C,CAAC;IACJ,CAAC;CAaF"}

package/dist/core/handlers/agent-instructions-handler.d.ts

@@ -0,0 +1,17 @@
+import { HandlerContext, ToolExecutionContext } from './base-handler.js';
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { AgentInstructionsClient } from '../../clients/agent-instructions-client.js';
+import { AgentInstructionToolName } from '../../tool-configs/agent-instructions-tool-config.js';
+/**
+ * Handler for installing/merging AGENTS.md and skills into the user's project
+ */
+export declare class AgentInstructionsToolHandler extends SimpleClientHandler<AgentInstructionToolName, AgentInstructionsClient> {
+    private readonly instructionAdvisor;
+    private agentInstructionsClient;
+    constructor(context: HandlerContext);
+    /**
+     * Override to add instructionAdvisor to execution context
+     */
+    protected createExecutionContext(): Promise<ToolExecutionContext>;
+}
+//# sourceMappingURL=agent-instructions-handler.d.ts.map

package/dist/core/handlers/agent-instructions-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions-handler.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/agent-instructions-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAEL,wBAAwB,EAEzB,MAAM,sDAAsD,CAAC;AAG9D;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,mBAAmB,CACnE,wBAAwB,EACxB,uBAAuB,CACxB;IACC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,uBAAuB,CAAwC;gBAE3D,OAAO,EAAE,cAAc;IAgBnC;;OAEG;cACsB,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAOjF"}

package/dist/core/handlers/agent-instructions-handler.js

@@ -0,0 +1,38 @@
+import { SimpleClientHandler } from './simple-client-handler.js';
+import { AgentInstructionsClient } from '../../clients/agent-instructions-client.js';
+import { InstructionAdvisor } from '../instruction-advisor.js';
+import { AGENT_INSTRUCTION_TOOL_CONFIG, AGENT_INSTRUCTION_TOOL_NAMES_SET, } from '../../tool-configs/agent-instructions-tool-config.js';
+import { WorkspaceRootsService } from '../../config/workspace-roots.js';
+/**
+ * Handler for installing/merging AGENTS.md and skills into the user's project
+ */
+export class AgentInstructionsToolHandler extends SimpleClientHandler {
+    instructionAdvisor;
+    agentInstructionsClient = null;
+    constructor(context) {
+        const rootsService = context.workspaceRootsService ?? new WorkspaceRootsService(context.logger);
+        const client = new AgentInstructionsClient(rootsService);
+        super(context, 'AgentInstructions', {
+            toolConfig: AGENT_INSTRUCTION_TOOL_CONFIG,
+            toolNameSet: AGENT_INSTRUCTION_TOOL_NAMES_SET,
+            clientContextKey: 'agentInstructionsClient',
+            clientDisplayName: 'Agent instructions',
+            createClient: () => {
+                this.agentInstructionsClient = client;
+                return client;
+            },
+        });
+        this.instructionAdvisor = new InstructionAdvisor(client, context.logger);
+    }
+    /**
+     * Override to add instructionAdvisor to execution context
+     */
+    async createExecutionContext() {
+        const baseContext = await super.createExecutionContext();
+        return {
+            ...baseContext,
+            instructionAdvisor: this.instructionAdvisor,
+        };
+    }
+}
+//# sourceMappingURL=agent-instructions-handler.js.map

package/dist/core/handlers/agent-instructions-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/agent-instructions-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,6BAA6B,EAE7B,gCAAgC,GACjC,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,mBAGjD;IACkB,kBAAkB,CAAqB;IAChD,uBAAuB,GAAmC,IAAI,CAAC;IAEvE,YAAY,OAAuB;QACjC,MAAM,YAAY,GAAG,OAAO,CAAC,qBAAqB,IAAI,IAAI,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC,YAAY,CAAC,CAAC;QACzD,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE;YAClC,UAAU,EAAE,6BAA6B;YACzC,WAAW,EAAE,gCAAgC;YAC7C,gBAAgB,EAAE,yBAAyB;YAC3C,iBAAiB,EAAE,oBAAoB;YACvC,YAAY,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC;gBACtC,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACgB,KAAK,CAAC,sBAAsB;QAC7C,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACzD,OAAO;YACL,GAAG,WAAW;YACd,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC;IACJ,CAAC;CACF"}