sfcc-dev-mcp 1.0.21 → 1.0.22

package/dist/core/handlers/validation-helpers.js

@@ -3,77 +3,9 @@
  */
 import { HandlerError } from './base-handler.js';
 import { isValidLogLevel, LogLevelValues } from '../../utils/log-tool-constants.js';
-export class ValidationHelpers {
-    /**
-     * Validate arguments against a set of rules
-     */
-    static validateArguments(args, rules, toolName) {
-        for (const rule of rules) {
-            const value = args?.[rule.field];
-            // Check required fields
-            if (rule.required && (value === undefined || value === null || value === '')) {
-                throw new HandlerError(rule.errorMessage ?? `${rule.field} is required`, toolName, 'MISSING_ARGUMENT', { field: rule.field, rules });
-            }
-            // Skip type and custom validation if value is not present and not required
-            if (!rule.required && (value === undefined || value === null)) {
-                continue;
-            }
-            // Check type (including for required fields that have values)
-            if (rule.type && value !== undefined && value !== null && !this.validateType(value, rule.type)) {
-                throw new HandlerError(rule.errorMessage ?? `${rule.field} must be of type ${rule.type}`, toolName, 'INVALID_TYPE', { field: rule.field, expectedType: rule.type, actualType: typeof value });
-            }
-            // Custom validation
-            if (rule.validator && !rule.validator(value)) {
-                throw new HandlerError(rule.errorMessage ?? `${rule.field} validation failed`, toolName, 'VALIDATION_FAILED', { field: rule.field, value });
-            }
-        }
-    }
-    static validateType(value, type) {
-        switch (type) {
-            case 'string':
-                return typeof value === 'string';
-            case 'number':
-                return typeof value === 'number' && !isNaN(value);
-            case 'boolean':
-                return typeof value === 'boolean';
-            case 'object':
-                return typeof value === 'object' && value !== null && !Array.isArray(value);
-            case 'array':
-                return Array.isArray(value);
-            default:
-                return true;
-        }
-    }
-}
-/**
- * Common validation rules factory
- */
-export const CommonValidations = {
-    /** Create a required string field validation */
-    requiredString: (field, customMessage) => [{
-            field,
-            required: true,
-            type: 'string',
-            validator: (value) => value.trim().length > 0,
-            errorMessage: customMessage ?? `${field} must be a non-empty string`,
-        }],
-    /** Create a required field validation with custom validator */
-    requiredField: (field, type, validator, errorMessage) => [{
-            field,
-            required: true,
-            type,
-            validator,
-            errorMessage,
-        }],
-    /** Create an optional field validation */
-    optionalField: (field, type, validator, errorMessage) => [{
-            field,
-            required: false,
-            type,
-            validator,
-            errorMessage,
-        }],
-};
+import { resolve, relative, isAbsolute } from 'path';
+import { homedir } from 'os';
+import { existsSync, realpathSync } from 'fs';
 // =============================================================================
 // Log-specific validators (consolidated from log-validation.ts)
 // =============================================================================
@@ -81,7 +13,7 @@ export const CommonValidations = {
 export function validateLogLevel(level, toolName) {
     if (!isValidLogLevel(level)) {
         const validLevels = Object.values(LogLevelValues).join(', ');
-        throw new Error(`Invalid log level '${level}' for ${toolName}. Valid levels: ${validLevels}`);
+        throw new HandlerError(`Invalid log level '${level}' for ${toolName}. Valid levels: ${validLevels}`, toolName, 'INVALID_ARGUMENT', { field: 'level', value: level, validLevels: Object.values(LogLevelValues) });
     }
 }
 /** Validate limit parameter */
@@ -90,10 +22,10 @@ export function validateLimit(limit, toolName) {
         return;
     }
     if (typeof limit !== 'number' || isNaN(limit)) {
-        throw new Error(`Invalid limit '${limit}' for ${toolName}. Must be a valid number`);
+        throw new HandlerError(`Invalid limit '${limit}' for ${toolName}. Must be a valid number`, toolName, 'INVALID_ARGUMENT', { field: 'limit', value: limit });
     }
     if (limit <= 0 || limit > 1000) {
-        throw new Error(`Invalid limit '${limit}' for ${toolName}. Must be between 1 and 1000`);
+        throw new HandlerError(`Invalid limit '${limit}' for ${toolName}. Must be between 1 and 1000`, toolName, 'INVALID_ARGUMENT', { field: 'limit', value: limit, min: 1, max: 1000 });
     }
 }
 /** Validate maxBytes parameter */
