audanye-sudoandClaude Opus 4.6
7fda120d5a
Improve CLI error output and local logging to enable offline issue diagnosis: - Add ServerDiagnostics struct to extract and propagate trace_id, server_error_code, technical_detail, and server_retryable from MCP server responses - Extract diagnostics from JSON-RPC error.data, tool call result content, and HTTP response headers (X-Trace-Id, X-Request-Id, x-dingtalk-trace-id) - Redesign PrintHuman with three verbosity levels (Normal/Verbose/Debug): Normal shows trace ID + server code; Verbose adds technical detail; Debug adds internal diagnostics (RPC code, operation, reason) - Add PrintHumanAt for explicit verbosity control, PrintHuman defaults to Normal - Enhance local logging with request body (sanitized), response body (on error), retry attempts, and error classification events - Add TruncateBody, SanitizeArguments, RedactHeaders logging utilities with sensitive key detection via substring matching - Fix respRetryAfter called before nil guard in doWithRetry retry loop - Use GetBool instead of string comparison for flag resolution Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
60 lines
2.0 KiB
Go
60 lines
2.0 KiB
Go
// Copyright 2026 Alibaba Group
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package errors
|
|
|
|
import "strings"
|
|
|
|
// ServerDiagnostics holds server-side diagnostic fields extracted from
|
|
// MCP response bodies or HTTP response headers. Fields are populated
|
|
// on a best-effort basis during error construction.
|
|
type ServerDiagnostics struct {
|
|
TraceID string `json:"trace_id,omitempty"`
|
|
ServerErrorCode string `json:"server_error_code,omitempty"`
|
|
TechnicalDetail string `json:"technical_detail,omitempty"`
|
|
ServerRetryable *bool `json:"server_retryable,omitempty"`
|
|
}
|
|
|
|
// IsEmpty returns true when no diagnostic field has been populated.
|
|
func (d ServerDiagnostics) IsEmpty() bool {
|
|
return d.TraceID == "" && d.ServerErrorCode == "" &&
|
|
d.TechnicalDetail == "" && d.ServerRetryable == nil
|
|
}
|
|
|
|
// WithServerDiag attaches server diagnostics to the error.
|
|
func WithServerDiag(diag ServerDiagnostics) Option {
|
|
if diag.IsEmpty() {
|
|
return func(*Error) {}
|
|
}
|
|
return func(e *Error) {
|
|
e.ServerDiag = diag
|
|
// Override retryable if server explicitly specified.
|
|
if diag.ServerRetryable != nil {
|
|
e.Retryable = *diag.ServerRetryable
|
|
}
|
|
}
|
|
}
|
|
|
|
// WithTraceID records the server-provided trace identifier.
|
|
// Used when only the trace ID is available (e.g. from HTTP headers)
|
|
// without a full ServerDiagnostics struct.
|
|
func WithTraceID(id string) Option {
|
|
id = strings.TrimSpace(id)
|
|
if id == "" {
|
|
return func(*Error) {}
|
|
}
|
|
return func(e *Error) {
|
|
e.ServerDiag.TraceID = id
|
|
}
|
|
}
|