ClaudeToolingConfiguration class

Configuration for Claude tooling extension package. Inherits all tooling and runtime settings.

Why This Class Exists

Although this class currently adds no new settings beyond what ToolingConfiguration provides, it exists for several important reasons:

  1. Type Safety: Allows Claude-specific services to declare their dependency on IConfigurationProvider<ClaudeToolingConfiguration>, making the configuration contract explicit and enabling compile-time checking.

  2. Extension Point: Provides a clear place to add Claude-specific settings (e.g., Claude API timeouts, model preferences, retry policies) without breaking existing code when those needs arise.

  3. Consistent Pattern: Maintains symmetry with other extension packages (LangChain, OpenAI), making the SDK easier to understand and navigate.

  4. Dependency Injection: Services can be designed to accept this specific configuration type, enabling proper IoC patterns and testability.

Example

// Service declares explicit dependency on Claude configuration
class ClaudeService {
  constructor(private configProvider: IConfigurationProvider<ClaudeToolingConfiguration>) {}
}

// Future: Add Claude-specific settings without breaking changes
class ClaudeToolingConfiguration extends ToolingConfiguration {
  get claudeApiTimeout(): number { ... }
}
Extends

Properties

clusterCategory
isDevelopmentEnvironment

Whether the cluster is a development environment (local or dev). Based on clusterCategory.

isNodeEnvDevelopment

Whether NODE_ENV indicates development mode. Returns true when NODE_ENV is 'development' (case-insensitive). This is the standard Node.js way of indicating development mode.

mcpPlatformAuthenticationScope

Gets the MCP platform authentication scope. Used by AgenticAuthenticationService for token exchange. Trims whitespace to prevent token exchange failures.

mcpPlatformEndpoint
useToolingManifest

Whether to use the ToolingManifest.json file instead of gateway discovery. Returns true when NODE_ENV is set to 'development' (case-insensitive), or when explicitly overridden via configuration.

Inherited Methods

parseEnvBoolean(undefined | string)

Parse an environment variable as a boolean. Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true; all other values as false.

parseEnvInt(undefined | string, number)

Parse an environment variable as an integer, returning fallback if invalid or not set.

Constructor Details

ClaudeToolingConfiguration(ToolingConfigurationOptions)

new ClaudeToolingConfiguration(overrides?: ToolingConfigurationOptions)

Parameters

Property Details

clusterCategory

ClusterCategory clusterCategory

Property Value

isDevelopmentEnvironment

Whether the cluster is a development environment (local or dev). Based on clusterCategory.

boolean isDevelopmentEnvironment

Property Value

boolean

isNodeEnvDevelopment

Whether NODE_ENV indicates development mode. Returns true when NODE_ENV is 'development' (case-insensitive). This is the standard Node.js way of indicating development mode.

boolean isNodeEnvDevelopment

Property Value

boolean

mcpPlatformAuthenticationScope

Gets the MCP platform authentication scope. Used by AgenticAuthenticationService for token exchange. Trims whitespace to prevent token exchange failures.

string mcpPlatformAuthenticationScope

Property Value

string

mcpPlatformEndpoint

string mcpPlatformEndpoint

Property Value

string

useToolingManifest

Whether to use the ToolingManifest.json file instead of gateway discovery. Returns true when NODE_ENV is set to 'development' (case-insensitive), or when explicitly overridden via configuration.

boolean useToolingManifest

Property Value

boolean

Inherited Method Details

parseEnvBoolean(undefined | string)

Parse an environment variable as a boolean. Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true; all other values as false.

static function parseEnvBoolean(envValue: undefined | string): boolean

Parameters

envValue

undefined | string

Returns

boolean

Inherited From ToolingConfiguration.parseEnvBoolean

parseEnvInt(undefined | string, number)

Parse an environment variable as an integer, returning fallback if invalid or not set.

static function parseEnvInt(envValue: undefined | string, fallback: number): number

Parameters

envValue

undefined | string

fallback

number

Returns

number

Inherited From ToolingConfiguration.parseEnvInt