@@ -102,32 +34,32 @@ export function validateMaxBytes(maxBytes, toolName) {
         return;
     }
     if (typeof maxBytes !== 'number' || isNaN(maxBytes)) {
-        throw new Error(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be a valid number`);
+        throw new HandlerError(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be a valid number`, toolName, 'INVALID_ARGUMENT', { field: 'maxBytes', value: maxBytes });
     }
     if (maxBytes <= 0 || maxBytes > 10_000_000) {
-        throw new Error(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be between 1 and 10,000,000`);
+        throw new HandlerError(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be between 1 and 10,000,000`, toolName, 'INVALID_ARGUMENT', { field: 'maxBytes', value: maxBytes, min: 1, max: 10_000_000 });
     }
 }
 /** Validate filename parameter */
 export function validateFilename(filename, toolName) {
     if (!filename || filename.trim().length === 0) {
-        throw new Error(`Filename is required for ${toolName}`);
+        throw new HandlerError(`Filename is required for ${toolName}`, toolName, 'MISSING_ARGUMENT', { field: 'filename' });
     }
     // Check for path traversal attempts
     if (filename.includes('..') || filename.includes('\\')) {
-        throw new Error(`Invalid filename '${filename}' for ${toolName}. Path traversal not allowed`);
+        throw new HandlerError(`Invalid filename '${filename}' for ${toolName}. Path traversal not allowed`, toolName, 'INVALID_ARGUMENT', { field: 'filename', value: filename, reason: 'path_traversal' });
     }
     // Check for null byte injection
     if (filename.includes('\0') || filename.includes('\x00')) {
-        throw new Error(`Invalid filename for ${toolName}. Contains invalid characters`);
+        throw new HandlerError(`Invalid filename for ${toolName}. Contains invalid characters`, toolName, 'INVALID_ARGUMENT', { field: 'filename', value: filename, reason: 'invalid_characters' });
     }
     // Check for absolute path attempts
     if (filename.startsWith('/') && !filename.startsWith('/Logs/') && !filename.startsWith('/jobs/')) {
-        throw new Error(`Invalid filename '${filename}' for ${toolName}. Absolute paths outside /Logs/ are not allowed`);
+        throw new HandlerError(`Invalid filename '${filename}' for ${toolName}. Absolute paths outside /Logs/ are not allowed`, toolName, 'INVALID_ARGUMENT', { field: 'filename', value: filename, reason: 'absolute_path_not_allowed' });
     }
     // Check filename length to prevent DoS
     if (filename.length > 1024) {
-        throw new Error(`Invalid filename for ${toolName}. Filename too long`);
+        throw new HandlerError(`Invalid filename for ${toolName}. Filename too long`, toolName, 'INVALID_ARGUMENT', { field: 'filename', length: filename.length, maxLength: 1024 });
     }
 }
 /** Format log operation message */
@@ -159,4 +91,70 @@ export function formatLogMessage(operation, params = {}) {
     }
     return parts.join(' ');
 }
