Preserve _meta fields in vMCP backend responses

[yrobla]

vMCP was discarding _meta fields from backend MCP server responses, violating the MCP specification requirement to preserve protocol-level metadata. This prevented clients from receiving progress tokens, trace IDs, and custom backend metadata.

Large PR Justification

This is an atomic PR with complete functionality and testing. Cannot be split.

Fixes #2640

[codecov]

Codecov Report

❌ Patch coverage is 86.70886% with 21 lines in your changes missing coverage. Please review.
✅ Project coverage is 64.93%. Comparing base (7592a31) to head (fd245a9).

Files with missing lines	Patch %	Lines
pkg/vmcp/client/client.go	80.95%	10 Missing and 2 partials ⚠️
pkg/vmcp/composer/workflow_engine.go	42.85%	3 Missing and 1 partial ⚠️
pkg/vmcp/server/adapter/handler_factory.go	93.33%	2 Missing and 1 partial ⚠️
pkg/vmcp/server/telemetry.go	33.33%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3354      +/-   ##
==========================================
+ Coverage   64.82%   64.93%   +0.11%     
==========================================
  Files         382      384       +2     
  Lines       37187    37295     +108     
==========================================
+ Hits        24107    24219     +112     
+ Misses      11192    11177      -15     
- Partials     1888     1899      +11     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This PR adds support for preserving _meta fields from backend MCP server responses in the vMCP architecture. Previously, protocol-level metadata (progress tokens, trace IDs, custom backend metadata) was being discarded when forwarding responses to clients.

Changes:

• Modified BackendClient interface to return wrapper types (ToolCallResult, ResourceReadResult, PromptGetResult) that include _meta fields
• Updated client implementation to extract and preserve _meta from backend responses
• Added conversion functions to map between vmcp and mcp Meta/Content types
• Updated all mocks and tests to work with new return types

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
pkg/vmcp/types.go	Added new wrapper types (Content, ToolCallResult, ResourceReadResult, PromptGetResult) with Meta fields
pkg/vmcp/server/telemetry.go	Updated telemetry wrapper method signatures to use new return types
pkg/vmcp/server/adapter/handler_factory.go	Added conversion functions and updated handlers to preserve _meta when forwarding to clients
pkg/vmcp/mocks/mock_backend_client.go	Updated mock implementations for new method signatures
pkg/vmcp/client/client.go	Modified CallTool, ReadResource, GetPrompt to extract and preserve _meta from backend responses
pkg/vmcp/client/meta_integration_test.go	New integration test validating _meta preservation end-to-end
pkg/vmcp/composer/workflow_engine.go	Updated to extract output from new ToolCallResult wrapper type
pkg/vmcp/server/integration_test.go	Updated mocks to return new wrapper types
pkg/vmcp/server/adapter/handler_factory_test.go	Updated all test expectations to use new wrapper types
pkg/vmcp/composer/*_test.go	Updated multiple test files to use new ToolCallResult wrapper

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Large PR Detected

This PR exceeds 1000 lines of changes and requires justification before it can be reviewed.

How to unblock this PR:

Add a section to your PR description with the following format:

## Large PR Justification

[Explain why this PR must be large, such as:]
- Generated code that cannot be split
- Large refactoring that must be atomic
- Multiple related changes that would break if separated
- Migration or data transformation

Alternative:

Consider splitting this PR into smaller, focused changes (< 1000 lines each) for easier review and reduced risk.

See our Contributing Guidelines for more details.

---

This review will be automatically dismissed once you add the justification section.

[Copilot]

Pull request overview

Copilot reviewed 18 out of 18 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Large PR justification has been provided. Thank you!

[github-actions]

✅ Large PR justification has been provided. The size review has been dismissed and this PR can now proceed with normal review.

[yrobla]

thanks for your comments, i will address them. We also discussed the possibility of adding metadata to yardstick test server, so we can properly validate it

[Copilot]

Pull request overview

Copilot reviewed 22 out of 22 changed files in this pull request and generated 9 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.