add few new parameters for gpt-5

[narengogi]

No description provided.

[matter-code-review]

Summary By MatterAI

🔄 What Changed

Added new GPT-5 parameters across OpenAI provider configurations including prompt caching, safety identifiers, verbosity controls, and enhanced model response options. The changes introduce support for advanced GPT-5 features like background context, stream options, and user identification.

🔍 Impact of the Change

Enables GPT-5 feature compatibility by extending provider configurations with new parameter mappings. This allows the application to leverage advanced GPT-5 capabilities including prompt caching for performance optimization, safety controls, and enhanced streaming options.

📁 Total Files Changed

• src/providers/azure-openai/chatComplete.ts - Added 3 new parameter configurations (prompt_cache_key, safety_identifier, verbosity)
• src/providers/open-ai-base/createModelResponse.ts - Added 6 new parameter configurations (background, prompt, prompt_cache_key, stream_options, user, verbosity)
• src/providers/openai/chatComplete.ts - Added 3 new parameter configurations (prompt_cache_key, safety_identifier, verbosity)

🧪 Test Added

N/A - No test files were modified or added in this pull request

🔒 Security Vulnerabilities

N/A - No security vulnerabilities detected in the parameter configuration additions

Motivation

Support for GPT-5 advanced features requires extending the provider configuration to handle new parameters for prompt caching, safety controls, and enhanced response options.

Type of Change

• New feature (non-breaking change which adds functionality)
• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)

How Has This Been Tested?

• Unit Tests
• Integration Tests
• Manual Testing

Screenshots (if applicable)

N/A

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

Related Issues

N/A

Tip

Quality Recommendations

1. Add JSDoc documentation for the new parameters to explain their purpose and expected values

2. Consider adding validation for parameter values, especially for verbosity levels and safety identifiers

3. Add unit tests to verify the new parameter mappings work correctly

4. Consider adding type definitions for the new parameters to improve type safety

5. Add integration tests to ensure the new GPT-5 parameters are properly passed to the API

Tanka Poem ♫

New params flow in 🤖
GPT-5 features now unlock
Cache, safe, verbose 📝
Providers dance in harmony
AI grows stronger each day ✨

Sequence Diagram

sequenceDiagram
    participant Client
    participant OpenAIProvider
    participant AzureOpenAIProvider
    participant BaseProvider
    
    Client->>OpenAIProvider: chatComplete(prompt_cache_key, safety_identifier, verbosity)
    OpenAIProvider->>OpenAIProvider: Map parameters using OpenAIChatCompleteConfig
    
    Client->>AzureOpenAIProvider: chatComplete(prompt_cache_key, safety_identifier, verbosity)
    AzureOpenAIProvider->>AzureOpenAIProvider: Map parameters using AzureOpenAIChatCompleteConfig
    
    Client->>BaseProvider: createModelResponse(background, prompt, prompt_cache_key, stream_options, user, verbosity)
    BaseProvider->>BaseProvider: Map parameters using OpenAICreateModelResponseConfig
    BaseProvider->>BaseProvider: Validate required fields (input=true, others=false)
    
    BaseProvider-->>Client: Response with GPT-5 features enabled
    OpenAIProvider-->>Client: Chat completion with caching and safety
    AzureOpenAIProvider-->>Client: Azure chat completion with enhanced options

Loading

[matter-code-review]

Parameter additions look good overall. Consider adding documentation and validation for the new GPT-5 parameters.

[matter-code-review]

📝 Documentation Gap

Issue: New parameters lack JSDoc documentation explaining their purpose and expected values
Fix: Add JSDoc comments for each new parameter (background, prompt, prompt_cache_key, stream_options, user, verbosity)
Impact: Improves developer experience and API understanding

Suggested change

	background: {
	param: 'background',
	required: false,
	},
	background: {
	param: 'background',
	required: false,
	},

[matter-code-review]

🛠️ Code Refactor

Issue: Inconsistent parameter structure - missing 'required' field that exists in createModelResponse.ts
Fix: Add consistent structure with required field for maintainability
Impact: Ensures consistent parameter configuration across providers

Suggested change

	prompt_cache_key: {
	param: 'prompt_cache_key',
	},
	safety_identifier: {
	param: 'safety_identifier',
	},
	verbosity: {
	param: 'verbosity',
	},
	prompt_cache_key: {
	param: 'prompt_cache_key',
	required: false,
	},
	safety_identifier: {
	param: 'safety_identifier',
	required: false,
	},
	verbosity: {
	param: 'verbosity',
	required: false,
	},

[matter-code-review]

🛠️ Code Refactor

Issue: Inconsistent parameter structure - missing 'required' field that exists in createModelResponse.ts
Fix: Add consistent structure with required field for maintainability
Impact: Ensures consistent parameter configuration across providers

Suggested change

	prompt_cache_key: {
	param: 'prompt_cache_key',
	},
	safety_identifier: {
	param: 'safety_identifier',
	},
	verbosity: {
	param: 'verbosity',
	},
	prompt_cache_key: {
	param: 'prompt_cache_key',
	required: false,
	},
	safety_identifier: {
	param: 'safety_identifier',
	required: false,
	},
	verbosity: {
	param: 'verbosity',
	required: false,
	},