+function isPathWithinRoot(rootPath, candidatePath) {
+    const rel = relative(rootPath, candidatePath);
+    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+}
+function resolvePathForBoundaryCheck(inputPath) {
+    const normalizedPath = resolve(inputPath);
+    if (existsSync(normalizedPath)) {
+        return realpathSync(normalizedPath);
+    }
+    // Resolve symlinks in the nearest existing parent so non-existing targets are checked safely.
+    let parentPath = normalizedPath;
+    while (true) {
+        const nextParent = resolve(parentPath, '..');
+        if (nextParent === parentPath) {
+            return normalizedPath;
+        }
+        parentPath = nextParent;
+        if (!existsSync(parentPath)) {
+            continue;
+        }
+        const realParent = realpathSync(parentPath);
+        const relativeSuffix = relative(parentPath, normalizedPath);
+        return resolve(realParent, relativeSuffix);
+    }
+}
+/**
+ * Validate targetPath writes stay inside workspace roots (if discovered) or current working directory.
+ */
+export function validateTargetPathWithinWorkspace(targetPath, context, toolName) {
+    const hasExplicitTargetPath = typeof targetPath === 'string' && targetPath.trim().length > 0;
+    if (targetPath !== undefined && targetPath !== null && typeof targetPath !== 'string') {
+        throw new HandlerError(`Invalid targetPath for ${toolName}. targetPath must be a string when provided`, toolName, 'INVALID_ARGUMENT', { field: 'targetPath', actualType: typeof targetPath });
+    }
+    if (typeof targetPath === 'string' && (targetPath.includes('\0') || targetPath.includes('\x00'))) {
+        throw new HandlerError(`Invalid targetPath for ${toolName}. Contains invalid characters`, toolName, 'INVALID_ARGUMENT', { field: 'targetPath', reason: 'invalid_characters' });
+    }
+    const resolvedTargetPath = hasExplicitTargetPath
+        ? resolve(targetPath)
+        : resolve(process.cwd());
+    const canonicalTargetPath = resolvePathForBoundaryCheck(resolvedTargetPath);
+    const workspaceRoots = context.handlerContext.workspaceRootsService
+        ?.getRoots()
+        .map(root => resolve(root.path)) ?? [];
+    const cwdRoot = resolve(process.cwd());
+    const homeRoot = resolve(homedir());
+    if (workspaceRoots.length === 0 && cwdRoot === homeRoot) {
+        throw new HandlerError(`Invalid targetPath for ${toolName}. Workspace roots are unavailable and current working directory resolves to the home directory`, toolName, 'TARGET_PATH_OUTSIDE_WORKSPACE', {
+            field: 'targetPath',
+            targetPath: canonicalTargetPath,
+            cwd: cwdRoot,
+            reason: 'home_directory_cwd_without_workspace_roots',
+        });
+    }
+    const allowedRoots = (workspaceRoots.length > 0
+        ? workspaceRoots
+        : [cwdRoot]).map(root => resolvePathForBoundaryCheck(root));
+    const isAllowed = allowedRoots.some(root => isPathWithinRoot(root, canonicalTargetPath));
+    if (!isAllowed) {
+        throw new HandlerError(`Invalid targetPath for ${toolName}. Path must be within workspace roots or current working directory`, toolName, 'TARGET_PATH_OUTSIDE_WORKSPACE', {
+            field: 'targetPath',
+            targetPath: canonicalTargetPath,
+            allowedRoots,
+        });
+    }
+    return hasExplicitTargetPath ? canonicalTargetPath : undefined;
+}
 //# sourceMappingURL=validation-helpers.js.map

package/dist/core/handlers/validation-helpers.js.map

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

package/dist/core/instruction-advisor.d.ts

