update-golden

name	update-golden
description	Updates golden test files from the Python SDK for cross-SDK compatibility verification.

Update Golden Tests Skill

Updates golden test files from the Python SDK.

Trigger

User says: "/update-golden" or "sync golden tests"

Process

1. Fetch latest golden files from: https://github.com/agentclientprotocol/python-sdk/tree/main/tests/golden

   Or if a local Python SDK exists: /Users/lvpeng/Code/exp/python-sdk/tests/golden/

2. Copy JSON files to Tests/ACPTests/Golden/

3. Verify Swift types can decode all golden files:

   • Create or update parsing tests
   • Report any decoding failures

4. Update tests if needed:

   • Add new test cases for new golden files
   • Update existing tests for changed schemas

Golden File Categories

Category	Files
Initialize	initialize_request.json, initialize_response.json
Session	new_session_*.json, session_update_*.json
Content	content_*.json
Permissions	request_permission_*.json, permission_outcome_*.json
Tool Content	tool_content_*.json
Filesystem	fs_*.json

Verification

After copying, run:

swift test --filter Golden

Or run all tests:

swift test

Notes

• Golden files represent canonical JSON examples
• Used for cross-SDK compatibility verification
• Should produce identical wire format across SDKs
• If a golden file fails to decode, investigate whether:
  1. The Swift type needs updating
  2. The golden file has an error
  3. There's a protocol version mismatch