Add error handling for OpenAI organization verification error

[RomneyDa]

Summary

This PR adds custom error handling for the OpenAI organization verification error that occurs when an organization hasn't been verified to use reasoning summaries.

Changes

• Added new fields to interface: and to support custom error handling
• Enhanced function: Detects OpenAI organization verification errors by checking for both "openai" and "organization must be verified to generate reasoning summaries" in the error message (case-insensitive)
• Updated StreamError component:
  • When is provided, shows a "Get help with this error" section instead of "Report this error"
  • Displays a "View help documentation" button linking to OpenAI's organization verification guide
  • Conditionally hides the GitHub issue button when is true
• Added comprehensive test coverage: Tests for the new error detection logic, including edge cases

Error Detection

The error is detected when the message contains both:

• "openai" (case-insensitive)
• "organization must be verified to generate reasoning summaries" (case-insensitive)

When detected, the error handler:

• Sets to https://help.openai.com/en/articles/10910291-api-organization-verification
• Sets to true to prevent users from opening GitHub issues for this known provider limitation

UI Changes

Instead of showing the "Open GitHub issue" button, users will see a "View help documentation" button that directs them to OpenAI's help article about organization verification.

Testing

Added unit tests covering:

• Detection of the organization verification error
• Case-insensitive matching
• Prevention of false positives for partial matches

---

Continue Tasks: ▶️ 2 queued — View all

---

Summary by cubic

Handles OpenAI organization verification errors for reasoning summaries, and routes users to the correct help docs instead of opening GitHub issues. Updates error analysis and the StreamError UI to make this clearer.

• Bug Fixes
  • Detects the error by matching "openai" and "organization must be verified to generate reasoning summaries" (case-insensitive).
  • Adds helpUrl and hideGithubIssue to ErrorAnalysis; StreamError shows a help link to OpenAI’s verification guide and hides the GitHub issue button for this case.
  • Adds tests for detection, case-insensitive matching, and avoiding partial-match false positives.

^{Written for commit c9f86e5. Summary will update on new commits.}

[github-actions]

⚠️ PR Title Format

Your PR title doesn't follow the conventional commit format, but this won't block your PR from being merged. We recommend using this format for better project organization.

Expected Format:

<type>[optional scope]: <description>

Examples:

• feat: add changelog generation support
• fix: resolve login redirect issue
• docs: update README with new instructions
• chore: update dependencies

Valid Types:

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

This helps with:

• 📝 Automatic changelog generation
• 🚀 Automated semantic versioning
• 📊 Better project history tracking

This is a non-blocking warning - your PR can still be merged without fixing this.

[github-actions]

✅ Review Complete

Code Review Summary

⚠️ Continue API authentication failed. Please check your CONTINUE_API_KEY.

---

[cubic-dev-ai]

1 issue found across 3 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="gui/src/util/errorAnalysis.test.ts">

<violation number="1" location="gui/src/util/errorAnalysis.test.ts:546">
P2: Test expects OpenAI verification handling even though the error message lacks "openai", which contradicts the detection logic requiring that substring and will fail.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: Test expects OpenAI verification handling even though the error message lacks "openai", which contradicts the detection logic requiring that substring and will fail.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At gui/src/util/errorAnalysis.test.ts, line 546:

<comment>Test expects OpenAI verification handling even though the error message lacks "openai", which contradicts the detection logic requiring that substring and will fail.</comment>

<file context>
@@ -530,6 +540,47 @@ describe("errorAnalysis", () => {
+
+      it("should handle OpenAI organization verification error", () => {
+        const error = new Error(
+          'HTTP 400 Bad Request\n\n{"message":"Your organization must be verified to generate reasoning summaries. Please go to: https://platform.openai.com/settings/organization/general and click on Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.","type":"invalid_request_error","param":"reasoning.summary","code":"unsupported_value"}',
+        );
+        const selectedModel = {
</file context>

Suggested change

	'HTTP 400 Bad Request\n\n{"message":"Your organization must be verified to generate reasoning summaries. Please go to: https://platform.openai.com/settings/organization/general and click on Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.","type":"invalid_request_error","param":"reasoning.summary","code":"unsupported_value"}',
	'HTTP 400 Bad Request\n\n{"message":"OpenAI: Your organization must be verified to generate reasoning summaries. Please go to: https://platform.openai.com/settings/organization/general and click on Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.","type":"invalid_request_error","param":"reasoning.summary","code":"unsupported_value"}',