@@ -10,6 +10,9 @@ export interface McpDevConfig {
 export declare class InstructionAdvisor {
     private readonly client;
     private readonly logger;
+    private noticeEvaluated;
+    private noticeToShow?;
+    private hasShownNotice;
     constructor(client: AgentInstructionsClient, logger: Logger);
     /**
      * Check if agent sync is disabled via mcp-dev.json in the workspace root.

package/dist/core/instruction-advisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instruction-advisor.d.ts","sourceRoot":"","sources":["../../src/core/instruction-advisor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM;IAK3D;;OAEG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BvF,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiD9C,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"instruction-advisor.d.ts","sourceRoot":"","sources":["../../src/core/instruction-advisor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM;IAK3D;;OAEG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BvF,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0E9C,KAAK,IAAI,IAAI;CAKd"}

package/dist/core/instruction-advisor.js

@@ -7,6 +7,9 @@ import path from 'path';
 export class InstructionAdvisor {
     client;
     logger;
+    noticeEvaluated = false;
+    noticeToShow;
+    hasShownNotice = false;
     constructor(client, logger) {
         this.client = client;
         this.logger = logger;
@@ -57,6 +60,16 @@ export class InstructionAdvisor {
         }
     }
     async getNotice() {
+        if (this.hasShownNotice) {
+            return undefined;
+        }
+        if (this.noticeEvaluated) {
+            if (this.noticeToShow) {
+                this.hasShownNotice = true;
+                return this.noticeToShow;
+            }
+            return undefined;
+        }
         try {
             const status = await this.client.getStatus();
             this.logger.debug('[InstructionAdvisor] Status', {
@@ -69,15 +82,20 @@ export class InstructionAdvisor {
             });
             // If we cannot determine a workspace root, skip the notice (can't reliably detect presence)
             if (!status.workspaceRoot) {
+                // Not definitive yet: workspace roots may be discovered later.
                 return undefined;
             }
             // Check if agent sync is disabled via mcp-dev.json
             const syncDisabled = await this.isAgentSyncDisabled(status.workspaceRoot);
             if (syncDisabled) {
                 this.logger.debug('[InstructionAdvisor] Agent sync disabled via mcp-dev.json');
+                this.noticeEvaluated = true;
+                this.noticeToShow = undefined;
                 return undefined;
             }
             if (status.hasAgents && status.hasSkills) {
+                this.noticeEvaluated = true;
+                this.noticeToShow = undefined;
                 return undefined;
             }
             const missingParts = [];
@@ -91,7 +109,7 @@ export class InstructionAdvisor {
                 ? `Missing skills: ${status.missingSkills.join(', ')}`
                 : 'All skills will be installed.';
             this.logger.debug('[InstructionAdvisor] Issuing workspace-root notice');
-            return [
+            this.noticeToShow = [
                 '📋 Agent instructions available for this SFCC project.',
                 `Missing: ${missingParts.join(' + ')}`,
                 missingSkills,
@@ -101,6 +119,9 @@ export class InstructionAdvisor {
                 'If YES: Run sync_agent_instructions with dryRun=false',
                 'If NO: Create mcp-dev.json with {"disableAgentSync": true} to permanently disable this suggestion.',
             ].join('\n');
+            this.noticeEvaluated = true;
+            this.hasShownNotice = true;
+            return this.noticeToShow;
         }
         catch (error) {
             this.logger.debug('InstructionAdvisor failed to evaluate status', error);
@@ -108,7 +129,9 @@ export class InstructionAdvisor {
         }
     }
     reset() {
-        // no-op for now; retained for potential future stateful notice throttling
+        this.noticeEvaluated = false;
+        this.noticeToShow = undefined;
+        this.hasShownNotice = false;
     }
 }
 //# sourceMappingURL=instruction-advisor.js.map

package/dist/core/instruction-advisor.js.map

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

package/dist/core/server-tool-call-lifecycle.d.ts

@@ -0,0 +1,38 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { ToolArgumentValidator } from './tool-argument-validator.js';
+import { BaseToolHandler } from './handlers/base-handler.js';
+import { Logger } from '../utils/logger.js';
+import { LogCapabilityState } from './server-tool-catalog.js';
+export type ProgressToken = string | number;
+export interface ToolRequestExecutionExtras {
+    signal?: AbortSignal;
+    sendNotification?: (notification: {
+        method: string;
+        params?: Record<string, unknown>;
+    }) => Promise<void>;
+}
+interface ToolCallRequest {
+    params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+        _meta?: {
+            progressToken?: ProgressToken;
+        };
+    };
+}
+export interface ToolCallLifecycleContext {
+    logger: Logger;
+    getHandlers: () => BaseToolHandler[];
+    logCapabilityToolNames: Set<string>;
+    ensureLogCapabilityResolved: () => Promise<void>;
+    isToolAvailable: (toolName: string) => boolean;
+    getCapabilitySnapshot: () => {
+        logCapabilityState: LogCapabilityState;
+        canAccessOCAPI: boolean;
+    };
+    toolArgumentValidator: ToolArgumentValidator;
+    getPreflightNotice: () => Promise<string | undefined>;
+}
+export declare function createToolCallHandler(context: ToolCallLifecycleContext): (request: ToolCallRequest, extra?: ToolRequestExecutionExtras) => Promise<CallToolResult>;
+export {};
+//# sourceMappingURL=server-tool-call-lifecycle.d.ts.map

package/dist/core/server-tool-call-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tool-call-lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/server-tool-call-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,eAAe,EAAuB,MAAM,4BAA4B,CAAC;AAElF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1G;AAED,UAAU,eAAe;IACvB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE;YAAE,aAAa,CAAC,EAAE,aAAa,CAAA;SAAE,CAAC;KAC3C,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,2BAA2B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,qBAAqB,EAAE,MAAM;QAC3B,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,wBAAwB,GAChC,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,0BAA0B,KAAK,OAAO,CAAC,cAAc,CAAC,CAqF3F"}

package/dist/core/server-tool-call-lifecycle.js

@@ -0,0 +1,128 @@
+import { createToolErrorResponse } from './tool-error-response.js';
+import { ValidationError } from '../utils/validator.js';
+export function createToolCallHandler(context) {
+    return async (request, extra) => {
+        const { name, arguments: args } = request.params;
+        const startTime = Date.now();
+        const progressToken = request.params._meta?.progressToken;
+        const executionExtras = {
+            signal: extra?.signal,
+            sendNotification: extra?.sendNotification,
+        };
+        context.logger.methodEntry(`handleToolRequest:${name}`, args);
+        try {
+            assertRequestNotCancelled(name, executionExtras.signal);
+            await emitProgress(context.logger, executionExtras, progressToken, 0, 100, `Starting ${name}`);
+            if (context.logCapabilityToolNames.has(name)) {
+                await context.ensureLogCapabilityResolved();
+            }
+            assertRequestNotCancelled(name, executionExtras.signal);
+            await emitProgress(context.logger, executionExtras, progressToken, 20, 100, 'Resolving handler');
+            const handler = context.getHandlers().find((h) => h.canHandle(name));
+            if (!handler) {
+                throw new ValidationError(`Unknown tool: ${name}`, 'UNKNOWN_TOOL', { toolName: name });
+            }
+            if (!context.isToolAvailable(name)) {
+                const capabilitySnapshot = context.getCapabilitySnapshot();
+                throw new ValidationError(`Tool not available in current mode: ${name}`, 'TOOL_NOT_AVAILABLE', {
+                    toolName: name,
+                    canAccessLogs: capabilitySnapshot.logCapabilityState === 'available',
+                    logCapabilityState: capabilitySnapshot.logCapabilityState,
+                    canAccessOCAPI: capabilitySnapshot.canAccessOCAPI,
+                });
+            }
+            assertRequestNotCancelled(name, executionExtras.signal);
+            await emitProgress(context.logger, executionExtras, progressToken, 40, 100, 'Validating arguments');
+            context.toolArgumentValidator.validate(name, args ?? {});
+            assertRequestNotCancelled(name, executionExtras.signal);
+            await emitProgress(context.logger, executionExtras, progressToken, 60, 100, 'Executing tool');
+            const preflightNotice = await context.getPreflightNotice();
+            const result = await awaitWithCancellation(name, handler.handle(name, args ?? {}, startTime), executionExtras.signal);
+            const decoratedResult = preflightNotice
+                ? appendPreflightNotice(result, preflightNotice)
+                : result;
+            await emitProgress(context.logger, executionExtras, progressToken, 100, 100, `${name} complete`);
+            context.logger.debug(`Full response for ${name}:`, {
+                contentItems: decoratedResult.content?.length ?? 0,
+                contentTypes: (decoratedResult.content ?? []).map((item) => item.type),
+                hasStructuredContent: decoratedResult.structuredContent !== undefined,
+                isError: decoratedResult.isError ?? false,
+            });
+            return {
+                content: decoratedResult.content,
+                structuredContent: decoratedResult.structuredContent,
+                isError: decoratedResult.isError,
+            };
+        }
+        catch (error) {
+            context.logger.error(`Error handling tool "${name}":`, error);
+            context.logger.timing(`${name}_error`, startTime);
+            const errorResult = createToolErrorResponse(name, error);
+            context.logger.debug(`Error response for ${name}:`, errorResult);
+            return errorResult;
+        }
+        finally {
+            context.logger.methodExit(`handleToolRequest:${name}`);
+        }
+    };
+}
+function appendPreflightNotice(result, notice) {
+    const trimmedNotice = notice.trim();
+    if (trimmedNotice.length === 0) {
+        return result;
+    }
+    const content = result?.content ?? [];
+    const alreadyIncluded = content.some((item) => item.type === 'text' && item.text === trimmedNotice);
+    if (alreadyIncluded) {
+        return result;
+    }
+    return {
+        ...result,
+        content: [...content, { type: 'text', text: trimmedNotice }],
+    };
+}
+function assertRequestNotCancelled(toolName, signal) {
+    if (signal?.aborted) {
+        throw new ValidationError(`Tool call cancelled: ${toolName}`, 'REQUEST_CANCELLED', { toolName });
+    }
+}
+async function awaitWithCancellation(toolName, operation, signal) {
+    assertRequestNotCancelled(toolName, signal);
+    if (!signal) {
+        return operation;
+    }
+    return await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new ValidationError(`Tool call cancelled: ${toolName}`, 'REQUEST_CANCELLED', { toolName }));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        operation.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+async function emitProgress(logger, extra, progressToken, progress, total, message) {
+    if (progressToken === undefined || !extra.sendNotification) {
+        return;
+    }
+    try {
+        await extra.sendNotification({
+            method: 'notifications/progress',
+            params: {
+                progressToken,
+                progress,
+                total,
+                message,
+            },
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        logger.debug(`[Server] Failed to emit progress notification: ${reason}`);
+    }
+}
+//# sourceMappingURL=server-tool-call-lifecycle.js.map

package/dist/core/server-tool-call-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tool-call-lifecycle.js","sourceRoot":"","sources":["../../src/core/server-tool-call-lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAiCxD,MAAM,UAAU,qBAAqB,CACnC,OAAiC;IAEjC,OAAO,KAAK,EAAE,OAAwB,EAAE,KAAkC,EAA2B,EAAE;QACrG,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC;QAC1D,MAAM,eAAe,GAA+B;YAClD,MAAM,EAAE,KAAK,EAAE,MAAM;YACrB,gBAAgB,EAAE,KAAK,EAAE,gBAAgB;SAC1C,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,yBAAyB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;YAE/F,IAAI,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,OAAO,CAAC,2BAA2B,EAAE,CAAC;YAC9C,CAAC;YAED,yBAAyB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;YAEjG,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,eAAe,CAAC,iBAAiB,IAAI,EAAE,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;gBAC3D,MAAM,IAAI,eAAe,CACvB,uCAAuC,IAAI,EAAE,EAC7C,oBAAoB,EACpB;oBACE,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,kBAAkB,CAAC,kBAAkB,KAAK,WAAW;oBACpE,kBAAkB,EAAE,kBAAkB,CAAC,kBAAkB;oBACzD,cAAc,EAAE,kBAAkB,CAAC,cAAc;iBAClD,CACF,CAAC;YACJ,CAAC;YAED,yBAAyB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;YAEpG,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAEzD,yBAAyB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;YAE9F,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CACxC,IAAI,EACJ,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,SAAS,CAAC,EAC3C,eAAe,CAAC,MAAM,CACvB,CAAC;YACF,MAAM,eAAe,GAAG,eAAe;gBACrC,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,eAAe,CAAC;gBAChD,CAAC,CAAC,MAAM,CAAC;YAEX,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC;YAEjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,IAAI,GAAG,EAAE;gBACjD,YAAY,EAAE,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;gBAClD,YAAY,EAAE,CAAC,eAAe,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBACtE,oBAAoB,EAAE,eAAe,CAAC,iBAAiB,KAAK,SAAS;gBACrE,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,KAAK;aAC1C,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,eAAe,CAAC,OAAO;gBAChC,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;gBACpD,OAAO,EAAE,eAAe,CAAC,OAAO;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,QAAQ,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,WAAW,GAAmB,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAEzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,IAAI,GAAG,EAAE,WAAW,CAAC,CAAC;YACjE,OAAO,WAAW,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,MAA2B,EAAE,MAAc;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IACpG,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgB,EAAE,MAAoB;IACvE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,wBAAwB,QAAQ,EAAE,EAClC,mBAAmB,EACnB,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,QAAgB,EAChB,SAAqB,EACrB,MAAoB;IAEpB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,IAAI,eAAe,CACxB,wBAAwB,QAAQ,EAAE,EAClC,mBAAmB,EACnB,EAAE,QAAQ,EAAE,CACb,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,SAAS,CAAC,IAAI,CACZ,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAc,EACd,KAAiC,EACjC,aAAwC,EACxC,QAAgB,EAChB,KAAa,EACb,OAAe;IAEf,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,gBAAgB,CAAC;YAC3B,MAAM,EAAE,wBAAwB;YAChC,MAAM,EAAE;gBACN,aAAa;gBACb,QAAQ;gBACR,KAAK;gBACL,OAAO;aACR;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,kDAAkD,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/core/server-tool-catalog.d.ts

@@ -0,0 +1,19 @@
+export type LogCapabilityState = 'available' | 'unavailable' | 'unknown';
+export type ToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: unknown;
+};
+export type ToolNameSets = {
+    alwaysAvailable: Set<string>;
+    logCapability: Set<string>;
+    ocapiCapability: Set<string>;
+};
+export declare const ALWAYS_AVAILABLE_TOOLS: ToolDefinition[];
+export declare const LOG_CAPABILITY_TOOLS: ToolDefinition[];
+export declare const OCAPI_CAPABILITY_TOOLS: ToolDefinition[];
+export declare const ALL_TOOL_DEFINITIONS: ToolDefinition[];
+export declare function createToolNameSets(): ToolNameSets;
+export declare function getAvailableTools(logCapabilityState: LogCapabilityState, canAccessOCAPI: boolean): ToolDefinition[];
+export declare function isToolAvailable(toolName: string, logCapabilityState: LogCapabilityState, canAccessOCAPI: boolean, toolNames: ToolNameSets): boolean;
+//# sourceMappingURL=server-tool-catalog.d.ts.map

package/dist/core/server-tool-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tool-catalog.d.ts","sourceRoot":"","sources":["../../src/core/server-tool-catalog.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAMlD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAIhD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAGlD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAIhD,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,YAAY,CAMjD;AAED,wBAAgB,iBAAiB,CAC/B,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,OAAO,GACtB,cAAc,EAAE,CAYlB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,YAAY,GACtB,OAAO,CAcT"}